Check Command: check_apc¶
APC UPS’s use SNMPv1. You can configure SNMP for your UPS from its web interface or within your UPS’s configuration software client.
check_apc provides performance data and range monitoring for a wide series of data and a large number of APC UPS’s, including Symmetra and SmartUPS models.
This check command requires NEMS Linux 1.6+.
check_apc Available Command Arguments¶
id- Return the UPS model name (e.g. ‘APC Smart-UPS 600’) and interlan info about Firmware, CPU S/N and manufacturing date
bat_status- Return the status of the UPS batteries
bat_capacity- Return the remaining battery capacity expressed in percent of full capacity
bat_temp- Return the current internal UPS temperature expressed in Celsius
bat_run_remaining- Return the UPS battery run time remaining before battery exhaustionNote: thresholds must be expressed in minutes
bat_replace- Return whether the UPS batteries need replacing
bat_num_batt- Return the number of external battery packs connected to the UPS
bat_num_bad_batt- Return the number of external battery packs connected to the UPS that are defective
bat_act_volt- Return the actual battery bus voltage in VoltsNote: thresholds must be expressed in range as nearest values. ex:normal=220, warning=215:225, critical=210:230Additionally, the checks will look for Nominal Voltage (as returnedby the UPS), and exit as CRITICAL if Actual Voltage is LOWER or Equal
power_modules- Return the status of the Power Modules
in_phase- Return the current AC input phase
in_volt- Return the current utility line voltage in VACNote thresholds must be expressed in range as nearest values. ex:normal=220, warning=215:225, critical=210:230
in_freq- Return the current input frequency to the UPS system in HzNote: thresholds must be expressed in range as nearest values. ex:normal=50, warning=45:55, critical=40:60
out_status- Return the current state of the UPS
out_phase- Return the current output phase
out_volt- Return the output voltage of the UPS system in VACNote: thresholds must be expressed in range as nearest values. ex:normal=220, warning=215:225, critical=210:230
out_freq- Return the current output frequency of the UPS system in HzNote: thresholds must be expressed in range as nearest values. ex:normal=50, warning=45:55, critical=40:60
out_load- Return the current UPS load expressed in percent of rated capacity
out_current- Return the current in amperes drawn by the load on the UPS
comm_status- Return the status of agent’s communication with UPS.
If no command is supplied, the script returns OKAY with the UPS model information.