Prometheus Monitoring Mixin for Ceph

A set of Prometheus alerts for Ceph.

The scope of this project is to provide Ceph specific Prometheus rule files using Prometheus Mixins.

Prerequisites

• Jsonnet [Install Jsonnet]

  Jsonnet is a data templating language for app and tool developers.

  The mixin project uses Jsonnet to provide reusable and configurable configs for Grafana Dashboards and Prometheus Alerts.

• Jsonnet-bundler [Install Jsonnet-bundler]

  Jsonnet-bundler is a package manager for jsonnet.

• Promtool

  1. Download Go (>=1.11) and install it on your system.
  2. Setup the GOPATH environment.
  3. Run $ go get -d github.com/prometheus/prometheus/cmd/promtool

How to use?

Manually generate configs and rules

You can clone this repository and manually generate Grafana Dashboard configs and Prometheus Rules files, and apply it according to your setup.

$ git clone https://github.com/ceph/ceph-mixins.git
$ cd ceph-mixins

To get dependencies

$ jb install

To generate Prometheus Alert file

$ make prometheus_alert_rules.yaml

To generate Prometheus Rule file

$ make prometheus_rules.yaml

The prometheus_alert_rules.yaml and prometheus_rules.yaml files then needs to be passed to your Prometheus Server.

Background

• Prometheus Monitoring Mixin design doc