Self-hosting. iPerf3 exporter

Экспортер Prometheus для показателей сетевой производительности iPerf3.
Позволяет в автоматическом режиме запускать замеры скорости сети с использованием iperf и передавать результаты в Prometheus

Репозиторий: https://github.com/edgard/iperf3_exporter

Пример docker compose файла:

services:
  iperf3_exporter:
    container_name: iperf3-exporter
    image: ghcr.io/edgard/iperf3_exporter:latest
    ports:
      - '9579:9579'

После запуска будет доступен веб интерфейс по указанному порту

Для выполнения ручного замера можно воспользоваться обычным запросом браузера используя адрес:
http://monitoring.local:9579/probe?target=example.com
где

• monitoring.local:9579 - адрес экспортера в локальной сети
• example.com - адрес проверяемого сервера

Настройка Prometheus:

  - job_name: 'iperf3'
    scrape_interval: 1h
    metrics_path: /probe
    static_configs:
      - targets:
        - iperf.server.com
    params:
      port: ['5201']
      # Optional: enable reverse mode
      # reverse_mode: ['true']
      # Optional: enable UDP mode
      #udp_mode: ['true']
      # Optional: set bitrate limit
      #bitrate: ['1G']
      # Optional: set test period
      period: ['5s']
    relabel_configs:
      - source_labels: [__address__]
        target_label: __param_target
      - source_labels: [__param_target]
        target_label: instance
      - target_label: __address__
        replacement: monitoring.local:9579  # The iPerf3 exporter's real hostname:port.

• В разделе targets указывается список серверов замеры к которым необходимо выполнять.
• Лучше использовать udp_mode позволяет использовать udp протокол для тестирования с возможностью задавать параметры тестирования а не устанавливать их автоматически.
• Параметр bitrate отвечает за предельную скорость с которой будет проводиться тест, это та максимальная скорость которую вы можете получить.
• period - время за которое будет проводиться тестирование
• monitoring.local - адрес iperf3-exporter по которому будет обращаться prometheus для выполнения замера.

Настройка сервера приемника

Необходимо установить iperf3

apt install iperf3
sudo systemctl daemon-reload
sudo systemctl enable iperf3
sudo systemctl start iperf3
sudo systemctl status iperf3

Если используется ufw необходимо открыть порты для теста (открывать только для белых ip с которых будет проходить тест):

sudo ufw allow from <ip> to any port 5201 proto udp
sudo ufw allow from <ip> to any port 5201 proto tcp

Запрос prometheus

Для получения данных можно использовать запрос:

((last_over_time(iperf3_received_bytes[2h]) / last_over_time(iperf3_received_seconds[2h])) * 8) 

(
    (last_over_time(iperf3_sent_bytes[2h]) / last_over_time(iperf3_sent_seconds[2h]))
    * 8
) 

Пример панели:
![[iperf monitoring-1765922599921.json]]