Observium – Unix Agent w/ Unbound

Documentation can be found here. Modules can be found here.

I’m assuming you have been following my other guides and this is a Debain Wheezy box that you’d like to monitor. I’m doing this to monitor Unbound.

apt-get install subversion snmpd xinetd

Because this is a very active project, we are just checking out the scripts directory. That way we can update the agent quickly.

mkdir -p /opt/observium && cd /opt
svn co http://svn.observium.org/svn/observium/branches/stable/scripts observium/scripts
mkdir -p /usr/lib/observium_agent/local

We are using symlinks so when we update, the files are updated!

ln -s /opt/observium/scripts/observium_agent /usr/bin/observium_agent

We are going to enable the unbound module.

ln -s /opt/observium/scripts/agent-local/unbound /usr/lib/observium_agent/local/unbound

Copy the config then edit it.

cp /opt/observium/scripts/observium_agent_xinetd /etc/xinetd.d/observium_agent

Edit /etc/snmp/snmpd.conf. Add the community strings and update the location and contact fields.

Restart snmpd.

Edit /etc/unbound/unbound.conf and add

• statistics-cumulative: yes
• extended-statistics: yes

Restart unbound.

Restart xinetd.

The setup can be verified by using telnet 127.0.0.1 36602 or from the remote Observium box telnet ip 36602.

On Observium, add the device then under the device settings, enable the Unix Agent.

The distro will show as generic until you follow this guide.

ln -s /opt/observium/scripts/distro /usr/bin/distro
echo "extend .1.3.6.1.4.1.2021.7890.1 distro /usr/bin/distro" >> /etc/snmp/snmpd.conf