Nagios Plug-In for ServersCheck Environmental Sensors readme.txt
Updated August 4th, 2010 by ServersCheck


Depending on support agreement, technical support is available on http://www.serverscheck.com
 

WHAT IS THE SERVERSCHECK PLUG-IN FOR NAGIOS?
================================================

ServersCheck's environmental sensors can integrate off-the-shelve with Nagios as it uses standard SNMP protocol.

However environmental monitoring requires to monitor a value between a minimum and maximum range and alert when those tresholds have been exceeded.   Due to a limitation in Nagios, it is not possible to do this without additional programming.

The plug-in provided by ServersCheck enables you to achieve this.


FILES INCLUDED IN THIS PACKAGE
==============================

The files available in this directory are:
- README.TXT -> this readme file
- sensorgateway_web.png -> an icon for the ServersCheck sensor to be used in the Nagios maps
- sensor1p.cfg -> the configuration file for the sensor check
- check_sensor.pl -> perl script to verify if sensor is within lower and upper treshold limits


DETAILS FOR THE PLUG-IN
========================

To monitor a sensor value you need 2 items:
- configuration file (sensor1p.cfg)
- the Plug-In as a Perl Script (check_sensor.pl)

Using the plugin called check_sensor Nagios knows that temperature sensor results MUST be >=20 and <=25 
When configured in degrees Farenheit one would set it to =>68 and <=77

The treshold limits can be easily modified by editing the values in the check_command line in the sensor1p.cfg file.

Example:
check_command           check_sensor!-c public -p 161 -o 1.3.6.1.4.1.17095.3.6.0 -d 20 -u 25

In the above example the lower limit is 20 and the upper limit is 25
To change it in degrees farenheit we would change it to
check_command           check_sensor!-c public -p 161 -o 1.3.6.1.4.1.17095.3.6.0 -d 68 -u 75


CONFIGURATION FOR THE PLUG-IN
=============================

In order to use the plug-in copy the script check_sensor.pl into the /usr/local/nagios/libexec folder and add the following lines into /usr/local/nagios/etc/objects/commands.cfg

define command{ 
	command_name check_sensor 
	command_line	$USER1$/check_sensor.pl -h $HOSTADDRESS$ $ARG1$ 
}
