A prometheus ICMP exporter specifically designed to be able to measure the latency across point to point links.

The icmp_exporter listens on HTTP port 10035 by default. See the --help output for more options. You must provide a configuration file using the --collector.config.file option to start the exporter.

To allow the exporter to create raw ICMP sockets, you must set the required capability on the exporter binary as below. Alternatively, you may run the exporter as root (NOT RECOMMENDED).

setcap cap_net_raw=+ep /path/to/icmp_exporter

You may then run the exporter using the command below.

./icmp_exporter --collector.config.file=/path/to/config/file.yml

Configuration of ping targets is done using a simple yaml file. No configuration option is required (although the exporter won't be very useful if you don't declare any targets).

targets:
  - host: 8.8.8.8
  - host: 192.168.150.150

default_ttl: 1
default_size: 56
default_count: 2
default_interval: 500
targets:
  - host: 8.8.8.8
    ttl: 64
    count: 5
    size: 24
    interval: 1000
  - host: 192.168.150.150
    interface: eth0

This repo uses the REUSE standard in order to communicate the correct licence for the file. For those unfamiliar with the standard the licence for each file can be found in one of three places. The licence will either be in a comment block at the top of the file, in a .license file with the same name as the file, or in the dep5 file located in the .reuse directory. If you are unsure of the licencing terms please contact contact@sidingsmedia.com. All files committed to this repo must contain valid licencing information or the pull request can not be accepted.