DNS

check_bind.sh

Write a Review

Description:

sh compliant script to check whether BIND is running and to get the performance data via rndc stats (PNP Template included)

Current Version

1.3

Last Release Date

2009-05-20

Compatible With

  • Nagios 2.x
  • Nagios 3.x

Owner

Mike Adolphs

Website

http://fooforge.com/

Copy Page Link Recommend Contact Owner Login to Add to Favorites
Project Files
FileDescription
check_bind.sh

The plugin (v1.3)

LICENSE

GNU GPLv2 License

check_bind.php

PNP Template

Project Photos
Project Notes
Description check_bind.sh is a Nagios plugin to check the bind daemon whether it's running via its pid file and then gets the statistics via rndc stats. The user that run the script needs the ability to 'sudo rndc stats'! The timeframe in which the rndc stats output is updated is controlled by the check interval. The output shows amount of requests of various types occured during the last check interval. The script itself is written sh-compliant and free software under the terms of the GPLv2 (or later). BIND9 versions 9.3 and 9.5 or greater are now supported as well. I didn't have the time yet to do more testing. It works for me under Gentoo with BIND 9.4 and 9.6 and under Debian Lenny with BIND 9.5 as well. If something doesn't work, please contact me via mike@matejunkie.com or via a blog comment at [http://www.matejunkie.com/]. Thanks in advance. I finally solved the mawk/gawk problem with a little help from a user of this plugin. It should run now with either gawk or mawk without any problems. -h/--help Output check_bind.sh -p/--path_pid /var/run/named -n/--name_pid named.pid -r/--path-rndc /usr/sbin -s/--path-stats /var/bind -V/--bind-version 9.3/9.4/9.5 -N Options: -p/--path-pid) Path where the pid file for bind is stored. You might need to alter this to your distribution's way of dealing with pid files. Default is: /var/run/named -n/--name_pid) Name of the pid file. Default is: named.pid -r/--path-rndc) Path where the rndc binary is located. Default is: /usr/sbin -s/--path-stats) Path where the named.stats file is stored. Default is: /var/bind -t/--path-tmp) Path where the temporary named.stats excerpt is being stored. Default is: /tmp -V/--bind-version) Specifies the bind version you're running. Currently there's BIND 9.3, 9.4 and 9.5 supported. Default is: 9.4 -N/--no-pid-check) If you don't want that the script checks for the pid file, use this option. Default is: off Output example user@host ~ $ ./check_bind.sh Bind9 is running. 640 successfull requests, 0 referrals, 3 nxdomains since last check. | 'success'=640 'referral'=0 'nxrrset'=236 'nxdomain'=3 'recursion'=1 'failure'=0 'duplicate'=0 'dropped'=0 Changelog * 2009-05-20 * Bugfix for more awk compliance * 2009-05-14 * Small bugfix for two exit codes * 2009-05-03 * The plugin now supports BIND versions 9.3 and 9.5+. * The named.stats file is now initially parsed via awk and the excerpts are being copied to a temp directory for further use instead of frequently tail'ing the named.stats * The temporary directory is configurable via -t/--path-tmp as well * The path to the rndc binary is now configurable via -r/--path-rndc * You're now able to deactivate the pid check via -N/--no-pid-check * 2009-04-06 * Did some slight debugging on the option parsing. The -s/--path-stats option was missing. Should be working now just fine.
Reviews (4) Add a Review
bind statistic file not cleared after the script executes
by sergeiadmin, November 30, 2021

Just my +2 Cents. The script doesnt' truncate the stats file from rndc stats command. As result after several years I noticed that /var/named/data/named_stats.txt increased to 1,5G and when the script within icinga tries to run this script it take about 2 minutes before tac command load all the file into the memory to perform awk action. Of course icinga tries to kill the script after 60 seconds timeout and produces error. I have modified a script a little a bit, so the named statistics file will be purged everytime after check_bind.sh is executed: [root@dns2 ~]# diff -u /usr/lib64/nagios/plugins/site/privileged/check_bind.sh ./check_bind.sh --- /usr/lib64/nagios/plugins/site/privileged/check_bind.sh 2021-11-08 15:20:32.365380038 +0100 +++ ./check_bind.sh 2021-11-09 13:44:52.301734327 +0100 @@ -143,6 +143,7 @@ then sudo chroot $path_chroot $path_rndc/rndc stats else + test -f $path_stats/named_stats.txt && truncate --size 0 $path_stats/named_stats.txt sudo $path_rndc/rndc stats fi }


Executing through ssh
by unsleepable, May 31, 2014

This check calls sudo to run /usr/sbin/rndc stats. This may be an issue if "Defaults requiretty" is set in /etc/sudoers, and you run the command through sh without opening a session at the remote host. To resolve this, either remove "Defaults requiretty" from /etc/sudoers, or modify the script so that it doesn't call sudo.


Works with BIND 9.6
by saniks, December 31, 2012

Works with BIND 9.6.-ESV-R5-P1 To work on FreeBSD replace "tac" in line 151 to "tail-r".


it doesn't let you perform a test query
by dylan22, December 31, 2011

The script required a few tweeks to work. 1-put nagios in the named group, 2-add "sudo rndc stats" That was it and it worked fine. I wish there was an option to send a test query though... how about --test-query test.domain.com That would send an alert because the query failed. (Having a PID doesn't always mean bind is working properly.)


Add a Review

You must be logged in to submit a review.

Thank you for your review!

Your review has been submitted and is pending approval.

Recommend

To:


From:


Thank you for your recommendation!

Your recommendation has been sent.

Page Sections
Project Overview Project Files Project Photos Project Notes Reviews
Project Stats
Rating
4 (5)
Favorites
2
Views
131,384