network-monitor/README.md

64 lines
3.9 KiB
Markdown
Raw Normal View History

2021-07-05 13:52:48 +00:00
# Internet Monitoring Docker Stack with Prometheus + Grafana
2017-08-02 14:43:16 +00:00
2021-07-05 13:52:48 +00:00
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.
2017-02-21 12:37:35 +00:00
2021-07-05 13:52:48 +00:00
## Pre-requisites
2018-10-01 22:50:29 +00:00
2021-07-05 13:52:48 +00:00
Make sure Docker and [Docker Compose](https://docs.docker.com/compose/install/) are installed on your Docker host machine.
2018-10-01 22:50:29 +00:00
2017-02-21 14:57:40 +00:00
## Configuration
2017-02-21 15:02:06 +00:00
2021-07-05 13:52:48 +00:00
To change what hosts you ping you change the `targets` section in [/prometheus/pinghosts.yaml](./prometheus/pinghosts.yaml) file.
2017-02-21 14:57:40 +00:00
2021-07-05 13:52:48 +00:00
For speedtest the only relevant configuration is how often you want the check to happen. It is at 30 minutes by default which might be too much if you have limit on downloads. This is changed by editing `scrape_interval` under `speedtest` in [/prometheus/prometheus.yml](./prometheus/prometheus.yml).
2017-02-21 14:57:40 +00:00
2021-07-05 15:46:56 +00:00
## Start the monitoring containers
2017-02-21 12:37:35 +00:00
2021-07-05 15:46:56 +00:00
Use `docker-compose` which handles starting all of the needed containers and specifies how they communicate.
2017-02-21 12:37:35 +00:00
2021-07-05 15:46:56 +00:00
```
docker-compose up -d
```
2017-02-21 12:37:35 +00:00
2021-07-05 15:46:56 +00:00
It will take a while until grafana loads, so be patient.
2021-07-06 23:06:23 +00:00
The Grafana Dashboard will now be accessible via: `http://<Host IP Address>:3000` for example <http://localhost:3000>
2017-02-21 12:37:35 +00:00
username - admin
2021-07-05 15:46:56 +00:00
password - admin (Password is stored in the `config.monitoring` env file)
2017-02-21 12:37:35 +00:00
2021-07-05 13:52:48 +00:00
The DataSource and Dashboard for Grafana are automatically provisioned.
2021-07-06 23:06:23 +00:00
If all works it should be available at <http://localhost:3000/d/o9mIe_Aik/internet-connection> - if no data shows up try change the timeduration to something smaller.
2017-02-21 12:37:35 +00:00
2021-07-06 20:12:27 +00:00
![image](https://user-images.githubusercontent.com/20902250/124660583-ecd7ef80-de95-11eb-89f4-cf4b87644f8b.png)
## Interesting urls
2021-07-05 15:46:56 +00:00
- <http://localhost:9090/targets> shows status of monitored targets as seen from prometheus - in this case which hosts being pinged and speedtest. note: speedtest will take a while before it shows as UP as it takes about 30s to respond.
- <http://localhost:9090/graph?g0.expr=probe_http_status_code&g0.tab=1> shows prometheus value for `probe_http_status_code` for each host. You can edit/play with additional values. Useful to check everything is okay in prometheus (in case Grafana is not showing the data you expect).
- <http://localhost:9115> blackbox exporter endpoint. Lets you see what have failed/succeeded.
- <http://localhost:9798/metrics> speedtest exporter endpoint. Does take about 30 seconds to show its result as it runs an actual speedtest when requested.
2021-07-06 20:06:59 +00:00
## Editing the gauges
2021-07-06 20:04:49 +00:00
Everyone has a bit different internet speed requirements and different standards of what's considered as fast, for that reason, you can simply click on the name of any of the gauges, and click edit
2021-07-06 20:12:27 +00:00
<img src="https://user-images.githubusercontent.com/20902250/124659575-a59d2f00-de94-11eb-950e-b7dcb5a1d56a.png" width="400">
2021-07-06 20:04:49 +00:00
An edit menu will show where in the left pannel you can configure the minimum and maximum values shown on the gauge:
2021-07-06 20:12:27 +00:00
<img src="https://user-images.githubusercontent.com/20902250/124659786-dc734500-de94-11eb-9e02-e3f73e8b8c33.png" width="400">
2021-07-06 20:04:49 +00:00
You can also edit the color thresholds depending on the speeds to your liking (i.e. you can set after which point should the color become red/orange/...). Note that with the download/upload gauges you will need to enter the speed in bytes per second, not megabites!
2021-07-06 20:12:27 +00:00
<img src="https://user-images.githubusercontent.com/20902250/124659934-0fb5d400-de95-11eb-9cef-28c2c8033bf8.png" width="400">
2021-07-06 20:04:49 +00:00
2018-10-01 23:00:20 +00:00
## Thanks and a disclaimer
2021-07-05 15:46:56 +00:00
- Thanks to @maxandersen for making the original project this fork is based on.
- Thanks to @vegasbrianc work on making a [super easy docker](https://github.com/vegasbrianc/github-monitoring) stack for running prometheus and grafana.
- Thanks to @geerlingguy for perfecting the original project.
2021-07-05 13:52:48 +00:00
This setup is not secured in any way, so please only use on non-public networks, or find a way to secure it on your own.