https://github.com/adinhodovic/blackbox-exporter-mixin

A mixin for the blackbox-exporter. A set of Grafana dashboards and Prometheus rules for the Blackbox-exporter..
https://github.com/adinhodovic/blackbox-exporter-mixin

blackbox-exporter dashboards grafana-dashboards jsonnet mixin prometheus

Last synced: 24 days ago
JSON representation

A mixin for the blackbox-exporter. A set of Grafana dashboards and Prometheus rules for the Blackbox-exporter..

• Host: GitHub
• URL: https://github.com/adinhodovic/blackbox-exporter-mixin
• Owner: adinhodovic
• License: mit
• Created: 2021-03-04T01:13:23.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2024-08-27T16:55:33.000Z (2 months ago)
• Last Synced: 2024-08-27T18:39:25.986Z (2 months ago)
• Topics: blackbox-exporter, dashboards, grafana-dashboards, jsonnet, mixin, prometheus
• Language: Jsonnet
• Homepage:
• Size: 147 KB
• Stars: 20
• Watchers: 3
• Forks: 6
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# 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

![image](https://user-images.githubusercontent.com/12065867/110215613-0c8ce600-7eab-11eb-9fd3-dc5b62807176.png)

## How to use

This mixin is designed to be vendored into the repo with your infrastructure config.

To do this, use [jsonnet-bundler](https://github.com/jsonnet-bundler/jsonnet-bundler):

You then have three options for deploying your dashboards

1. Generate the config files and deploy them yourself

2. Use jsonnet to deploy this mixin along with Prometheus and Grafana

3. 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:

```sh

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

brew install jsonnet

```

Then, grab the mixin and its dependencies:

```sh

git clone https://github.com/adinhodovic/blackbox-exporter-mixin

cd blackbox-exporter-mixin

jb install

```

Finally, build the mixin:

```sh

make prometheus_alerts.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](https://github.com/monitoring-mixins/docs#guidelines-for-alert-names-labels-and-annotations) for alerts.