List of modules already activated in blackbox-exporter

A module allows you to define the set of tasks you want to do to check your service

You can see configuration of modules in envs-ng.

Important

A module can be seen as an extension of Blackbox-Exporter. To add a module, we have to define it and restart Blackbox-Exporter before it is available for your target. Adding a module should always be done with a member of the team that manages Blackbox-Exporter.

icmp_check

Allows to test the ping on a service.

smtp_check

Allows to test an smtp server by making a list of commands and checking the response.

Example :

- expect: "^220 ([^ ]+) ESMTP (.+)$"
- send: "EHLO ProberCheck\r"
- expect: "^250-STARTTLS"
- send: "STARTTLS\r"
- expect: "^220"
- starttls: true
- send: "EHLO ProberCheck\r"
- expect: "^250-AUTH"
- send: "QUIT\r"

http_2xx

Send an http get request on the service and verify that the return code is 200.

Tip

This module will also work with HTTPS web sites. But you may prefer the module http_2xx_ssl.

http_2xx_ssl

Send an http get request on the service and verify that the return code is 200.

The probe will fail if there is a problem at the SSL level.

Tip

This is prefered module for HTTPS web sites monitor.

ssh_banner

Check SSH service with the SSH banner.

tcp_connect

Use the tcp protocol to check specific port.

dns_udp

Use udp protocol and checks the A field.

Caution

This module tests a DNS server with a name to resolve. This modules DOES NOT test the resolution of a name.

dns_tcp

Use tcp protocol.

Caution

This module tests a DNS server with a name to resolve. This modules DOES NOT test the resolution of a name.

dns_soa

Checks the SOA field.

Caution

This module tests a DNS server with a name to resolve. This modules DOES NOT test the resolution of a name.

rancher_check

This module is reserved for checking connectivity to Rancher managed clusters. It should not be used for any other purpose (or it might perturb alerting).