A python munin plug-in for the BIND9 DNS server's statistics channel/server
Switch branches/tags
Latest commit fa8f925 Nov 6, 2017 @shuque shuque version 0.30
Failed to load latest commit information.
samplegraphs Added samplegraphs subdirectory. Dec 8, 2013
README version 0.30 Nov 6, 2017
bind9stats.py version 0.30 Nov 6, 2017


version 0.30

A munin plugin to obtain data from a BIND9 statistics server, written
in Python. Tested with BIND 9.10 and 9.11's statistics server exporting 
version 3 of the statistics. In earlier versions of BIND 9.9, the v3 schema 
of statistics can be specified using the 'newstats' configuration directive.
The newstats option was introduced in BIND 9.9.3.

If you are using older versions of BIND 9.9 that only support version 
2  of the XML statistics, you'll need to use the 0.1x version of this 
program, which can be obtained from: 


Software needed to use this:
* Python 2.7 or later (should work with Python 3, but I haven't 
  tested it extensively)
* BIND: BIND DNS server from isc.org. https://www.isc.org/software/bind
* Munin: a resource monitoring tool that does pretty graphs.
       See http://munin-monitoring.org/ for details.)

Some notes:
* BIND can be configured to provide per-zone query statistics also. This
  plugin currently doesn't process that data, and only does the aggregate
  statistics for the entire server.
* Only the _default view is used. Servers configured to use multiple
  views that want per view statistics will have to extend this program
  a bit.

Instructions for using this:
- Have a DNS server running BIND9, with the statistics server enabled.

  On my BIND servers, I usually have something like the following in the
  configuration file:

        statistics-channels {
                inet port 8053 allow {; };

- Have a munin-node running on it, install bind9stats.py in its plugins
  directory and restart the node.
  You can also run the plugin on another machine, if the statistics
  server allows queries remotely. Set the HOST and PORT environment
  variables appropriately in that case before invoking bind9stats.py.

Author: Shumon Huque

Copyright (c) 2013-2015 - Shumon Huque. All rights reserved.  
This program is free software; you can redistribute it and/or modify 
it under the same terms as Python itself.