Skip to content

Latest commit

 

History

History
40 lines (30 loc) · 1.07 KB

README.md

File metadata and controls

40 lines (30 loc) · 1.07 KB

Blackbox Prober

aka pingprom

Export blackbox telemetry like availability, request latencies and request size for remote services.

Supported URLs

http/https

The exporter requests the given url and reads from it until EOF.

tcp

The exporter connects to the given host:port. If any path is given, it will try to read until EOF which is required for exposing the size.

icmp

Execute ping. Port and path are ignored.

Available metrics

  • blackbox_up{url} 1 if url is reachable, 0 if not
  • blackbox_latency_seconds{url} Latency of request for url
  • blackbox_size_bytes{url} Size of request for url
  • blackbox_cert_expire_timestamp{url} Expiry date of certificate (HTTPS only)

Example

./blackbox_prober \
  -u http://5pi.de \
  -u https://5pi.de \
  -u icmp://192.168.178.1 \
  -u tcp://freigeist.org:655

Using Docker

docker pull fish/blackbox-prober

docker run -d -p 9110:9110 fish/blackbox-prober \
    -u http://5pi.de \
    -u https://5pi.de \
    -u icmp://192.168.178.1 \
    -u tcp://freigeist.org:655