Skip to content

PowerDNS Recursor

A recursive DNS server: https://www.powerdns.com/recursor.html

Direct, Agent or SNMP Extend

The LibreNMS polling host must be able to connect to port 8082 on the monitored device. The web-server must be enabled, see the Recursor docs: https://doc.powerdns.com/md/recursor/settings/#webserver

Variables

$config['apps']['powerdns-recursor']['api-key'] required, this is defined in the Recursor config

$config['apps']['powerdns-recursor']['port'] numeric, defines the port to connect to PowerDNS Recursor on. The default is 8082

$config['apps']['powerdns-recursor']['https'] true or false, defaults to use http.

If this device has no agent, install the agent and copy the powerdns-recursor script to /usr/lib/check_mk_agent/local/

This script uses rec_control get-all to collect stats.

  1. Copy the shell script, powerdns-recursor, to the desired host
wget https://github.com/librenms/librenms-agent/raw/master/snmp/powerdns-recursor -O /etc/snmp/powerdns-recursor
  1. Make the script executable.
chmod +x /etc/snmp/powerdns-recursor
  1. Edit your snmpd.conf file and add:
extend powerdns-recursor /etc/snmp/powerdns-recursor
  1. Restart snmpd on your host.

LibreNMS discovers the application automatically, as described at the top of the page. If the discovery fails, do the steps under the SNMP Extend heading at the top of the page.