NAME

bind9_rndc - Plugin to monitor usage of bind 9 servers using rndc stats

CONFIGURATION

The following environment variables are used by this plugin

  [bind_rndc]
    env.rndc            /usr/sbin/rndc
    env.querystats      /var/run/named.stats

The user/group that runs the plugin must have read access to the stats file. To change user or group (usually Munin plugins are run as nobody) add this to the [bind_rndc] stanza if the "bind" user runs BIND:

    user bind

On the BIND side put

  statistics-file "/var/run/named.stats";

in the options part of your named.conf or set the querystats variable (see below) to where your named puts the statistics file by default.

You must also make sure the rndc.key file is readable by the user that runs the plugin.

If using AppArmor, make sure the stats file is allowed (On Ubuntu: add this line to /etc/apparmor.d/usr.sbin.named)

  /var/run/named/named.stats rw

FEATURES AND BUGS

Previous versions of this plugin allowed an empty "rndc" environment setting to not do a explicit dump of stats to the stats file. This version requires running rndc itself. This makes the method of finding the correct stats in the file more reliable than before.

AUTHOR

Contributed by Laurent Facq 15/06/2004. Based on Nicolai Langfeldt's bind9 plugin. Reworked by Dagfinn Ilmari Mannsåker. BIND 9.6 patch from "Vrivellino". Reworked by guillomovitch and Kenyon Ralph.

LICENSE

License not documented.

MAGIC MARKERS

 #%# family=manual