Check APC UPS

Project Notes

This script uses only snmp, please note you need PERL installed with modules:

- perl-Net-SNMP
- perl-Switch

UPS uses SNMPv1 that you can configure from the web interface.

This script provides perfomance data and range monitoring for a wide series of data, it comes with a built-in help

------------------------------------------------------------

Usage:
-H Address of hostname of UPS (required)
-C SNMP community string (required)
-l Command (optional, see command list)
-p SNMP port (optional, defaults to port 161)
-t Connection timeout (optional, default 10s)
-w Warning threshold (optional, see commands)
-c Critical threshold (optional, see commands)
-u Script / connection errors will return unknown rather than critical

Commands (supplied with -l argument):

id
The UPS model name (e.g. 'APC Smart-UPS 600') and interlan info about Firmware, CPU S/N and manufacturing date

bat_status
The status of the UPS batteries

bat_capacity
The remaining battery capacity expressed in percent of full capacity

bat_temp
The current internal UPS temperature expressed in Celsius

bat_run_remaining
The UPS battery run time remaining before battery exhaustion
** NB: thresholds must be expressed in minutes **

bat_replace
Indicates whether the UPS batteries need replacing

bat_num_batt
The number of external battery packs connected to the UPS

bat_num_bad_batt
The number of external battery packs connected to the UPS that are defective

bat_act_volt
The actual battery bus voltage in Volts
** NB: thresholds must be expressed in range as nearest values. ex: normal=220, warning=215:225, critical=210:230 **
** Additionally, the checks will look for Nominal Voltage (as returned by the UPS), and exit as CRITICAL if Actual Voltage is LOWER or Equal **

power_modules
The status of power modules
in_phase
The current AC input phase

in_volt
The current utility line voltage in VAC
** NB: thresholds must be expressed in range as nearest values. ex: normal=220, warning=215:225, critical=210:230 **

in_freq
The current input frequency to the UPS system in Hz
** NB: thresholds must be expressed in range as nearest values. ex: normal=50, warning=45:55, critical=40:60 **

out_status
The current state of the UPS

out_phase
The current output phase

out_volt
The output voltage of the UPS system in VAC
** NB: thresholds must be expressed in range as nearest values. ex: normal=220, warning=215:225, critical=210:230 **

out_freq
The current output frequency of the UPS system in Hz
** NB: thresholds must be expressed in range as nearest values. ex: normal=50, warning=45:55, critical=40:60 **

out_load
The current UPS load expressed in percent of rated capacity

out_current
The current in amperes drawn by the load on the UPS

comm_status
The status of agent's communication with UPS.