atribe/apcupsd-influxdb-exporter

apcupsd-influxdb-exporter镜像说明

镜像概述

本镜像为Docker化的Python脚本，用于将apcupsd收集的APC UPS运行数据导出至https://hub.docker.com/_/influxdb%E6%95%B0%E6%8D%AE%E5%BA%93%EF%BC%8C%E6%96%B9%E4%BE%BF%E7%94%A8%E6%88%B7%E5%AF%B9UPS%E7%8A%B6%E6%80%81%E8%BF%9B%E8%A1%8C%E7%9B%91%E6%8E%A7%E5%92%8C%E6%95%B0%E6%8D%AE%E5%88%86%E6%9E%90%E3%80%82

核心功能

1. 从apcupsd服务提取UPS关键统计数据（如电量、负载、运行时间等）
2. 将数据格式化后发送至InfluxDB存储
3. 支持通过环境变量自定义配置参数（如数据发送间隔、数据库连接信息等）
4. 提供调试模式（VERBOSE参数）便于排查问题

使用场景

• 服务器机房UPS状态实时监控
• 家庭NAS或小型机房的UPS运行数据收集
• 需要对UPS性能进行长期分析的场景

配置说明

以下为可用的环境变量及说明：

部署示例

直接运行Docker容器

bash
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" \
    -t atribe/apcupsd-influxdb-exporter

注意：若UPS不包含NOMPOWER指标，需设置WATTS环境变量以计算实时功率消耗。

使用Docker Compose部署

yaml
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
      INTERVAL: 5

若需调试apcaccess输出或数据发送过程，可设置环境变量VERBOSE=true。