NAME

        nsd - Munin plugin to monitor the number of queries a running process
              of nsd3 has recievied.

APPLICABLE SYSTEMS

        Linux or *nix system with a logging installtion of NSD v3 installed.
          (http://nlnetlabs.nl/projects/nsd/)

CONFIGURATION

        The plugin needs access to the nsd logfile and the nsd pid file to
        force the running nsd process to write the current statistics.

        Tip: To see if it's already set up correctly, just run this plugin
        with the parameter "autoconf".  If you get a "yes", everything should
        work like a charm already.

        This configuration section shows the defaults of the plugin:

        The stats line is a set of space-separated values that you wish to
        retrieve from NSD.  The format is VALUE=Caption.  For spaces in a
        caption value, replace them with an underscore (_).

        [nsd]
                env.statsfile /var/log/nsd.log
                env.pidfile /var/run/nsd3/nsd.pid
                env.stats "A=A AAAA=AAAA MX=MX PTR=PTR TYPE252=AXFR SNXD=NXDOMAIN RQ=Total_Successful"

        If you need to set a user for the logfile to be readable, and most
        importantly, the process to receive the signal, you may specify it.
        For example:

        [nsd]
                user nsd

INTERPRETATION

        The plugin shows the number of queries that nsd has received,
        averaged over a period to gain the number of queries per second.
        For most servers, these values will be very low.  In the event
        of a misconfiguration, the plugin will return undefined values.

MAGIC MARKERS

        #%# family=auto
        #%# capabilities=autoconf

VERSION

        v1.0.1

AUTHOR

        J.T.Sage <jtsage@gmail.com>

LICENSE

        GPLv2