Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.

Documentation Grafana Mimir References Architecture Key-value store

Grafana Mimir key-value store

A key-value (KV) store is a database that stores data indexed by key. Grafana Mimir requires a key-value store for the following features:

• Hash ring
• (Optional) Distributor high-availability tracker

Supported key-value store backends

Grafana Mimir supports the following key-value (KV) store backends:

• Gossip-based memberlist protocol (default)
• Consul
• Etcd

Gossip-based memberlist protocol (default)

By default, Grafana Mimir instances use a Gossip-based protocol to join a memberlist cluster. The data is shared between the instances using peer-to-peer communication and no external dependency is required.

We recommend that you use memberlist to run Grafana Mimir.

To configure memberlist, refer to configuring hash rings.

Note: The Gossip-based memberlist protocol is not supported for the optional distributor high-availability tracker.

Consul

Grafana Mimir supports Consul as a backend KV store. If you want to use Consul, you must install it. The Grafana Mimir installation does not include Consul.

To configure Consul, refer to configuring hash rings.

Etcd

Grafana Mimir supports etcd as a backend KV store. If you want to use etcd, you must install it. The Grafana Mimir installation does not include etcd.

To configure etcd, refer to configuring hash rings.