clambin/pinger
Measures the latency and packet loss to one of more hosts and reports the data to Prometheus.
50K+
clambin/pinger repository overview
pinger
Born on a rainy Sunday afternoon, when my ISP was being its unreliable self again. Measures the latency and packet loss to one of more hosts and reports the data to Prometheus.
Getting started
Command line arguments:
The following command line arguments can be passed:
usage: pinger [<flags>] [<hosts>...]
pinger
Flags:
-h, --help Show context-sensitive help (also try --help-long and --help-man).
-v, --version Show application version.
--port=8080 Metrics listener port
--endpoint="/metrics" Metrics listener endpoint
--debug Log debug messages
--interval=5s Measurement interval
Args:
[<hosts>] hosts to ping
The target hosts can also be provided by exporting an environment variable 'HOSTS', e.g.
export HOSTS="127.0.0.1 192.168.0.1 192.168.0.200"
If both are provided, the environment variable takes precedence.
Docker
Pinger can be installed in a Docker container via docker-compose:
version: '2'
services:
pinger:
image: clambin/pinger:latest
container_name: pinger
command: --interval 5s 192.168.0.1
ports:
- 8080:8080/tcp
restart: unless-stopped
Images for arm32 & amd64 are currently provided.
Metrics
Pinger exposes the following metrics to Prometheus:
* pinger_packet_count: Total packets sent
* pinger_packet_loss_count: Total packet loss measured
* pinger_latency_seconds: Total latency measured
Authors
- Christophe Lambin
License
This project is licensed under the MIT License - see the LICENSE.md file for details.
Tag summary
Content type
Image
Digest
Size
8.5 MB
Last updated
about 5 years ago
docker pull clambin/pinger:sha-8796220