aping-cli 0.2.0

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/