October 24, 2020

853 words 5 mins read

cortexproject/cortex

cortexproject/cortex

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

repo name cortexproject/cortex
repo link https://github.com/cortexproject/cortex
homepage https://cortexmetrics.io/
language Go
size (curr.) 94253 kB
stars (curr.) 3450
created 2016-09-09
license Apache License 2.0

Circle CI GoDoc TODOs

Cortex: horizontally scalable, highly available, multi-tenant, long term storage for Prometheus.

Cortex provides horizontally scalable, highly available, multi-tenant, long term storage for Prometheus.

  • Horizontally scalable: Cortex can run across multiple machines in a cluster, exceeding the throughput and storage of a single machine. This enables you to send the metrics from multiple Prometheus servers to a single Cortex cluster and run “globally aggregated” queries across all data in a single place.
  • Highly available: When run in a cluster, Cortex can replicate data between machines. This allows you to survive machine failure without gaps in your graphs.
  • Multi-tenant: Cortex can isolate data and queries from multiple different independent Prometheus sources in a single cluster, allowing untrusted parties to share the same cluster.
  • Long term storage: Cortex supports Amazon DynamoDB, Google Bigtable, Cassandra, S3, GCS and Microsoft Azure for long term storage of metric data. This allows you to durably store data for longer than the lifetime of any single machine, and use this data for long term capacity planning.

Cortex is a CNCF incubation project used in several production systems including Weave Cloud and Grafana Cloud. Cortex is primarily used as a remote write destination for Prometheus, with a Prometheus-compatible query API.

Documentation

Read the getting started guide if you’re new to the project. Before deploying Cortex with a permanent storage backend you should read:

  1. An overview of Cortex’s architecture
  2. A guide to running Cortex
  3. Information regarding configuring Cortex
  4. Steps to run Cortex with Cassandra

For a guide to contributing to Cortex, see the contributor guidelines.

Further reading

To learn more about Cortex, consult the following talks and articles.

Recent talks and articles

Previous talks and articles

Getting Help

If you have any questions about Cortex:

Your feedback is always welcome.

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

Community Meetings

The Cortex community call happens every three weeks on Thursday at 03:30pm – 04:15pm UTC to get calendar invite join the google groups.

Meeting notes are held here.

Hosted Cortex (Prometheus as a service)

There are several commercial services where you can use Cortex on-demand:

Weave Cloud

Weave Cloud from Weaveworks lets you deploy, manage, and monitor container-based applications. Sign up at https://cloud.weave.works and follow the instructions there. Additional help can also be found in the Weave Cloud documentation.

Instrumenting Your App: Best Practices

Grafana Cloud

To use Cortex as part of Grafana Cloud, sign up for Grafana Cloud by clicking “Log In” in the top right and then “Sign Up Now”. Cortex is included as part of the Starter and Basic Hosted Grafana plans.

comments powered by Disqus