munin-unbound-plugins

Munin plugins for monitoring Unbound

Automated Installation

Automated installation script for Debian/Ubuntu derivatives

Note: Automated installation is in its infacy right now and not particularly well tested

• Download the munin-pihole-plugins script

wget https://raw.githubusercontent.com/saint-lascivious/unbound-pihole-plugins/master/script/unbound-pihole-plugins

• Ensure it is executable

chmod +x unbound-pihole-plugins

• Install unbound-pihole-plugins

./unbound-pihole-plugins --install

For detailed usage information use

./unbound-pihole-plugins --help

Manual Installation

• Install Munin See the instructions in my lighttpd-external-munin-proxy repository

• Download the plugin

sudo wget https://raw.githubusercontent.com/saint-lascivious/munin-unbound-plugins/master/usr/share/munin/plugins/unbound_munin_ -P /usr/share/munin/plugins

• Ensure it is executable

sudo chmod a+x /usr/share/munin/plugins/unbound_munin_*

• Create any/all desired symbolic links

sudo ln -s /usr/share/munin/plugins/unbound_munin_ /etc/munin/plugins/unbound_munin_by_class

sudo ln -s /usr/share/munin/plugins/unbound_munin_ /etc/munin/plugins/unbound_munin_by_flags

sudo ln -s /usr/share/munin/plugins/unbound_munin_ /etc/munin/plugins/unbound_munin_by_type

sudo ln -s /usr/share/munin/plugins/unbound_munin_ /etc/munin/plugins/unbound_munin_by_opcode

sudo ln -s /usr/share/munin/plugins/unbound_munin_ /etc/munin/plugins/unbound_munin_by_rcode

sudo ln -s /usr/share/munin/plugins/unbound_munin_ /etc/munin/plugins/unbound_munin_histogram

sudo ln -s /usr/share/munin/plugins/unbound_munin_ /etc/munin/plugins/unbound_munin_hits

sudo ln -s /usr/share/munin/plugins/unbound_munin_ /etc/munin/plugins/unbound_munin_memory

sudo ln -s /usr/share/munin/plugins/unbound_munin_ /etc/munin/plugins/unbound_munin_queue

• Restart Munin services

sudo systemctl restart munin munin-node

Configuration

The default configuration should Just Work. If you have a non-standard configuration, you can do one of the following.

• Sample setup for /etc/munin/plugin-conf.d/unbound:

[unbound*]
    user root
    env.unbound_conf /etc/unbound/unbound.conf
    env.unbound_control /usr/sbin/unbound-control
    env.spoof_warn 100
    env.spoof_crit 1000

• Download and edit a sample /etc/munin/plugin-conf.d/unbound file from this repo:

sudo wget https://raw.githubusercontent.com/saint-lascivious/munin-unbound-plugins/master/etc/munin/plugin-conf.d/unbound -P /etc/munin/plugin-conf.d

Help! My graphs aren't showing up!

• Be patient

Graphs should be generated at five minute intervals. If you still do not see graphs after this time, try restarting the machine and waiting a further five minutes. If you still can not get any graphs to display, contact me for further support.

Contact

• Discord SaintLascivious

• Email saint@sainternet.xyz

• IRC ##saint-lascivious

• Reddit saint-lascivious

Related projects

• lighttpd-external-munin-proxy

lighttpd external.conf for Munin webserver proxy

• munin-pihole-plugins

Munin monitoring plugins for Pi-hole

• Munin

Main repository for munin master / node / plugins

• Pi-hole

A black hole for Internet advertisements

• Unbound

Unbound is a validating, recursive, caching DNS resolver.