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

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.

saint-lascivious / munin-unbound-plugins Goto Github PK