vrelk/apcupsd-influxdb-exporter

apcupsd-influxdb-exporter

构建兼容x86_64或ARM架构的Docker镜像，通过内置的APCUPSd工具将常用UPS设备统计数据输出到InfluxDB数据库。包含适用于Intel和ARM（如树莓派）芯片组的Dockerfile。

构建方法

构建镜像步骤简单：

• 克隆本仓库
• 执行 docker build -t bgulla/apcupsd-influxdb-exporter .

环境变量

以下是所有可用的环境变量，包含示例值和描述：

使用方法

前置条件

该Docker镜像假设你已运行apcupsd实例。若需通过Docker部署apcupsd，执行以下命令：

bash
docker run -ti --rm \
    --name="apcupsd-tcp" \
    -p 3551:3551 \
    --privileged \
    bgulla/apcupsd-tcp

直接运行Docker容器

bash
docker run --rm -d --name="apcupsd-influxdb-exporter" \
    -e "WATTS=600" \
    -e "HOSTNAME=unraid" \
    -e "INFLUXDB_HOST=10.0.1.11" \
    -e "APCUPSD_HOST=10.0.1.11" \
    -t bgulla/apcupsd-influxdb-exporter

注意：如果你的UPS不包含NOMPOWER指标，需设置WATTS环境变量以计算实时功耗。

通过Docker Compose运行

yaml
version: '3'
services:
  apcupsd-influxdb-exporter:
    image: bgulla/apcupsd-influxdb-exporter
    container_name: apcupsd-influxdb-exporter
    restart: always
    environment:
      WATTS: 1500
      APCUPSD_HOST: 10.0.1.11
      INFLUXDB_HOST: 10.0.1.11
      HOSTNAME: unraid

若需调试apcaccess输出或发送到InfluxDB的过程，将环境变量"VERBOSE"设置为"true"。

Kubernetes部署

yaml
apiVersion: apps/v1beta2
kind: Deployment
metadata:
  name: ups-apcupsd-tcp
  namespace: default
spec:
  selector:
    matchLabels:
      app: ups-monitor
  template:
    metadata:
      labels:
        app: ups-monitor
    spec:
      containers:
      - image: bgulla/apcupsd-tcp
        imagePullPolicy: Always
        name: ups-apcupsd-tcp
        ports:
        - containerPort: 3551
          name: 3551tcp02
          protocol: TCP
        resources: {}
        securityContext:
          capabilities: {}
          privileged: true
      - env:
        - name: APCUPSD_HOST
          value: localhost
        - name: INFLUXDB_DATABASE
          value: power
        - name: INFLUXDB_HOST
          value: influxdb-homelab.influxdb.svc.cluster.local # 路由到InfluxDB的服务（默认端口8086）
        - name: UPS_ALIAS
          value: addl_servers
        - name: VERBOSE
          value: "true"
        image: bgulla/apcupsd-influxdb-exporter
        imagePullPolicy: Always
        name: apcupsd-influx-exporter
      dnsPolicy: ClusterFirst
      nodeName: node01		# UPS连接的节点
      restartPolicy: Always