This is documentation for the next version of Mimir. For the latest stable release, go to the latest version.

Grafana Mimir operator and user guideMonitoring Grafana MimirInstalling Grafana Mimir 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
    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
    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
    jb init
    
  2. Install Grafana Mimir mixin
    jb install github.com/grafana/mimir/operations/mimir-mixin@main
    
  3. Import and configure it
    (import 'github.com/grafana/mimir/operations/mimir-mixin/mixin.libsonnet') + {
      _config+:: {
        // Override the Grafana Mimir mixin config here.
      },
    }