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 Operator and user guide Monitor Mimir Installing dashboards and alerts

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.

Requirements

• 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
   bash Copy

   git clone https://github.com/grafana/mimir.git

2. Review the mixin configuration at operations/mimir-mixin/config.libsonnet, and apply your changes if necessary.
3. Compile the mixin
   bash Copy

   make build-mixin

4. Import the dashboards saved at operations/mimir-mixin-compiled/dashboards/ in Grafana
5. Install the recording rules saved at operations/mimir-mixin-compiled/rules.yaml in your Prometheus
6. Install the alerts saved at operations/mimir-mixin-compiled/alerts.yaml in your Prometheus

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. Initialise Jsonnet
   bash Copy

   jb init

2. Install Grafana Mimir mixin
   bash Copy

   jb install github.com/grafana/mimir/operations/mimir-mixin@main

3. Import and configure it
   jsonnet Copy

   (import 'github.com/grafana/mimir/operations/mimir-mixin/mixin.libsonnet') + {
     _config+:: {
       // Override the Grafana Mimir mixin config here.
     },
   }