From 23f76205ccaa3a8726b8b6765d8ed6e76bbee4c9 Mon Sep 17 00:00:00 2001 From: ItsDrike Date: Mon, 5 Jul 2021 17:46:56 +0200 Subject: [PATCH] Update README --- README.md | 47 +++++++++++++++++------------------------------ 1 file changed, 17 insertions(+), 30 deletions(-) diff --git a/README.md b/README.md index e628b68..4e13be1 100644 --- a/README.md +++ b/README.md @@ -1,62 +1,49 @@ # Internet Monitoring Docker Stack with Prometheus + Grafana -> This repository is a fork from [maxandersen/internet-monitoring](https://github.com/maxandersen/internet-monitoring), tailored for use on a Raspberry Pi. It has only been tested on a Raspberry Pi 4 running Pi OS 64-bit beta. -> -> This has also recently been merged into the internet-pi repository, so there could be a few little things that need tweaking. - 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. ## Pre-requisites Make sure Docker and [Docker Compose](https://docs.docker.com/compose/install/) are installed on your Docker host machine. -## Quick Start - -``` -git clone https://github.com/geerlingguy/internet-monitoring -cd internet-monitoring -docker-compose up -d -``` - -Go to [http://localhost:3030/d/o9mIe_Aik/internet-connection](http://localhost:3030/d/o9mIe_Aik/internet-connection) (change `localhost` to your docker host ip/name). - ## Configuration To change what hosts you ping you change the `targets` section in [/prometheus/pinghosts.yaml](./prometheus/pinghosts.yaml) file. 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). -Once configurations are done, run the following command: +## Start the monitoring containers - $ docker-compose up -d +Use `docker-compose` which handles starting all of the needed containers and specifies how they communicate. -That's it. docker-compose builds the entire Grafana and Prometheus stack automagically. +``` +docker-compose up -d +``` -The Grafana Dashboard is now accessible via: `http://:3030` for example http://localhost:3030 +It will take a while until grafana loads, so be patient. + +The Grafana Dashboard will now be accessible via: `http://:3030` for example username - admin -password - wonka (Password is stored in the `config.monitoring` env file) +password - admin (Password is stored in the `config.monitoring` env file) The DataSource and Dashboard for Grafana are automatically provisioned. -If all works it should be available at http://localhost:3030/d/o9mIe_Aik/internet-connection - if no data shows up try change the timeduration to something smaller. +If all works it should be available at - if no data shows up try change the timeduration to something smaller.
## Interesting urls -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 okey in prometheus (in case Grafana is not showing the data you expect). - -http://localhost:9115 blackbox exporter endpoint. Lets you see what have failed/succeded. - -http://localhost:9798/metrics speedtest exporter endpoint. Does take about 30 seconds to show its result as it runs an actual speedtest when requested. +- 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. +- 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). +- blackbox exporter endpoint. Lets you see what have failed/succeeded. +- speedtest exporter endpoint. Does take about 30 seconds to show its result as it runs an actual speedtest when requested. ## Thanks and a disclaimer -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 @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. 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.