SNMP UPS Check

This plugin uses universal OIDs where possible to maximize compatibility with all UPS units. Some APC OID's are used but the bulk of the information is available to all models. This includes voltage, load, asset, self test status, alarms, temperatures and more!

This plugin has been tested thoroughly for working functionality, but only on APC UPS units we have at our facility.

Usage for SNMP v1/2c:
check_ups_snmp -H {host/IP} -t {type of check} [-C {SNMP community}]

Usage for SNMP v3:
check_ups_snmp -H {host/IP} -t {type of check} -u {user} -x {protocol} -X {password} -a {protocol} -A {password} -l {security mode}

Check types available are as follows:
alarm:
The number of active alarm conditions. If zero, status is OK, otherwise status is CRITICAL. When an alarm is present, the plugin will show the time and description for the alarm, but only if the UPS MIB files are available. You can specify the path to the MIBs with the -d option (by default, ./mibs is checked).

asset:
Returns the make, model, firmware and serial # of the unit. No perfdata is included in this check.

charge:
Estimated battery charge remaining, expressed as a % of full charge and time, in minutes. WARNING and CRITICAL values are required! These values should be provided as % charge.

input_lines:
The number of input lines utilized in this device.

load:
The percentage of the UPS capacity being used on the output line, i.e., the greater of the % capacity load and the % VA load. WARNING and CRITICAL values required! These values should be provided as % load.

output_lines:
The number of output lines utilized in this device.

selftest:
The results of the most recent UPS self-test. Returns CRITICAL if the test failed.

status:
The indication of the capacity remaining in the UPS system's batteries.
Normal indicates the remaining run-time is > upsConfigLowBattTime.
batteryLow indicates the remaining run-time is <= upsConfigLowBattTime.
batteryDepleted indicates the UPS will be unable to sustain the present load if utility power is lost or absent.
No perfdata is included in this check.

atemp|ambient:
The ambient temperature at the temperature probe, if installed. WARNING and CRITICAL values are required! These values should be provided as degrees C.

btemp|temp:
The ambient temperature at or near the UPS Battery casing. WARNING and CRITICAL values are required! These values should be provided as degrees C.

voltage:
The magnitude of the present input voltage in the input lines.
WARNING interval and CRITICAL values are required!
These values should be provided using an interval, marked by a :

Example: If the normal value is 400 V, a reasonable WARNING might be 395-405 V (a change of 5 V) and a good CRITICAL would be 390-410 V (a change of 10 V)