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 exhaustion
  | **Note:** 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 Volts
  | **Note:** 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`` - Return the status of the Power Modules
- ``in_phase`` - Return the current AC input phase
- | ``in_volt`` - Return the current utility line voltage in VAC
  | **Note** 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 Hz
  | **Note:** 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 VAC
  | **Note:** 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 Hz
  | **Note:** 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.