This is documentation for the next version of Grafana Mimir documentation. For the latest stable release, go to the latest version.
Configure ingest storage architecture
The ingest storage is the next generation architecture of Grafana Mimir. It decouples the Mimir read and write paths using Apache Kafka or a Kafka-compatible backend.
To enable ingest storage, set the following Jsonnet:
{
_config+:: {
ingest_storage_enabled: true,
}
}
Note
The ingest storage architecture requires a production-grade Apache Kafka cluster or Kafka-compatible backend.
Warning
The ingest storage architecture requires the ruler remote evaluation to be enabled for the Mimir cluster. Refer to the Configure the Grafana Mimir ruler with Jsonnet documentation for details about the ruler’s operational modes.
Kafka connection options
The Jsonnet configures some Kafka connection parameters by default:
- Kafka topic:
ingest
- Auto-created partitions: 1000 (when the topic doesn’t exist)
- Kafka addresses:
kafka.<namespace>.svc.<cluster_domain>:9092
To customize the Kafka connection configuration, override the default settings:
{
_config+:: {
ingest_storage_enabled: true,
},
// Override producer and consumer addresses for external Kafka
ingest_storage_kafka_producer_address:: 'kafka-broker-1:9092,kafka-broker-2:9092',
ingest_storage_kafka_consumer_address:: 'kafka-broker-1:9092,kafka-broker-2:9092',
// Override Kafka client configuration
ingest_storage_kafka_client_args+:: {
'ingest-storage.kafka.topic': 'mimir-ingest',
'ingest-storage.kafka.auto-create-topic-default-partitions': 500,
},
}
Kafka partition sizing
The configured topic must have at least as many partitions as the number of ingesters in one zone.
Refer to Configure the Grafana Mimir Kafka backend for more details about Kafka configurations.