README.md

Prometheus Monitoring Mixin for Gluster

A set of Grafana dashboards and Prometheus alerts for Gluster.

The scope of this project is to provide Gluster specific Grafana dashboard configs and 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/gluster/gluster-mixins.git
$ cd gluster-mixins

To get dependencies

$ jb install

To generate Prometheus Alert file

$ make prometheus_alerts.yaml

To generate Prometheus Rule file

$ make prometheus_rules.yaml

To generate Grafana Dashboard configs

$ make dashboards_out

The prometheus_alerts.yaml and prometheus_rules.yaml files then needs to be passed to your Prometheus Server, and the files in dashboards_out needs to be passed to your Grafana server.

Background

• Prometheus Monitoring Mixin design doc