https://github.com/schweikert/fping-exporter

prometheus exporter to measure network latency
https://github.com/schweikert/fping-exporter

Last synced: 5 days ago
JSON representation

prometheus exporter to measure network latency

• Host: GitHub
• URL: https://github.com/schweikert/fping-exporter
• Owner: schweikert
• License: apache-2.0
• Created: 2019-06-30T06:05:01.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2024-04-27T05:56:02.000Z (7 months ago)
• Last Synced: 2024-08-02T15:48:19.556Z (3 months ago)
• Language: Go
• Size: 280 KB
• Stars: 107
• Watchers: 6
• Forks: 36
• Open Issues: 9
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# fping-exporter

fping-exporter allows you to run measure network latency using fping and

prometheus. Compared to blackbox-exporter, it gives you additionally latency

distribution and a packet loss statistics. Also, it is probably better

performing thanks to fping.

**WARNING: This is currently a work in progress, the code is not production-ready yet**

This graph shows the fping\_rtt summary as "SmokePing"-like graph in Grafana:

![screenshot](README_screenshot.png)

## Usage

1. Start fping-exporter as follows:

   ```

     fping-exporter [OPTIONS]

   

   Application Options:

     -l, --listen=[HOST]:PORT    Listen address (default: :9605)

     -p, --period=SECS           Period in seconds, should match Prometheus scrape interval (default: 60)

     -f, --fping=PATH            Fping binary path (default: /usr/bin/fping)

     -c, --count=N               Number of pings to send at each period (default: 20)

   

   Help Options:

     -h, --help                  Show this help message

   ```

2. Configure Prometheus to use this, as you would with blackbox-exporter. For example:

   ```

   global:

     scrape_interval: 60s

   

   scrape_configs:

     - job_name: test

       metrics_path: /probe

       static_configs:

       - targets:

         - "8.8.4.4"

         - "8.8.8.8"

       relabel_configs:

       - source_labels: [__address__]

         target_label: __param_target

       - source_labels: [__param_target]

         target_label: instance

       - target_label: __address__

         replacement: 127.0.0.1:9605  # The fping-exporter's real hostname:port.

   ```

## Metrics

fping-exporter produces the following metrics:

- `fping_sent_count`: Number of sent probes

- `fping_lost_count`: Number of lost probes

- `fping_rtt_count`: Number of measured latencies (successful probes)

- `fping_rtt_sum`: Sum of measured latencies

- `fping_rtt`: Summary of measured latencies