cortexproject /cortex

A horizontally scalable, highly available, multi-tenant, long term Prometheus.

★ 5,878⑂ 887👁 97⑃ 5,697● 2,108▤ 96
GoApache-2.0Created 2016-09-09cortexmetrics.io/
Download: v1.21.1v1.21.1 ↓1.21.12026-06-05
+0
Daily
5,878
stars
887
forks
97
watchers
5,697
prs
2,108
issues
96
releases

README

Cortex

Cortex is a horizontally scalable, highly available, multi-tenant, long-term storage solution for Prometheus and OpenTelemetry Metrics.

 Features

- Horizontally scalable: Cortex can run across multiple machines in a cluster, exceeding the throughput and storage of a single machine.
- Highly available: When run in a cluster, Cortex can replicate data between machines.
- Multi-tenant: Cortex can isolate data and queries from multiple different independent Prometheus sources in a single cluster.
- Long-term storage: Cortex supports S3, GCS, Swift and Microsoft Azure for long-term storage of metric data.

 Documentation

- Getting Started
- Architecture Overview
- Configuration
- Guides
- Security
- Contributing

 Community and Support

If you have any questions about Cortex, you can:

- Ask a question on the Cortex Slack channel. To invite yourself to
  the CNCF Slack, visit http://slack.cncf.io/.
- File an issue.
- Email [email protected].

Your feedback is always welcome.

For security issues see https://github.com/cortexproject/cortex/security/policy

 Engage with Our Community

We invite you to participate in the Cortex Community Calls, an exciting opportunity to connect with fellow
developers and enthusiasts. These meetings are held every 4 weeks on Thursdays at 1700 UTC,
providing a platform for open discussion, collaboration, and knowledge sharing.

Our meeting notes are meticulously documented and can be
accessed here, offering a
comprehensive overview of the topics discussed and decisions made.

To ensure you never miss a meeting, we've made it easy for you to keep track:

- View the Cortex Community Call schedule in your
  browser here.
- Alternatively, download the .ics
  file here for
  use with any calendar application or service that supports the iCal format.

Join us in shaping the future of Cortex, and let's build something amazing together!

 Further reading

 Talks

- Apr 2026 KubeCon talk "Discover Cortex: High Scalability Metrics in 2026" (video, slides)
- Apr 2025 KubeCon talk "Cortex: Insights, Updates and Roadmap" (video, slides)
- Apr 2025 KubeCon talk "Taming 50 Billion Time Series: Operating Global-Scale Prometheus Deployments on Kubernetes" (video, slides)
- Nov 2024 KubeCon talk "Cortex Intro: Multi-Tenant Scalable Prometheus" (video, slides)
- Mar 2024 KubeCon talk "Cortex Intro: Multi-Tenant Scalable Prometheus" (video, slides)
- Apr 2023 KubeCon talk "How to Run a Rock Solid Multi-Tenant Prometheus" (video, slides)
- Oct 2022 KubeCon talk "Current State and the Future of Cortex" (video, slides)
- Oct 2021 KubeCon talk "Cortex: Intro and Production Tips" (video, slides)
- Sep 2020 KubeCon talk "Scaling Prometheus: How We Got Some Thanos Into Cortex" (video, slides)
- Jul 2020 PromCon talk "Sharing is Caring: Leveraging Open Source to Improve Cortex & Thanos" (video, slides)
- Nov 2019 KubeCon talks "[Cortex 101: Horizontally Scalable Long Term Storage for Prometheus][kubecon-cortex-101]" ([video][kube

Top issues

Discussions

Latest release

v1.21.1 v1.21.1 2026-06-05
1.21.1 2026-06-04

 [BUGFIX] gRPC: Fix panic when grpc_compression is set to snappy on ingester client or store-gateway client configurations. 7459
 [BUGFIX] Config: Mask Swift, etcd, Redis, and HTTP basic-auth credentials on the /config endpoint. 7473
 [BUGFIX] Memberlist: Drop incoming TCP transport packets when digest verification fails, preventing corrupted payloads from being forwarded. 7474
 [BUGFIX] Ingester: Reject PushStream requests where the per-message TenantID does not match the authenticated caller, and add HMAC-SHA256 stream authentication for PushStream via -distributor.si

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON