[blackbird-named] Monitor Bind (named) with blackbird

blackbird named plugin

This plugin gets various information from named statistics-channels and sends the data to the backend

statistics-channels

You can spit out statistics in xml with the bind function

See here for more information.

I think that many people who operate bind do compile by themselves, but this function will not be enabled unless --with-libxml2 is done at the time of compile.

By the way, if it is a redhat system, rpm is provided, but thankfully this rpm is made with --with-libxml2.

Install

blackbird body

Please install by referring to here

Install named plugin

You can either use setup.py or rpm.

install with setup.py

git clone https://github.com/Vagrants/blackbird-named.git
cd blackbird-named
python setup.py install

install with rpm

yum install blackbird-named --enablerepo=blackbird

Set plugin

config is in /etc/blackbird/conf.d/named.cfg

ini:/etc/blackbird/conf.d/named.cfg

[named]
module = 'named'

# NOTICE
#  - bbd user needs permission to execute rndc.
#    edit /etc/blackbird/defaults.cfg and change user and group.
#
#    user = root
#    group = root
#
#  - if you do not need rndc information, comment out 'rndc-path'
rndc_path = '/usr/sbin/rndc'

# statistics-channels
#  - please set statistics-channels in named.conf
#
# ex)
# statistics-channels {
#         inet 127.0.0.1 port 5353 allow { 127.0.0.1/32; };
# };
#
statistics_host = '127.0.0.1'
statistics_port = '5353'

You can also monitor the value of rndc status, but normally rndc cannot be run by a bbd user who runs blackbird authoritatively.

In this case, you can monitor by setting the execution permission of blackbird to root.

/etc/blackbird/defaults.cfg

[global]
user = root
group = root

However, I'm wondering if it can be run as root, so I'm going to change it to hit with sudo internally ... (not yet implemented)

The default monitoring interval is 60 seconds, but if you want to change it

ini:/etc/blackbird/conf.d/named.cfg

interval = 30

Please specify as

Reboot blackbird when you're done

sudo /etc/init.d/blackbird restart

Enable statistics-channels in named.conf

There is an example in named.cfg,

statistics-channels {
        inet 127.0.0.1 port 8080 allow { 127.0.0.1; };
};

Please enter the settings like this. Match the port number with /etc/blackbird/conf.d/named.cfg

Check if data is coming in on Zabbix

Zabbix Templates can be found in the github repository Please import to Zabbix and apply to the target server

** If the host name on Zabbix and the host name of the server on which blackbird is running are different, you need to set the hostname on /etc/blackbird/conf.d/named.cfg ** Please match with Zabbix

ini:/etc/blackbird/conf.d/named.cfg

hostname = your_static_hostname