/pihole_exporter

Prometheus exporter for PiHole metrics

Primary LanguageGoApache License 2.0Apache-2.0

pihole_exporter

License Apache 2

Fork from nlamirault/pihole_exporter, this fixes metrics format changes in pi-hole v3.3. Also adds support for arm in Dockerfile.

Docker container for Raspberry Pi 3 (arm v7):

docker pull povilasv/arm-pihole_exporter

Building:

docker build -t povilasv/arm-pihole_exporter:latest -f Dockerfile_arm .

Note version number matches pihole version this exporter supports.

Overview

This Prometheus exporter check your Pi-Hole statistics. Available metrics are :

  • Ads blocked
  • Domains blocked
  • DNS Queries
  • Top Ads
  • Top Queries
  • Top clients

Grafana dashboard

You can import grafana dashboard from https://grafana.com/dashboards/5855

Development

  • Build tool:

    make build

  • Launch unit tests:

    make test

Docker Deployment

  • Build Image:

    docker build -t pihole-exporter .

  • Start Container

    docker run -d -p 9311:9311 pihole-exporter -pihole http://192.168.1.5

Contributing

See CONTRIBUTING.

License

See LICENSE for the complete license.

Changelog

A changelog is available