smokeping_prober

README

smokeping_prober

Prometheus style "smokeping" prober.

Overview

This prober sends a series of ICMP (or UDP) pings to a target and records the responses in Prometheus histogram metrics.

usage: smokeping_prober [<flags>] <hosts>...

Flags:
  -h, --help              Show context-sensitive help (also try --help-long and --help-man).
      --web.listen-address=":9374"
                          Address on which to expose metrics and web interface.
      --web.telemetry-path="/metrics"  
                          Path under which to expose metrics.
  -i, --ping.interval=1s  Ping interval duration
      --privileged        Run in privileged ICMP mode
      --log.level="info"  Only log messages with the given severity or above. Valid levels: [debug, info, warn,
                          error, fatal]
      --log.format="logger:stderr"  
                          Set the log target and format. Example: "logger:syslog?appname=bob&local=7" or
                          "logger:stdout?json=true"
      --version           Show application version.

Args:
  <hosts>  List of hosts to ping

Building and running

Requires Go >= 1.11

go get github.com/superq/smokeping_prober
sudo setcap cap_net_raw=+ep ${GOPATH}/bin/smokeping_prober

Metrics

Metric Name	Type	Description
smokeping_requests_total	Counter	Counter of pings sent.
smokeping_response_duration_seconds	Histogram	Ping response duration.