mydocker/pingexporter
blasebast 9b069a15c4 docs: improve all README files, add uptime-kuma 2026-04-12 20:11:50 +02:00
..
config .gitignore, documentation, other improvements 2026-04-04 21:45:48 +02:00
README.md docs: improve all README files, add uptime-kuma 2026-04-12 20:11:50 +02:00

README.md

Ping Exporter - ICMP Network Monitor

Prometheus exporter measuring network availability and latency via ICMP ping. Tracks RTT, packet loss and jitter for configured hosts.

Access

Endpoint Details
Metrics http://localhost:9427/metrics (network_mode: host)
Public access None (no Traefik)

Configuration

Config file: ./pingexporter/config/config.yml

Target Hosts

Host Type
8.8.8.8 Google DNS (internet)
8.8.4.4 Google DNS 2 (internet)
4.2.2.1 Level3 DNS (internet)
klfree.cz External host (internet)
192.168.1.1 MikroTik router (LAN)
192.168.1.132 Main host (acemagic)
192.168.1.219 Other LAN device

Ping Parameters

Parameter Value
Measurement interval Every 2s
Timeout 3s
History Last 60 measurements (2-minute window)
ICMP packet size 120 bytes
IPv6 Disabled

DNS

  • Resolver: 1.1.1.1 (Cloudflare)
  • Record refresh: every 2 min 15 s

Metrics

Metric Description
ping_rtt_seconds Round-trip time (min/mean/max/std)
ping_loss_ratio Packet loss (0.0 - 1.0)
ping_up Host reachable (1/0)

Useful for detecting: internet connection drops, link quality degradation, specific LAN segment issues.

Dependencies

Service Role
Prometheus Scrapes acemagic:9427 every 15s
VictoriaMetrics Long-term archive
Grafana ping-monitoring.json dashboard

Useful Commands

# Restart
docker compose restart ping-exporter

# Follow logs
docker compose logs -f ping-exporter

# Check metrics manually
curl http://localhost:9427/metrics | grep ping_

# Upgrade
./upgrade-container-by-name.sh ping-exporter