andrewjw/glowprom

glowprom

镜像概述

glowprom是一个用于接收来自Glowmarkt（glowmarkt.com）的燃气和电表数据，并将其转换为Prometheus可采集指标的工具。它通过MQTT协议获取数据，支持连接Glow云MQTT服务器或本地MQTT服务器，并根据连接方式提供不同的监控指标，便于用户通过Prometheus进行能源消耗数据的收集、分析和可视化。

核心功能与特性

• 数据采集：从Glowmarkt平台接收燃气和电表实时及历史数据
• 双MQTT模式支持：兼容Glow云MQTT服务器和本地MQTT服务器，两种模式下提供不同指标集
• Prometheus集成：将采集的能源数据转换为Prometheus兼容指标
• 灵活配置：支持通过命令行参数或环境变量进行配置
• 多维度指标：提供 consumption（消耗量）、meter（表计读数）、power（实时功率）等多类型指标

使用场景

适用于需要监控家庭或小型商业场所燃气和电力消耗的用户，特别适合已部署Glow IHD（智能显示设备）并希望通过Prometheus+Grafana构建能源监控系统的场景。可用于能源使用趋势分析、成本核算、异常消耗检测等需求。

使用方法与配置说明

命令行参数

Docker部署示例

基本运行命令（连接Glow云MQTT）

bash
docker run -d \
  --name glowprom \
  -p 8000:8000 \
  -e GLOWPROM_USER="your_glow_user" \
  -e GLOWPROM_PASSWD="your_glow_password" \
  andrewjw/glowprom

连接本地MQTT服务器

bash
docker run -d \
  --name glowprom \
  -p 8000:8000 \
  -e GLOWPROM_MQTT="mqtt://localhost:1883" \
  -e GLOWPROM_USER="local_mqtt_user" \
  -e GLOWPROM_PASSWD="local_mqtt_password" \
  andrewjw/glowprom

指标说明

Cloud MQTT模式指标

当连接Glow云MQTT服务器时，暴露以下指标：

# HELP consumption 给定周期内的消耗量
# TYPE consumption counter
glowprom_consumption{type="electricity",period="daily"} 4.761
glowprom_consumption{type="electricity",period="weekly"} 4.761
glowprom_consumption{type="electricity",period="monthly"} 61.483
glowprom_consumption{type="gas",period="daily"} 17.326
glowprom_consumption{type="gas",period="weekly"} 17.326
glowprom_consumption{type="gas",period="monthly"} 383.157

# HELP meter 表计读数
# TYPE meter counter
glowprom_meter{type="electricity"} 15255.87
glowprom_meter{type="gas"} 5995.276

Local MQTT模式指标

当连接本地MQTT服务器时，暴露更详细的指标：

# HELP glowprom_timestamp 最后一次更新的时间戳
# TYPE glowprom_timestamp counter
glowprom_timestamp{type="electric", mpan="your_mpan"} ***.0
glowprom_timestamp{type="gas", mprn="your_mprn"} ***.0

# HELP glowprom_export_cumulative_Wh 累计导出能量（Wh）
# TYPE glowprom_export_cumulative_Wh counter
glowprom_export_cumulative_Wh{type="electric", mpan="your_mpan"} 0.0

# HELP glowprom_import_cumulative_Wh 累计导入能量（Wh）
# TYPE glowprom_import_cumulative_Wh counter
glowprom_import_cumulative_Wh{type="electric", mpan="your_mpan"} ***.0
glowprom_import_cumulative_Wh{type="gas", mprn="your_mprn"} 66589570.00000001

# HELP glowprom_import_day_Wh 今日导入能量（Wh）
# TYPE glowprom_import_day_Wh gauge
glowprom_import_day_Wh{type="electric", mpan="your_mpan"} 4714.0
glowprom_import_day_Wh{type="gas", mprn="your_mprn"} ***.0

# HELP glowprom_import_week_Wh 本周导入能量（Wh）
# TYPE glowprom_import_week_Wh gauge
glowprom_import_week_Wh{type="electric", mpan="your_mpan"} 4714.0
glowprom_import_week_Wh{type="gas", mprn="your_mprn"} ***.0

# HELP glowprom_import_month_Wh 本月导入能量（Wh）
# TYPE glowprom_import_month_Wh gauge
glowprom_import_month_Wh{type="electric", mpan="your_mpan"} 61436.0
glowprom_import_month_Wh{type="gas", mprn="your_mprn"} 383157.0

# HELP glowprom_import_price 当前能源单价
# TYPE glowprom_import_price gauge
glowprom_import_price{type="electric", mpan="your_mpan"} 0.***
glowprom_import_price{type="gas", mprn="your_mprn"} 0.03623

# HELP glowprom_import_standing 能源固定费用
# TYPE glowprom_import_standing gauge
glowprom_import_standing{type="electric", mpan="your_mpan"} 0.***
glowprom_import_standing{type="gas", mprn="your_mprn"} 0.168

# HELP glowprom_power_W 当前功率（W）
# TYPE glowprom_power_W gauge
glowprom_power_W{type="electric", mpan="your_mpan"} 489.0

# HELP glowprom_import_cumulativevol_m3 累计燃气导入体积（m³）
# TYPE glowprom_import_cumulativevol_m3 counter
glowprom_import_cumulativevol_m3{type="gas", mprn="your_mprn"} 5995.276

# HELP glowprom_import_dayvol_Wh 今日燃气导入体积（Wh）
# TYPE glowprom_import_dayvol_Wh counter
glowprom_import_dayvol_Wh{type="gas", mprn="your_mprn"} ***.0

# HELP glowprom_import_weekvol_Wh 本周燃气导入体积（Wh）
# TYPE glowprom_import_weekvol_Wh counter
glowprom_import_weekvol_Wh{type="gas", mprn="your_mprn"} ***.0

# HELP glowprom_import_monthvol_Wh 本月燃气导入体积（Wh）
# TYPE glowprom_import_monthvol_Wh counter
glowprom_import_monthvol_Wh{type="gas", mprn="your_mprn"} 383157.0