tommetge / apcupsd-influxdb-exporter

Docker-based APCUPSd daemon that sends UPS-device information to InfluxDB.

apcupsd-influxdb-exporter

Dockerized Python script that will send data from apcupsd to influxdb.

How to build

Building the image is straight forward:

• Git clone this repo
• docker build -t apcupsd-influxdb-exporter .

Environment Variables

These are all the available environment variables, along with some example values, and a description.

Environment Varialbe	Example Value	Description
APCUPSD_HOST	192.168.1.100	host running apcupsd, defaults to the value of influxdb_host
INFLUXDB_HOST	192.168.1.101	host running influxdb
INFLUXDB_PORT	8086	optional, defaults to 8086
INFLUXDB_BUCKET	apcupsd	bucket name for influxdb. optional, defaults to apcupsd
INFLUXDB_ORG	org	org name for influxdb
INFLUXDB_TOKEN	token	access token for influxdb
INTERVAL	10	interval (in seconds) to run the exporter. optional, defaults to 10 seconds
WATTS	1000	if your ups doesn't have NOMPOWER, set this to be the rated max power, if you do have NOMPOWER, don't set this variable
HOSTNAME	unraid	host you want to show up in influxdb. Optional, defaults to apcupsd hostname value
VERBOSE	true	if anything but true docker logging will show no output. Optional, defaults to false

How to Use

Run docker container directly

docker run --rm  -d --name="apcupsd-influxdb-exporter" \
    -e "WATTS=600" \
    -e "INFLUXDB_HOST=10.0.1.11" \
    -e "APCUPSD_HOST=10.0.1.11" \
    -e "INFLUXDB_ORG=MyOrg" \
    -e "INFLUXDB_TOKEN=mysecrettoken" \
    -t atribe/apcupsd-influxdb-exporter

Note: if your UPS does not include the NOMPOWER metric, you will need to include the WATTS environment variable in order to compute the live-power consumption metric.

Run from docker-compose

version: '3'
services:
  apcupsd-influxdb-exporter:
    image: atribe/apcupsd-influxdb-exporter
    container_name: apcupsd-influxdb-exporter
    restart: always
    environment:
      WATTS: 1000
      APCUPSD_HOST: 10.0.1.11
      INFLUXDB_HOST: 10.0.1.11
      INFLUXDB_ORG: MyOrg
      INFLUXDB_TOKEN: mysecrettoken
      INTERVAL: 5

If you want to debug the apcaccess output or the send to influxdb, set the environment variable "VERBOSE" to "true"