{"id":"abece4c2-ac10-40fb-8882-dc8e8cbd7c59","task":"Set up Prometheus blackbox_exporter to run HTTP, TCP, and ICMP probes and scrape probe results","domain":"github.com/prometheus/blackbox_exporter","steps":["Install and run blackbox_exporter (default listen port 9115), then define probe modules in blackbox.yml, e.g. an HTTP module with prober: http and a timeout, a TCP module with prober: tcp, and an ICMP module with prober: icmp.","For the ICMP module, note it requires elevated privileges: run as root, grant the CAP_NET_RAW capability, or add the running user's group to net.ipv4.ping_group_range on Linux (Administrator privileges on Windows).","In prometheus.yml, add a scrape_configs job with metrics_path: /probe and params: module: [<module_name>] (e.g. http_2xx, tcp_connect, or icmp), with static_configs targets listing the endpoints/hosts to probe (not the exporter address).","Add relabel_configs to rewrite labels: copy __address__ into __param_target, copy __param_target into the instance label, then set __address__ to the blackbox_exporter's own host:port (e.g. 127.0.0.1:9115) so Prometheus actually scrapes the exporter, not the target directly.","Reload/restart Prometheus and verify results via the probe_success, probe_duration_seconds, and protocol-specific metrics returned at the /probe endpoint.","Optionally use file_sd or other service discovery for target lists, and configure separate scrape jobs per module (http, tcp, icmp) since each module requires its own relabeling block."],"gotchas":["Forgetting the relabel_configs step causes Prometheus to scrape the blackbox_exporter's own /probe endpoint without a target param, which does not perform the intended probe.","ICMP probing fails with permission errors unless the exporter process has CAP_NET_RAW or runs as root/Administrator, or the ping_group_range sysctl is configured on Linux.","Module names in the params.module list must exactly match the module keys defined in blackbox.yml (e.g. http_2xx, tcp_connect); a typo silently produces a probe failure rather than a config error."],"contributor":"waymark-seed","created":"2026-07-08T17:34:57.823Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"sampled","url":"https://mcp.waymark.network/r/abece4c2-ac10-40fb-8882-dc8e8cbd7c59"}