From 0084346265199b92a2e34d666a8a80e1ed416632 Mon Sep 17 00:00:00 2001 From: Tehlo <51698749+TehloWasTaken@users.noreply.github.com> Date: Tue, 25 Aug 2020 10:13:57 +0200 Subject: [PATCH] Update README.md --- README.md | 43 ++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 40 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index f8f4151..94be911 100644 --- a/README.md +++ b/README.md @@ -29,8 +29,45 @@ Below I've posted all the information and links to what I've used to set this up * Varken (this is what ties Plex together with Tautulli, Ombi, Radarr / Sonarr ## Datasources used -* InfluxDB -* Telegraf -* Prometheus +* [InfluxDB](https://www.influxdata.com/) +* [Telegraf](https://github.com/influxdata/telegraf) +* [Prometheus](https://prometheus.io/) (I learned all three along the way, and they all have their benefits for me. Some external tools only support one, so mixing them up was the best way to go about it) + +# How does it work +To make all of this happen I made use of a ton of other tools and example dashboards from other HomeLabbers or similar dashboards online. The best way in my opinion to learn about this stuff is to just see it happen elsewhere which will spark the idea for yourself to work on it. For me it was just trying to see what data I could collect (you *will* become a data whore) from my simple home server that I installed with Debian. I was always hard into domotica and other smart home stuff, so I thought I'd give this a try. + +Then, how did I make this happen: +I will go by the categories on my Dashboard to explain it as best as possible, as I've properly labeled each one. + +## Server Statistics (SERVER-01) +This is my home server. Using Prometheus and [Node Exporter](https://github.com/prometheus/node_exporter) I was able to collect simple data like CPU usage, RAM usage, how much disk space I used etc. This one especially is easy to use for beginners, as Prometheus after setting it up has a web GUI that you can view your metrics in. You can just click away on these metrics and data will appear that has been collected. + +The World Ping Times map is made by first using the [worldPing](https://grafana.com/grafana/plugins/raintank-worldping-app) plugin from Grafana. This will visualize the ping data that I input. You can use Telegraf for this, as it has a built-in ping feature. + +After installing Telegraf, in it's configuration file you'll see the following (it's a big config file, so you'll scroll for a while) + +`# # Ping given url(s) and return statistics` + + `[[inputs.ping]]` + + Below this, you can input IP addresses or hostnames of place you would like to ping. Below, you can set a timer on how often you want to ping, I've set this pretty slow as I'm using public IP addresses from all over the world and I'd hate to get blocked by them :p + +## Network Statistics & Unifi +The data in these 6 blocks is used from my Unifi gear at home. I have a Unifi USG directly connected to my ISP (they support it, yay) after which I have a POE Switch and two access points. I only use Unifi gear which makes it easier for me to collect all the data, but you can easily do this with just a few devices aswell. Most of the data comes from the USG anyway as this is my gateway to the internet. + +To get the data out of your Unifi Controller I used [Unifi-Poller](https://github.com/unifi-poller/unifi-poller). +I was **surprised** at how easy this was to setup. You install it, create a read-only user on your Unifi Controller and it will start scraping data right away! Back when I set this up I didn't know about Influx yet, so I set this up with Prometheus (it supports both). This however did allow me to see my metrics before hand in Prometheus' GUI, which made it easier to find the right metrics for the stuff I wanted to use. + +With the following metrics you can get your data of the last 24 Hours: + +**Upload:** +``increase(unifipoller_device_wan_transmit_bytes_total[24h])`` + +**Download:** +``increase(unifipoller_device_wan_receive_bytes_total[24h])`` + +The metrics for the All Time data are exactly the same, I just removed the `increase` and `24h` parts to make it collect the all time data. + +I know I can get a LOT more data from Unifi-Poller, but on my Home Dashboard this is all I needed for now. Unifi-Poller is insanely big, and it exports so much data that I didn't even know what to do with it all. They do however have demo dashboards you can use, which will nicely show you all the possible data you can get. You can find these [here](https://grafana.com/grafana/dashboards?search=unifi-poller)