Description:
apingcli 0.2.0
aping
A tool to ping multiple hosts at once and export results as Prometheus metrics.
Relies on https://github.com/romana/multi-ping/ (see https://stackoverflow.com/a/45746002).
Installation
pip install aping-cli
Usage
To run the tool, type:
aping "google-dns-1=8.8.8.8" "google-dns-2=8.8.4.4"
Sample output:
Prometheus metrics server available at http://127.0.0.1:8000
google-dns-1 (8.8.8.8): 100.78ms, google-dns-2 (8.8.4.4): 100.78ms
google-dns-1 (8.8.8.8): 123.73ms, google-dns-2 (8.8.4.4): 122.97ms
google-dns-1 (8.8.8.8): 111.99ms, google-dns-2 (8.8.4.4): 112.96ms
google-dns-1 (8.8.8.8): 112.76ms, google-dns-2 (8.8.4.4): 113.86ms
In Linux/MacOS environments, ICMP packets can only be sent by processes with root
privileges (this is a requirement of the multi-ping package, which aping uses).
In those cases, the recommended invocation command would be:
sudo -E "$(which aping)" "google-dns-1=8.8.8.8" "google-dns-2=8.8.4.4"
Contributing
Local development
How to set up a local environment:
python -m venv venv
source ./venv/bin/activate
python -m pip install -U pip
pip install -e . -r requirements-dev.txt
pre-commit install
Resources
Grafana:
Default username and password are both admin.
https://grafana.com/tutorials/grafana-fundamentals/
https://grafana.com/docs/grafana/latest/getting-started/build-first-dashboard/
https://grafana.com/docs/grafana/latest/setup-grafana/configure-docker/#run-grafana-container-with-persistent-storage-recommended
Prometheus:
https://prometheus.io/docs/concepts/metric_types/
https://prometheus.io/docs/practices/histograms/
https://github.com/prometheus/client_python
https://prometheus.io/docs/prometheus/latest/getting_started/
License
For personal and professional use. You cannot resell or redistribute these repositories in their original state.
Customer Reviews
There are no reviews.
