iodeveloper/prom-apcupsd-exporter

Prometheus apcupsd导出器

https://img.shields.io/docker/automated/iodeveloper/prom-apcupsd-exporter.svg](https://hub.docker.com/repository/docker/iodeveloper/prom-apcupsd-exporter/) http://dockeri.co/image/iodeveloper/prom-apcupsd-exporter](https://registry.hub.docker.com/r/iodeveloper/prom-apcupsd-exporter)

iodeveloper/prom-apcupsd-exporter:latest

镜像概述

本镜像为Prometheus的apcupsd导出器，用于采集UPS设备的各项运行指标，并将其转换为Prometheus可识别的格式。同时支持通过websocket向客户端推送实时事件，还可与apccontrol信号集成，实现UPS状态变化的及时响应。

核心功能

1. 丰富监控指标：提供多维度UPS指标，包括输入输出线路、电池状态、UPS运行参数及关机设置等；
2. apccontrol集成：响应powerout、startselftest等apccontrol信号；
3. websocket实时通知：内置websocket服务器，向客户端广播状态变化与事件；
4. 事件计算：对比前后状态，推送变化字段与新事件至客户端。

使用场景

• 数据中心/小型机房UPS状态监控；
• 实时获取UPS状态变化（如断电、供电恢复）的场景；
• 与Grafana集成构建UPS监控仪表盘；
• 轻量级响应式状态展示（如Vue小部件）。

配置说明

前置条件

• UPS设备（如SUA1500i）通过串口（/dev/ttyS0）智能模式连接；
• apcupsd与导出器服务均以Docker容器运行。

Docker Compose示例

yml
version: '3.4'

services:
  apcupsd:
    build: .
    restart: always
    user: root
    devices:
      - "/dev/ttyS0:/dev/ttyS0"
    volumes:
      - ./conf:/etc/apcupsd
      - ./log/apcupsd.events:/var/log/apcupsd.events
      - ./log/apcupsd.trace:/apcupsd.trace
    ports:
      - "0.0.0.0:3559:3551"

  exporter:
    image: iodeveloper/prom-apcupsd-exporter:latest
    restart: always
    ports:
      - "0.0.0.0:3560:8001"
    command: [
      "--logLevel", "warn",
      "--apcupsd", "apcupsd:3551",
      "--apcupsdStartSkip", "20",
      "--collectInterval", "10",
      "--defaultModelState", '{"OutputPowerNominal": 900, "OutputPowerApparentNominal": 1500}'
    ]

apcupsd配置（./conf/apcupsd.conf）

ini
UPSCABLE smart 
UPSTYPE apcsmart
DEVICE /dev/ttyS0
POLLTIME 3

ONBATTERYDELAY 0
BATTERYLEVEL 0
MINUTES 0
TIMEOUT 0
KILLDELAY 0

NETSERVER on
NISPORT 3551

# 其他默认配置

apccontrol脚本修改（./conf/apccontrol）

sh
# ...
export SYSADMIN=root
export APCUPSD_MAIL="mail"
if [ -f $SCRIPTDIR/config ]; then . $SCRIPTDIR/config ; fi

# 向导出器发送信号
curl -X POST "http://exporter:8001/signal/$1"

# ...

辅助脚本配置

• doshutdown：创建关机标记文件；
• mainsback：恢复供电后重置关机状态并重启apcupsd。

sh
# doshutdown
#!/***/sh
touch /etc/apcupsd/shuttingdown
exit 99

# mainsback
#!/***/sh
if [ -f /etc/apcupsd/shuttingdown ]; then
    rm -f /etc/apcupsd/shuttingdown
    pid=$(ps aux | grep '/s***/apcupsd' | grep -v grep | awk '{print $2}')
    kill $pid
fi