---
id: "cortex"
type: "component"
kind: "timeseries-database"
provider: "default"
category: "data"
docs: "https://cortexmetrics.io/docs/blocks-storage/"
url: "https://localhost:3000/catalogue/components/cortex"
---

# Cortex

Horizontally scalable, multi-tenant Prometheus backend with blocks storage.

| | |
|---|---|
| Provider | [default](https://localhost:3000/catalogue?provider=default) |
| Kind | [Time-series database](https://localhost:3000/catalogue/kinds/timeseries-database) |
| Category | Data |
| Official docs | [https://cortexmetrics.io/docs/blocks-storage/](https://cortexmetrics.io/docs/blocks-storage/) |

## Properties

| property | type | values | required | kind default | this component |
|---|---|---|---|---|---|
| `blockRangeHours` | integer | — | no | 2 | inherited |
| `compression` | enum | `none`, `gorilla`, `other` | no | "other" | **"gorilla"** |
| `downsampling` | boolean | — | no | false | **false** |
| `labelIndex` | boolean | — | no | true | **true** |
| `managed` | boolean | — | no | false | **false** |
| `multiTenant` | boolean | — | no | true | inherited |
| `replicationFactor` | integer | — | no | 3 | inherited |
| `retentionRawDays` | integer | — | no | — | inherited |
| `tiers` | enum | `single`, `hot-cold`, `hot-warm-cold` | no | "single" | **"hot-cold"** |

Bold values are the ones this component pins.

## Rules that apply · 0

No rule selects this kind or its category.

## Other products of the same kind · 23

- [Time Series Database](https://localhost:3000/catalogue/components/alibaba-tsdb.md) `alibaba-tsdb` — alibabacloud
- [Amazon FinSpace](https://localhost:3000/catalogue/components/aws-finspace.md) `aws-finspace` — aws
- [Amazon Timestream for InfluxDB](https://localhost:3000/catalogue/components/aws-timestream-influxdb.md) `aws-timestream-influxdb` — aws
- [Amazon Timestream for LiveAnalytics](https://localhost:3000/catalogue/components/aws-timestream-liveanalytics.md) `aws-timestream-liveanalytics` — aws
- [Azure Data Explorer](https://localhost:3000/catalogue/components/azure-data-explorer.md) `azure-data-explorer` — azure
- [Azure Monitor workspace](https://localhost:3000/catalogue/components/azure-monitor-workspace.md) `azure-monitor-workspace` — azure
- [Workers Analytics Engine](https://localhost:3000/catalogue/components/cloudflare-analytics-engine.md) `cloudflare-analytics-engine` — cloudflare
- [DolphinDB](https://localhost:3000/catalogue/components/dolphindb.md) `dolphindb` — default
- [Graphite](https://localhost:3000/catalogue/components/graphite.md) `graphite` — default
- [InfluxDB](https://localhost:3000/catalogue/components/influxdb.md) `influxdb` — default
- [Apache IoTDB](https://localhost:3000/catalogue/components/iotdb.md) `iotdb` — default
- [kdb+](https://localhost:3000/catalogue/components/kdb.md) `kdb` — default
- [M3DB](https://localhost:3000/catalogue/components/m3db.md) `m3db` — default
- [Grafana Mimir](https://localhost:3000/catalogue/components/mimir.md) `mimir` — default
- [openGemini](https://localhost:3000/catalogue/components/opengemini.md) `opengemini` — default
- [Prometheus TSDB](https://localhost:3000/catalogue/components/prometheus-tsdb.md) `prometheus-tsdb` — default
- [QuestDB](https://localhost:3000/catalogue/components/questdb.md) `questdb` — default
- [TDengine](https://localhost:3000/catalogue/components/tdengine.md) `tdengine` — default
- [Thanos](https://localhost:3000/catalogue/components/thanos.md) `thanos` — default
- [TimescaleDB](https://localhost:3000/catalogue/components/timescaledb.md) `timescaledb` — default
- [Generic time-series database](https://localhost:3000/catalogue/components/timeseries-database.md) `timeseries-database` — default
- [VictoriaMetrics](https://localhost:3000/catalogue/components/victoriametrics.md) `victoriametrics` — default
- [Google Cloud Managed Service for Prometheus](https://localhost:3000/catalogue/components/google-managed-prometheus.md) `google-managed-prometheus` — gcp

## Use it in a design

```yaml
nodes:
  - { id: "cortex", component: "cortex" }
```

## Source (`component` YAML, verbatim)

```yaml
# yaml-language-server: $schema=../../schema/component.schema.json
# Cortex: horizontally scalable, multi-tenant Prometheus backend. Per "Blocks Storage",
# each series is held by 3 ingesters, TSDB blocks cut every 2h are shipped to an object
# store, and no downsampling is performed.
schemaVersion: "1"
type: "component"
id: "cortex"
kind: "timeseries-database"
provider: "default"
docs: "https://cortexmetrics.io/docs/blocks-storage/"
defaults:
  downsampling: false
  tiers: "hot-cold"
  labelIndex: true
  compression: "gorilla"
  managed: false
properties:
  replicationFactor:
    type: "integer"
    default: 3
  blockRangeHours:
    type: "integer"
    default: 2
  multiTenant:
    type: "boolean"
    default: true
```

Human page: https://localhost:3000/catalogue/components/cortex
