# prometheus/blackbox_exporter

Blackbox prober exporter

Repository: https://github.com/prometheus/blackbox_exporter
Canonical: https://ross.abutalabs.com/products/blackbox_exporter
Homepage: https://prometheus.io
Language: Go
License: Apache-2.0
License Family: permissive
Topics: blackbox-exporter, icmp, prometheus-exporter, prometheus
Last push: 2026-08-25T16:25:40+00:00

## Health v2 (maintenance only)
Score: 77/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 99, release rhythm 36, longevity 100
- inputs: {"age_days": 4015, "days_push": 8, "days_rel": 270, "gap_med": 140.5, "n_releases_24m": 3}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 5841, forks 1211 (observed 2026-08-28T04:09:31.544534+00:00)

## What it is
The Blackbox exporter is a Prometheus exporter that probes endpoints over HTTP, HTTPS, DNS, TCP, ICMP, and gRPC and exposes probe success and timing metrics. It is typically scraped by a Prometheus server to enable blackbox/synthetic monitoring and alerting on endpoint availability.

## Use cases
- monitor website uptime and availability from outside the service
- probe endpoints over http, https, dns, tcp, icmp or grpc and export metrics
- measure tls certificate expiry and http response times for external targets
- alert when a service stops responding or becomes slow
- run synthetic checks against dns records and tcp ports

## When to choose
- you already run Prometheus and need blackbox/synthetic endpoint checks
- you want a single prober supporting many protocols with configurable modules
- you need probe timing and success metrics exposed in Prometheus format

## When to avoid
- you need in-application instrumentation rather than external probing
- you want full synthetic browser or transaction monitoring
- you are not using a Prometheus-compatible metrics pipeline

## Facets
- artifact type: service
- maturity: active
- function: monitoring, alerting
- domain: monitoring, networking
- platform: windows, self-hosted, go
- tags: prometheus-exporter, blackbox-probing, icmp, http-probe, uptime-monitoring, synthetic-monitoring, devops, linux, macos, docker

## Member repositories
- prometheus/blackbox_exporter (main) score 77

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:31.544534+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:51:55.219930+00:00, confidence not recorded.
  - readme: https://github.com/prometheus/blackbox_exporter (fetched 2026-08-28T04:09:31.544534+00:00, sha 2618cab5e03e)
  - homepage: https://prometheus.io (fetched 2026-08-29T08:47:36.702534+00:00, sha 90ad2d078025)
  - site_page: https://prometheus.io/docs/prometheus/latest/querying/basics (fetched 2026-08-29T08:47:36.717422+00:00, sha cab4a7880e82)
  - site_page: https://prometheus.io/docs/introduction/overview (fetched 2026-08-29T08:47:36.711468+00:00, sha 7768d893cf39)
  - site_page: https://prometheus.io/docs/prometheus/latest/getting_started (fetched 2026-08-29T08:47:36.713810+00:00, sha 1e2a0ce5ca59)
  - site_page: https://prometheus.io/docs/concepts/data_model (fetched 2026-08-29T08:47:36.715734+00:00, sha a377e9a58b18)
  - site_page: https://prometheus.io/docs/alerting/latest/overview (fetched 2026-08-29T08:47:36.719474+00:00, sha a05282aeaa43)
  - site_page: https://prometheus.io/docs/prometheus/latest/configuration/configuration (fetched 2026-08-29T08:47:36.721235+00:00, sha eef957bb70ac)
  - site_page: https://prometheus.io/docs/instrumenting/clientlibs (fetched 2026-08-29T08:47:36.725828+00:00, sha e814512fea70)
  - site_page: https://prometheus.io/docs/instrumenting/exporters (fetched 2026-08-29T08:47:36.727371+00:00, sha 16800ed839dd)
- Data as of 2026-08-30T08:39:29.467469+00:00.