Skip to content

ma4nn/pihole-munin-plugins

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 

Repository files navigation

MuninPiholePlugins

Munin plugins for monitoring Pi-hole (tested with Pi-hole v4.3 - https://pi-hole.net)

Plugins

  • pihole_queries show the queries rates (total dns queries and blocked queries/ads rates). The daily graph from this plugin should have a curve pace very similar to the one from the Pi-hole web interface.
  • pihole_cache shows the queries cache rates (forwarded and cached queries rates)
  • pihole_clients shows the unique clients statistics (counter which is reset every day).
  • pihole_querytypes shows the percentage of DNS query types like A, AAAA, etc.

Configuration

The Pi-hole web interface need to be installed in order to have the plugins working (they use the web interface api).

Sample setup for '/etc/munin/plugin-conf.d/munin-node':

[pihole_*]
user root
env.host 127.0.0.1
env.port 80
env.api /admin/api.php
env.pw secret

The password env.pw is only needed for pihole_querytypes and is the password of the Pi-hole web interface.

Samples

Graphs

Queries graph in Pi-hole:

pihole

Queries graph in Munin (daily):

pihole_queries-day

Queries graph in Munin (weekly):

pihole_queries-week

Cache graph in Munin (daily):

pihole_cache-day

Clients graph in Munin (weekly):

pihole_queries-week

Releases

No releases published

Packages

No packages published

Languages

  • Shell 100.0%