Search Exchange
Search All Sites
Nagios Live Webinars
Let our experts show you how Nagios can help your organization.Login
Directory Tree
Check APC UPS
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
25612
Files:
File | Description |
---|---|
check_apc.pl | check_apc.pl |
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.
- 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.
This plugin worked well on my SmartUPS RT 2000 XL.
Just follow the instructions given by the author & walla....
Just follow the instructions given by the author & walla....
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!!
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!!