cloudalchemy.blackbox-exporter

DEPRECATED

This role is no longer maintained. Please use the prometheus-community/ansible collection instead.

Ansible Role: Blackbox Exporter

Description

This role helps you install and manage the blackbox exporter, which can check the availability of endpoints using HTTP, HTTPS, DNS, TCP, and ICMP.

Requirements

Ansible version 2.7 or higher (it might work with older versions, but that’s not guaranteed)
gnu-tar on Mac (install it using brew install gnu-tar)

Role Variables

You can change the following variables, which are listed in the defaults/main.yml file as well as in the table below.

Name	Default Value	Description
`blackbox_exporter_version`	0.18.0	Version of the blackbox exporter package
`blackbox_exporter_web_listen_address`	0.0.0.0:9115	Address where the blackbox exporter listens
`blackbox_exporter_cli_flags`	{}	Extra flags for starting the blackbox exporter
`blackbox_exporter_configuration_modules`	http_2xx: { prober: http, timeout: 5s, http: '' }

Example

Playbook

- hosts: all
  become: true
  roles:
    - cloudalchemy.blackbox-exporter

Demo site

We have a demo site that showcases a complete monitoring solution using Prometheus and Grafana. The repository with the code and links to live instances can be found here on GitHub. The site is hosted on DigitalOcean.

Local Testing

For testing this role locally, it’s best to use Docker along with molecule (version 3.x). You need to install Docker on your system first. Check "Get started" for a suitable Docker package for your system. Running your tests is easy—just execute molecule test.

Continuous Integration

By using molecule with CircleCI, we can test how new pull requests will work across different versions of Ansible and various operating systems. This process allows us to create different test scenarios for role configurations. We maintain a large test matrix, which may take longer than local testing, so please be patient.