Prometheus Monitoring Mixin for Blackbox-exporter

A set of Grafana dashboards and Prometheus alerts for Blackbox-exporter.

This is a work in progress.

Preview

Grafana dashboard

How to use

This mixin is designed to be vendored into the repo with your infrastructure config. To do this, use jsonnet-bundler:

You then have three options for deploying your dashboards

Generate the config files and deploy them yourself
Use jsonnet to deploy this mixin along with Prometheus and Grafana
Use prometheus-operator to deploy this mixin

Generate config files

You can manually generate the alerts, dashboards and rules files, but first you must install some tools:

go get github.com/jsonnet-bundler/jsonnet-bundler/cmd/jb
brew install jsonnet

Then, grab the mixin and its dependencies:

git clone https://github.com/example/blackbox-exporter-mixin
cd example/blackbox-exporter-mixin
jb install

Finally, build the mixin:

make prometheus-alerts.yaml
make prometheus-rules.yaml
make dashboards_out

The prometheus_alerts.yaml and prometheus_rules.yaml file then need to passed to your Prometheus server, and the files in dashboards_out need to be imported into you Grafana server. The exact details will depending on how you deploy your monitoring stack to Kubernetes.

Alerts

The mixin follows the monitoring-mixins guidelines for alerts.

v-zhuravlev / blackbox-exporter-mixin