check_apcaccess is a Nagios / Icinga plugin for checking APC UPS devices using apcupsd.

Requirements

The plugin requires a working apcupsd installation - see the apcupsd online documentation for instructions and valid configuration types.

Usage

By default, the script checks the UPS temperature, load and battery load. It is possible to control this behaviour by specifying additional parameters (see below). The script also support performance data for data visualization.

The following parameters can be specified:

Parameter	Description
-d / --debug	enable debugging outputs (default: no)
-f / --file	defines the apcupsd configuration file (default: /etc/apcupsd/apcupsd.conf)
-h / --help	shows help and quits
-P / --show-perfdata	enables performance data (default: no)
-w / --temp-warning	defines temperature warning threshold in Celsius (default: 50 C)
-c / --temp-critical	defines temperature critical threshold in Celsius (default: 50 C)
-l / --load-warning	defines load warning threshold in percent (default: 50%)
-L / --load-critical	defines load critical threshold in percent (default: 50%)
-b / --battery-warning	defines battery load warning threshold in percent (default: 80%)
-B / --battery-critical	defines battery load critical threshold in percent (default: 50%)
-t / --time-warning	defines battery time left warning threshold in minutes (default: empty)
-T / --time-critical	defines battery time left critical threshold in minutes (default: empty)
-u / --consumption-warning	defines power consumption warning threshold in watts (default: empty)
-U / --consumption-critical	defines power consumption critical threshold in watts (default: empty)
--version	prints programm version and quits

Examples

The following example checks major metrics of a connected UPS:

$ ./check_apcaccess.py
OK: temperature okay (34.0), load okay (39.0), battery load okay (100.0)

Also checking battery time and power consumption:

$ ./check_apcaccess.py -t 20 -T 10 -u 100 -U 150
OK: temperature okay (34.0), load okay (34.0), battery load okay (100.0), battery time okay (28.0), power consumption okay (78.2)

Reporting performance data:

$ ./check_apcaccess.py -P
OK: temperature okay (34.0), load okay (35.0), battery load okay (100.0) | 'consumption'=80.5 'temperature'=34.0;50.0;60.0;0.0;100.0 'load'=35.0;50.0;80.0;0.0;100.0 'battery_load'=100.0;80.0;50.0;0.0;100.0

Installation

To install the plugin, move the Python script into the appropriate directory and create a NRPE configuration.

Configuration

Inside Nagios / Icinga you will need to configure a remote check command, e.g. for NRPE:

#check_nrpe_apcaccess
define command{
    command_name        check_nrpe_apcaccess
    command_line        $USER1$/check_nrpe -H $HOSTADDRESS$ -c check_apcaccess -a $ARG1$
}

Configure the check for a particular host, e.g.:

#DIAG: Updates
define service{
        use                             generic-service
        host_name                       st-ipfire02
        service_description             DIAG: APC UPS
        check_command                   check_nrpe_apcaccess!-P
}