prometheus/blackbox_exporter
Blackbox Exporter
The Blackbox Exporter is a Prometheus-compatible probe that checks the availability and response correctness of external services over HTTP, HTTPS, DNS, TCP, ICMP, and gRPC. It exposes probe results as Prometheus metrics, including a probe_success indicator for each endpoint checked, making it a dedicated tool for blackbox monitoring of network services.
The exporter uses a probe-module configuration system where reusable settings such as protocol, method, and IP version are defined as named YAML modules. These modules are assigned to target groups through Prometheus relabeling rules, which map static target addresses and module names into HTTP probe request parameters. Configuration changes can be applied at runtime without restarting, either by sending a SIGHUP signal or an HTTP POST to the reload endpoint.
The exporter supports probing multiple targets with different modules within a single scrape job, and its endpoints can be secured with TLS encryption and basic authentication. It provides a Prometheus-compatible metrics endpoint that serves probe results for collection by Prometheus or other compatible systems.
Features
- Probe Result Metric Exposers - Its core purpose is exposing probe results as Prometheus metrics, including the probe_success indicator.
- Reusable Probe Module Definitions - Defines reusable probe settings as named YAML modules for protocol, method, and IP version.
- Endpoint Reachability Probes - Queries remote endpoints over network protocols and returns metrics about reachability, latency, and response.
- Probe Configuration Reloaders - Ships a runtime reload mechanism for probe module definitions via SIGHUP or HTTP POST, enabling configuration changes without restarting.
- External Service Monitoring - Probes external endpoints over multiple protocols to check availability, latency, and response correctness for blackbox monitoring.
- Prometheus-Formatted HTTP Endpoints - Exposes probe results as Prometheus-formatted metrics via an HTTP endpoint for external scraping.
- Multi-Protocol Health Probes - Its primary function is probing services over multiple protocols to monitor availability and latency.
- Multi-Protocol Probing Engines - Probes endpoints over HTTP, HTTPS, DNS, TCP, ICMP, and gRPC to check availability and latency.
- Blackbox Exporters - The Blackbox Exporter for Prometheus, probing endpoints over multiple protocols to expose availability and latency metrics.
- Prometheus-Based Metric Exporters - Converts probe results into Prometheus metrics, acting as a Prometheus-based metric exporter.
- Network Probe Metric Exporters - Measures reachability and response correctness of remote services, exposing results as Prometheus metrics.
- Dynamic Scrape Target Discovery - Retrieves scrape targets automatically from cloud providers, container orchestrators, DNS, and service registries.
- HTTP Endpoint Reload Triggers - Applies configuration changes on the fly via SIGHUP signal or HTTP POST to a reload endpoint.
- Probe Module Assignments - Supports assigning different probe modules to target groups within a single scrape job for flexible monitoring.
- Prometheus Relabeling Rules - Uses Prometheus relabeling rules to map target addresses and modules into probe request parameters.
- HTTP Endpoint Reload Triggers - Applies configuration changes on the fly via SIGHUP signal or HTTP POST to a reload endpoint.
- Probe Request Parameter Mappings - Uses Prometheus relabeling rules to map target addresses and module names into probe request parameters.
- Probe Routing Relabeling - Routes probes by mapping static target addresses and modules into HTTP probe request parameters via relabeling.
Star history
How this analysis was created: This summary and feature list were written by an AI model that read the project's README and public documentation pages. Each feature links to the documentation it came from; stars, license and language come straight from the GitHub API. The model does not read the source code, and the analysis is refreshed when the project is re-analysed. Learn more on our About page.
