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.

Open source

Installing Grafana Mimir dashboards and alerts

Grafana Mimir is shipped with a comprehensive set of production-ready Grafana dashboards and alerts to monitor the state and health of a Mimir cluster.


  • Grafana Mimir dashboards and alerts require specific labels to be set by Prometheus or Grafana Agent when scraping your Mimir cluster metrics
  • Some dashboards require recording rules that you should install in your Prometheus

Install from package

Grafana Mimir provides ready to use Grafana dashboards in the .json format and Prometheus alerts in the .yaml format, that you can directly import into your Grafana installation and Prometheus config.

The packaged dashboards and alerts have been compiled from the sources using a default configuration and don’t allow you to customize the required metrics label names. If you need to customize the required metrics label names please choose one of the other installation options.

  1. Download dashboards, recording rules and alerts from Grafana Mimir repository
  2. Import dashboards in Grafana
  3. Install recording rules and alerts in your Prometheus

Install from sources

Grafana Mimir dashboards and alerts are built using Jsonnet language and you can compile them from sources. If you choose this option, you can change the configuration to match your deployment, like customizing the required label names.

  1. Checkout Mimir source code
    git clone
  2. Review the mixin configuration at operations/mimir-mixin/config.libsonnet, and apply your changes if necessary.
  3. Install dependencies:
    go install
    go install
  4. Compile the mixin
    make build-mixin
  5. Import the dashboards saved at operations/mimir-mixin-compiled/dashboards/ in Grafana
  6. Install the recording rules saved at operations/mimir-mixin-compiled/rules.yaml in your Prometheus
  7. Install the alerts saved at operations/mimir-mixin-compiled/alerts.yaml in your Prometheus

Alternatively, you can compile the mixin in a container. To do so, replace the previous two steps with the following command:

make BUILD_IN_CONTAINER=true build-mixin

Install dashboards from Jsonnet mixin

In case you’re already using Jsonnet to define your infrastructure as a code, you can vendor the Grafana Mimir mixin directly into your infrastructure repository and configure it overriding the _config fields. Given the exact setup really depends on a case-by-case basis, the following instructions are not meant to be prescriptive but just show the main steps required to vendor the mixin.

  1. Install Grafana Mimir mixin
    jb install
  2. Import and configure it
    (import '') + {
      _config+:: {
        // Override the Grafana Mimir mixin config here.