cortexproject /cortex
A horizontally scalable, highly available, multi-tenant, long term Prometheus.
★ 5,878⑂ 887👁 97⑃ 5,697● 2,108▤ 96
+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
#1521the ring never removes old ingester even if the ingester pod is evicted47 comments · 2019-07-19#2987Uniform tenant/org/user naming21 comments · 2020-08-06#3642Support running cortex inside istio service mesh18 comments · 2021-01-04#2178query-frontend: Response caching should work for subqueries and part queries.18 comments · 2020-02-24#4322Downsampling17 comments · 2021-06-26#7733Noticed Cortex Query Timeout and Data Inconsistency Issues15 comments · 2026-07-27#4971make memberlist kvstore to default13 comments · 2022-11-16#1478Don't log "repeated timestamp but different value" message as error/warning13 comments · 2019-06-27
Discussions
#7444Can we define alerts and recording rules in the fallback config?1 comments · 2026-04-21#7368Cortex-tenant equivalent for OTLP endpoint0 comments · 2026-03-23#7334Documentation: Capacity Planning - states nonexistant metric 'prometheus_tsdb_head_series'1 comments · 2026-03-04#7117Compactor stuck. not finishing compactor runs, but seems to making some progress.0 comments · 2025-11-18#7110High spikes of ingester inflight query requests1 comments · 2025-11-11#7102v1.20.00 comments · 2025-11-10#7037Requesting guidance - cardinality and metric structure for metrics for a large number of entities0 comments · 2025-09-25#6753deleting a tenant (compactor?)1 comments · 2025-05-21
Latest release
v1.21.1 v1.21.1 2026-06-051.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