This template collects PowerDNS metrics with Zabbix agent 2. Metrics come from 2 different parts. The first one is collected with the pdns_control show * command. The second one is collected with the pdns_query_check.sh script.
In order for the pdns_query_check.sh script to run correctly, the DNS A record of the server's hostname must be registered on the PowerDNS server.
This template allows you to monitor specified metrics.
There are only 3 pre-configured triggers. These are pre-configured triggers: PowerDNS: pdns.make-dns-query, PowerDNS: security-status (Mandatory Upgrade), PowerDNS: security-status (Recommended Upgrade) .
The instructions and template were tested on Rocky Linux 9, PowerDNS 4.8.3, Zabbix 6.0 LTS and Zabbix Agent 2 6.0 LTS
backend-queries
corrupt-packets
deferred-cache-inserts
deferred-cache-lookup
deferred-packetcache-inserts
deferred-packetcache-lookup
dnsupdate-answers
dnsupdate-changes
dnsupdate-queries
dnsupdate-refused
incoming-notifications
noerror-packets
nxdomain-packets
overload-drops
packetcache-hit
packetcache-miss
packetcache-size
query-cache-hit
query-cache-miss
query-cache-size
rd-queries
recursing-answers
recursing-questions
recursion-unanswered
security-status
servfail-packets
signatures
tcp-answers
tcp-answers-bytes
tcp-cookie-queries
tcp-queries
tcp4-answers
tcp4-answers-bytes
tcp4-queries
tcp6-answers
tcp6-answers-bytes
tcp6-queries
timedout-packets
udp-answers
udp-answers-bytes
udp-cookie-queries
udp-do-queries
udp-queries
udp4-answers
udp4-answers-bytes
udp4-queries
udp6-answers
udp6-answers-bytes
udp6-queries
unauth-packets
zone-cache-hit
zone-cache-miss
zone-cache-size
backend-latency
cache-latency
cpu-iowait
cpu-steal
fd-usage
key-cache-size
latency
meta-cache-size
open-tcp-connections
qsize-q
real-memory-usage
receive-latency
ring-logmessages-capacity
ring-logmessages-size
ring-noerror-queries-capacity
ring-noerror-queries-size
ring-nxdomain-queries-capacity
ring-nxdomain-queries-size
ring-queries-capacity
ring-queries-size
ring-remotes-capacity
ring-remotes-corrupt-capacity
ring-remotes-corrupt-size
ring-remotes-size
ring-remotes-unauth-capacity
ring-remotes-unauth-size
ring-servfail-queries-capacity
ring-servfail-queries-size
ring-unauth-queries-capacity
ring-unauth-queries-size
send-latency
signature-cache-size
sys-msec
udp-in-csum-errors
udp-in-errors
udp-noport-errors
udp-recvbuf-errors
udp-sndbuf-errors
udp6-in-csum-errors
udp6-in-errors
udp6-noport-errors
udp6-recvbuf-errors
udp6-sndbuf-errors
uptime
user-msec
xfr-queue
This command creates a configuration file /etc/sudoers.d/pdns for the Zabbix agent. It specifies that the zabbix user can execute the /usr/bin/pdns_control command using sudo without requiring a password and without the need for a tty (terminal). This setup is typically used to allow automated scripts or monitoring tools like Zabbix to perform specific administrative commands securely and without manual intervention.
cat << 'EOF' > /etc/sudoers.d/pdns
# Zabbix Agent PDNS
Defaults:zabbix !requiretty
zabbix ALL=NOPASSWD: /usr/bin/pdns_control
EOF
This command creates a configuration file at /etc/zabbix/zabbix_agent2.d/plugins.d/pdns.conf for the Zabbix agent. This configuration file defines two user parameters:
UserParameter=pdns.stats[*],/usr/bin/sudo /usr/bin/pdns_control show $1 This parameter allows the Zabbix agent to execute the pdns_control show $1 command with sudo. The $1 is a placeholder for a variable argument, meaning this parameter can be used to retrieve various statistics from the PowerDNS (PDNS) server by specifying different arguments.
UserParameter=pdns.make-dns-query, /usr/local/bin/pdns_query_check.sh This parameter enables the Zabbix agent to execute the pdns_query_check.sh script. This script is used to perform DNS queries or checks related to the PDNS service, and its execution results can be monitored by the Zabbix agent.
cat << 'EOF' > /etc/zabbix/zabbix_agent2.d/plugins.d/pdns.conf
UserParameter=pdns.stats[*],/usr/bin/sudo /usr/bin/pdns_control show $1
UserParameter=pdns.make-dns-query, /usr/local/bin/pdns_query_check.sh
EOF
This command creates a script file at /usr/local/bin/pdns_query_check.sh that checks whether the DNS server responds to queries.
cat << 'EOF' > /usr/local/bin/pdns_query_check.sh
#!/bin/bash
hostname=$(hostname -f)
dig_output=$(dig A $hostname @localhost +short)
if [ $? -gt 0 ] || [[ -z $dig_output ]]; then
echo "FAIL"
exit 1
fi
echo "OK"
exit 0
EOF
chmod +x /usr/local/bin/pdns_query_check.sh
Finally, the zabbix-agent2.service service must be restarted for the changes to take effect.
systemctl restart zabbix-agent2.service
Go to the Zabbix web interface. Click the Import button in the Configuration>Templates section and select the PowerDNS-Zabbix-Template.yaml file.
The template is now ready to use.
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request