internet-sla-monitoring/README.md

35 lines
1.9 KiB
Markdown

# Internet Service Level Agreement Monitoring Docker Stack with Prometheus, Grafana and a small python ports checker.
> To learn more about the python ports checker use, please visit this page: https://github.com/xeviff/pyOpenPortsChecker4Prometheus
Stand-up a Docker [Prometheus](http://prometheus.io/) stack containing Prometheus, Grafana with [blackbox-exporter](https://github.com/prometheus/blackbox_exporter), and [speedtest-exporter](https://github.com/MiguelNdeCarvalho/speedtest-exporter) to collect and graph home Internet reliability and throughput.
## This is a fork
Please, be aware this is an improvement from the following forked project, so I encourage you to get it as a first reference:
https://github.com/geerlingguy/internet-monitoring
## Configurations
That's easy, check the both projects configuration steps :wink:
Another important thing is the threshold for the internet speed. In my case I should have 1GB symmetrical and if one day I'll have this real speed, the colors would get the green color (but I don't expect this will happen with fibracat.cat :triumph:). Anyway if you had 600 Mbps for example, you'd need to adjust the Grafana's dashboard thresholds to have the green color when the values reaches 600 instead of 1000.
But it's pretty easy, you (as grafana's administrator) edit the panels and change these values:
![image](https://user-images.githubusercontent.com/73612508/176744529-b2fd6d5a-c14e-4924-99b6-80959b964947.png)
## Expected result
This is how it looks like in my NAS:
<center><img src="images/dashboard.png" width="4600" heighth="500"></center>
Please, don't attack my open ports :sweat_smile:
The interesting thing is you can adjust the time visibility and get its average, for example the last 24h or even last week stats, etc.
## Troubleshooting
If any error don't hesitate to open an Issue and I'll check if I mess up during the merge :trollface: