sfudeus/powermeter_exporter Docker 镜像 - 轩辕镜像

powermeter_exporter

镜像概述和主要用途

powermeter_exporter是一款用于从可发送SML（Smart Message Language）数据的电子电力表（如通过红外设备连接）提取读数的工具，其核心功能是将电力表数据转换为Prometheus可抓取的指标格式，实现电力使用数据的监控集成。

核心功能和特性

• SML协议支持：解析电子电力表发送的SML格式数据
• Prometheus集成：提供HTTP端点供Prometheus抓取电力表读数指标
• 灵活配置：支持自定义监听端口、数据采集间隔、设备路径等参数
• 多表区分：通过名称标识实现多块电力表的独立监控
• 读数调整：可配置缩减因子对所有读数进行比例调整
• 调试与稳定性：提供调试模式及tty连接保持功能，确保数据采集稳定性

使用场景和适用范围

适用于需要对电力使用情况进行监控的场景，包括：

• 家庭或企业环境中通过红外设备读取传统电力表数据
• 需要将电力数据集成到Prometheus监控系统的场景
• 多块电力表并行监控与数据区分的应用场景
• 对电力读数进行实时采集与指标化的需求场景

使用方法和配置说明

基本用法

bash
powermeter_exporter [OPTIONS]

配置选项详解

应用选项

帮助选项

Docker部署示例

典型Docker运行命令（需根据实际设备路径和配置调整）：

bash
docker run -d \
  --name powermeter-exporter \
  --device=/dev/irmeter0:/dev/irmeter0 \  # 挂载红外设备
  -e EXPORTER_PORT=8080 \                 # 设置HTTP监听端口
  -e INTERVAL=30 \                        # 设置30秒采集间隔
  powermeter_exporter \
  --metername=main-meter \                # 标识为总电力表
  --factor=0.001 \                        # 读数缩减因子（如从Wh转为kWh）
  --keepalive                             # 保持tty连接以确保通信稳定

该示例将启动一个电力表数据导出器，每30秒从/dev/irmeter0设备读取数据，通过8080端口暴露指标，电力表名称设为"main-meter"，并将读数缩小1000倍（如将瓦时转换为千瓦时）。