Search Exchange

Search All Sites

Nagios Live Webinars

Let our experts show you how Nagios can help your organization.

Contact Us

Phone: 1-888-NAGIOS-1
Email: sales@nagios.com

Login

Remember Me

Check APC UPS

Rating
4 votes
Favoured:
1
Current Version
2.1.1
Last Release Date
2017-04-20
Compatible With
  • Nagios 3.x
  • Nagios 4.x
  • Nagios XI
Owner
License
GPL
Hits
14323
Files:
FileDescription
check_apc.plcheck_apc.pl
Network Monitoring Software - Download Nagios XI
Log Management Software - Nagios Log Server - Download
Netflow Analysis Software - Nagios Network Analyzer - Download
This is a fork of the original check_apc.pl from layerthree (https://exchange.nagios.org/directory/Plugins/Hardware/UPS/APC/check_apc-2Epl/details)
It extends the capabilities and it was modeled to monitor a SYMMETRA APC UPS, however it can support a wide range of APC UPS, already tested on Symmetra and SmartUPS
This script uses only snmp, no other binaries needed to run
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.
Reviews (2)
bynishith, September 19, 2019
This plugin worked well on my SmartUPS RT 2000 XL.

Just follow the instructions given by the author & walla....
bySB, June 30, 2017
Works great on our APC Symmetra 40K
may easier to set up -w & -c then with the check_snmp.
it had a few unlisted requirements that are not part of the Nagios Core install natively. (perl-Net-SNMP & perl-Switch)

now monitoring 19 aspects of our APC UPS!!