Skip to content

apcups plugin
Plugin name apcups
Type read
Callbacks config, read, shutdown
Status supported
Since 3.10
Copyright 1996–1999 Andre M. Hedrick, 2000–2004 Kern Sibbald, 2006 Anthony Gialluca, 2006–2007 Florian octo Forster
License GPLv2
Configuration collectd.conf(5)

The APC UPS plugin connects to an instance of Apcupsd to read various statistics about a connected uninterruptible power supply (UPS), such as voltage, load, etc.

Synopsis

 <Plugin "apcups">
   Host "localhost"
   Port "3551"
 </Plugin>

Example graphs

Dependencies

  • None

See also

Configuration

Configuration options · from collectd.conf(5)

See this section in the full configuration reference

Host Hostname
Hostname of the host running apcupsd. Defaults to localhost. Please note that IPv6 support has been disabled unless someone can confirm or decline that apcupsd can handle it.
Port Port
TCP-Port to connect to. Defaults to 3551.
ReportSeconds true|false
If set to true, the time reported in the timeleft metric will be converted to seconds. This is the recommended setting. If set to false, the default for backwards compatibility, the time will be reported in minutes.
PersistentConnection true|false

The plugin is designed to keep the connection to apcupsd open between reads. If plugin poll interval is greater than 15 seconds (hardcoded socket close timeout in apcupsd NIS), then this option is false by default.

You can instruct the plugin to close the connection after each read by setting this option to false or force keeping the connection by setting it to true.

If apcupsd appears to close the connection due to inactivity quite quickly, the plugin will try to detect this problem and switch to an open-read-close mode.