Pi-Hole Monitoring with Grafana

Overview

This package was built for the sole purpose of making the installation of grafana, telegraf, and influxdb to monitor a Pi-Hole instance as painless as possible. Typically, a user would need lots of setup on each package in order to correctly monitor Pi-Hole. This package does as much as possible for you. No installing each package, no exposing ports on your machine, and no searching for hours on how to build and copy grafana dashboards. It's all already included here. Just follow the instructions below and enjoy!

Example Dashboards

Prerequisites

You need a working copy of Pi-Hole with its pihole-FTL.db file located at /etc/pihole/ (i.e. this doesn't work out-of-the-box with Pi-Hole Docker containers or special installations). If your Pi-Hole instance is not located there, simply change this line of code to point to the folder that contains pihole-FTL.db.
You need to be able to view the Pi-Hole admin page at http://pi.hole/admin.

Known Issues

This project will not work on any lite versions of raspbian. The lite versions do not come with all the necessary files to run the stack. See this issue for more details.

Instructions

(If you have already installed docker-compose skip to step 7.)

Install Docker

curl -sSL https://get.docker.com | sh

Add permission to Pi User to run Docker Commands

sudo usermod -aG docker pi

Reboot!
Test Docker installation

docker run hello-world

Install dependencies

sudo apt-get install libffi-dev libssl-dev

sudo apt-get install -y python python-pip

sudo apt-get remove python-configparser

Install Docker Compose

sudo pip install docker-compose

Clone this repo

git clone https://github.com/Brandawg93/Pi-Hole-Monitoring.git

Change directory into cloned repo

cd Pi-Hole-Monitoring

Start the stack

docker-compose up -d

Go to http://host_ip:3000 (where host_ip is the ip of the machine running the stack)
Type admin for the username and admin for the password
Set your new password
Done!

Updating

This is an ongoing project that may be updated frequently. If you would like the update your instance of Pi-Hole Monitoring, simply run the following commands:

docker-compose down

git pull origin master