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

Directory Tree

Check APC UPS

Rating
5 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
20603
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, 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.
Reviews (3)
bytallerinfo, January 14, 2022
Is excellent working in my nagios core server. I don't know how to use the option -U to send an script to shutdown all my servers when it has less than 15% capacity.
bynishith, September 19, 2019
1 of 1 people found this review helpful
This plugin worked well on my SmartUPS RT 2000 XL.

Just follow the instructions given by the author & walla....
bySB, June 30, 2017
1 of 1 people found this review helpful
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!!