---
id: "graphite"
type: "component"
kind: "timeseries-database"
provider: "default"
category: "data"
docs: "https://graphite.readthedocs.io/en/latest/config-carbon.html"
url: "https://localhost:3000/catalogue/components/graphite"
---

# Graphite

Metrics stack of carbon ingestion and the fixed-size Whisper database.

| | |
|---|---|
| Provider | [default](https://localhost:3000/catalogue?provider=default) |
| Kind | [Time-series database](https://localhost:3000/catalogue/kinds/timeseries-database) |
| Category | Data |
| Official docs | [https://graphite.readthedocs.io/en/latest/config-carbon.html](https://graphite.readthedocs.io/en/latest/config-carbon.html) |

## Properties

| property | type | values | required | kind default | this component |
|---|---|---|---|---|---|
| `aggregationMethod` | enum | `average`, `sum`, `last`, `max`, `min` | no | "average" | inherited |
| `compression` | enum | `none`, `gorilla`, `other` | no | "other" | **"none"** |
| `downsampling` | boolean | — | no | false | **true** |
| `labelIndex` | boolean | — | no | true | **false** |
| `managed` | boolean | — | no | false | **false** |
| `retentionRawDays` | integer | — | no | — | inherited |
| `taggedSeries` | boolean | — | no | false | inherited |
| `tiers` | enum | `single`, `hot-cold`, `hot-warm-cold` | no | "single" | **"single"** |
| `xFilesFactor` | string | — | no | "0.5" | inherited |

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
- [Cortex](https://localhost:3000/catalogue/components/cortex.md) `cortex` — default
- [DolphinDB](https://localhost:3000/catalogue/components/dolphindb.md) `dolphindb` — 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: "graphite", component: "graphite" }
```

## Source (`component` YAML, verbatim)

```yaml
# yaml-language-server: $schema=../../schema/component.schema.json
# Graphite: carbon plus the fixed-size Whisper database. Per "Configuring Carbon" a metric
# that matches no schema falls back to two hours of minutely data, and per "The Whisper
# Database" older points roll up into lower-precision archives, averaged by default.
schemaVersion: "1"
type: "component"
id: "graphite"
kind: "timeseries-database"
provider: "default"
docs: "https://graphite.readthedocs.io/en/latest/config-carbon.html"
defaults:
  downsampling: true
  tiers: "single"
  labelIndex: false
  compression: "none"
  managed: false
properties:
  aggregationMethod:
    type: "enum"
    values: ["average", "sum", "last", "max", "min"]
    default: "average"
  xFilesFactor:
    type: "string"
    default: "0.5"
  taggedSeries:
    type: "boolean"
    default: false
```

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