Skip to content

Latest commit

 

History

History
136 lines (104 loc) · 4.11 KB

README.md

File metadata and controls

136 lines (104 loc) · 4.11 KB

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

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

alt text

Related projects

lighttpd external.conf for Munin webserver proxy

Munin monitoring plugins for Pi-hole

Main repository for munin master / node / plugins

A black hole for Internet advertisements

Unbound is a validating, recursive, caching DNS resolver.