prometheus/blackbox_exporter — explained in plain English
Analysis updated 2026-06-26
Monitor whether your public website returns the correct HTTP status code and alert when it goes down.
Check that a database port is accepting TCP connections from outside the server as part of your uptime monitoring stack.
Verify that your DNS server returns valid results for a domain and alert if resolution fails.
Measure how long a full HTTP request takes to a service endpoint and trigger an alert when response time crosses a threshold.
| prometheus/blackbox_exporter | tencentblueking/bk-cmdb | mjl-/mox | |
|---|---|---|---|
| Stars | 5,682 | 5,681 | 5,684 |
| Language | Go | Go | Go |
| Setup difficulty | moderate | hard | hard |
| Complexity | 3/5 | 4/5 | 4/5 |
| Audience | ops devops | ops devops | ops devops |
Figures from each repo's GitHub metadata at analysis time.
Requires a running Prometheus server to collect results, available as a prebuilt binary or Docker image with minimal YAML config.
The Blackbox Exporter is a monitoring tool that checks whether external services are reachable and working. It is part of the Prometheus monitoring ecosystem, which collects and stores measurements about systems so teams can track their health over time. The name "blackbox" describes the approach: the tool treats a target service as a black box and probes it from the outside, the same way a user or another service would. It does not require any access to the internals of what it is checking. You point it at a URL, server, or hostname and it performs a test, then reports whether the test passed and how long it took. The tool supports several types of probes. HTTP and HTTPS probes check that a web address responds with the expected status code. TCP probes verify that a port on a server is accepting connections. DNS probes query a name server and check that it returns valid results. ICMP probes send ping-style packets to test basic connectivity. gRPC probes check services using that communication protocol. Results are exposed in a format that Prometheus can collect and store. Each probe produces a set of measurements including whether the probe succeeded, how long the connection took to establish, how long the full request took, and other timing details. These measurements can then be used to set up alerts, for example to notify an on-call engineer when a website stops responding or when response times cross a threshold. The exporter is typically deployed alongside a Prometheus server, which is configured to call the exporter at regular intervals with the targets to probe. Configuration is done through a YAML file that defines named probe modules with their settings. The exporter is written in Go, available as a prebuilt binary and as a Docker image, and is an official project under the Prometheus organization.
The Blackbox Exporter checks whether websites, servers, and network services are reachable from the outside by probing them with HTTP, TCP, DNS, ICMP, and gRPC tests, and reports the results to Prometheus for alerting.
Mainly Go. The stack also includes Go, YAML, Docker.
Use freely for any purpose, including commercial, as long as you keep the copyright and license notices.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly ops devops.
This repo across BitVibe Labs
Verify against the repo before relying on details.