Skip to content

afefelov/blackbox_prober

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

About

Export availability, request latencies and size for remote services

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Go 94.6%
  • Makefile 5.4%