Nagios Plug-in for OpenVZ (Version 0.9.0)
=========================================

This Nagios plug-in monitors the user_beancounters and quotas of a remote 
OpenVZ system.

It was inspired by the check_snmp_openvz.sh plug-in in the OpenVZ wiki with
the following improvements:

	Written as a single perl script compatible with Nagios' embedded perl.
	This is much more efficient than the shell script, four invocations
	of perl, and two executions of snmpwalk used by check_snmp_openvz.sh.

	Conforms to the plug-in conventions with regard to command line
	arguments.  The standard short and long options such as --host (-H)
	are used instead of positional arguments.

	Supports execution on the Nagios server using SNMP to retrieve the 
	data or it can be run on the OpenVZ server using check_nrpe to 
	retrieve the data.
	
	Allows user selection of warning and critical thresholds for the 
	resources in user_beancounters (actually uses /proc/bc/resources).
	Thresholds are specified in terms of the held value as a percentage of
	the barrier value for the user_beancounters.  In the case of quotas 
	the thresholds are triggered by usage as a percentage of the soft 
	limit.  Increases in the fail count are reported as CRITICAL errors.

Detail usage is displayed by running the plug-in with the -h or --help option.

Installation instructions are located in INSTALL.snmp if the plug-in is being 
run on the Nagios server and SNMP is used to retrieve the data from the OpenVZ
server.

If the plug-in is to be installed on the OpenVZ server then follow the 
instructions in INSTALL.nrpe.


ACKNOWLEDGMENTS
===============

This plug-in was inspired by check_snmp_openvz.sh located at
http://wiki.openvz.org/Monitoring_openvz_resources_using_nagios_and_snmp
