Fastback E/V Band Devices Nagios Check

This Nagios/Icinga Check provides the ability to query Fastback E and V-Band devices (former Sub10 Liberator E1000e or V1000) for status and parameters. It will output performance data to monitor reception quality and errors for tools like pnp4nagios. A event handler script for Rebooting a device is also provided. Implementation is in Python. You will need Python libraries nagiosplugin and pysnmp as dependencies.

You need to enable the SNMP Agent on the Sub10 device and set a SNMP Read community. For using the reboot script, you need to also set the SNMP write community.

Installation (manual using pip) on your Nagios Host

pip install nagiosplugin pysnmp
python setup.py install
ln -s /usr/bin/check_sub10 /usr/lib/nagios/plugins/check_sub10
ln -s reboot_sub10 /usr/share/nagios3/plugins/eventhandlers/reboot_sub10

Installation Debian package

For Debian you can use the provided Debian package. Debian Jessie should be fine without any additional packages. For Debian Wheezy you will need python-configparser from Backports.

Usage example

Nagios Plugin called manually:

./check_sub10 -H 1.2.3.4 -C public

See check_sub10 -h for additional command line arguments. Use -vvv to get Debug Output including serial, terminal name, link name, firmware data and additional information.

Reboot event handler script called manually:

./reboot_sub10 -H 1.2.3.4 -C private DOWN HARD 1

Using a config file

You can use a config file to change ranges of the warning and critical value ranges for the different monitored devices. The config is expected to be named /etc/check_sub10.conf. Use the command line Switch --config (-c) to override this behaviour.

The config file must contain sections named after the specified hostname/hostaddress of the device (parameter -H) of the check_sub10 call. You can list the changed parameters within this section. Non present value will take over the defaults. Example (all values are the default values):

/etc/check_sub10.conf

[10.0.0.1]
modem_temp_min_warn = -30
modem_temp_min_crit = -40
modem_temp_min_warn = 65
modem_temp_min_crit = 85

rx_power_min_warn = -55
rx_power_min_crit = -60

vect_err_min_warn = -20
vect_err_min_warn = -40

link_loss_min_warn = -20
link_loss_min_crit = -40

Nagios Integration

Define the commands for Nagios checks and include it in the service definitions:

define command {
	command_name	check_sub10
	command_line	/usr/lib/nagios/plugins/check_sub10 -C $ARG1$ -H $HOSTADDRESS$
}
define service {
	use			generic-service-perfdata
	hostgroup_name		sub10g
	service_description	check_sub10
	check_command		check_sub10!SNMP_COMMUNITY
}

To use the event handler script to reboot a Sub10 device, define the reboot command and use it on the child device:

define command {
	command_name	reboot_sub10_sub10-device
	command_line	/usr/share/nagios3/plugins/eventhandlers/reboot_sub10 -H FIXME -C private $HOSTSTATE$ $HOSTSTATETYPE$ $HOSTATTEMPT$
}
define host{
	use				generic-host
	host_name			some-child-host
	parents				sub10-device
	address				FIXME
	event_handler_enabled		1
	event_handler			reboot_sub10_sub10-device
}