Nagios/Centreon Plugin for the Pihole API

A plugin to extract (almost) all the information from the Pi-hole API.

Installation

• Just put it in the folder /usr/lib/nagios/plugin

Token

• Get the token from the value WEBPASSWORD in the file /etc/pihole/setupVars.conf and put it in /usr/lib/nagios/plugin/apihole.token

Usage

• Usage ./check_pihole_api -h pihole_ipaddress -p [ http || https ] -s [ clients || queries || ads ] || -i || -q || -t

• -s (summary)

  • clients: Number of clients using Pihole as their DNS server
  • queries: Number of DNS queries
  • ads: Number and percentage of ads blocked.

• -p (protocol) Protocol to be used in the API call (http||https). By default: http

• -i (information) show the version of the plugin

• -q queries by type AAAA, A, SOA, TXT, PTR, ANY, SRV, IPV4, IPV6

• -t Show a TOP number of queries by host

More info

• Sigue todos los pasos de instalacion en mi blog

Buy me a coffe