sfudeus/isg_exporter

isg_exporter

概述

isg_exporter是一个从Stiebel Eltron热泵（如LWZ 404）的互联网服务网关(ISG)提取相关状态数据，并以Prometheus指标形式提供的工具。该工具使用Go编写，以单二进制文件形式提供，可监听自定义端口，通过周期性抓取ISG Web界面获取数据，并支持通过命令行参数或环境变量配置访问凭据。

核心功能与特性

• 灵活配置：支持通过命令行参数或环境变量配置监听端口、数据采集间隔、ISG访问信息等
• 周期性数据采集：可自定义采集间隔（默认60秒）
• 凭据安全：支持配置ISG的URL、用户名和密码
• 数据过滤：可选择跳过回路2的数据以减少指标数量
• 调试模式：提供调试选项便于问题排查
• 多输出格式：除Prometheus指标外，还提供RESTful /status端点返回JSON格式数据

使用场景

适用于需要监控Stiebel Eltron热泵ISG状态数据的场景，可集成到Prometheus监控系统中，实现对热泵运行状态（如压缩机运行状态、供水温度、系统状态等）的持续监控和告警。

使用方法与配置说明

命令行参数与环境变量

Docker部署示例

bash
docker run -d \
  --name isg_exporter \
  -p 8080:8080 \
  -e EXPORTER_PORT=8080 \
  -e INTERVAL=60 \
  -e ISG_URL="http://your-isg-ip" \
  -e ISG_USER="admin" \
  -e ISG_PASSWORD="your-password" \
  -e SKIP_CIRCUIT_2=true \
  isg_exporter:latest

docker-compose配置示例

yaml
version: '3'
services:
  isg_exporter:
    image: isg_exporter:latest
    ports:
      - "8080:8080"
    environment:
      - EXPORTER_PORT=8080
      - INTERVAL=60
      - ISG_URL=http://your-isg-ip
      - ISG_USER=admin
      - ISG_PASSWORD=your-password
      - SKIP_CIRCUIT_2=true
    restart: unless-stopped

指标说明

指标命名规则

指标名称基于ISG配置的语言并进行规范化处理。例如，德语环境下的指标名称可能包括：

• isg_verdichter_ww（热水器压缩机）
• isg_verdichter_heizen（供暖压缩机）
• isg_vorlauftemp（供水温度）

指标类型

• 数值型指标：表示具体测量值（如温度、压力等）
• 标志型指标：表示状态（0表示关闭/正常，1表示运行/需要注意），例如：
  • isg_flag_heizkreispumpe（供暖循环泵状态）
  • isg_flag_schaltprogramm_aktiv（控制程序激活状态）
  • isg_flag_status_ok（系统状态正常）

数据过滤

通过--skipCircuit2参数（或SKIP_CIRCUIT_2环境变量）可跳过回路2的数据，减少指标数量。

RESTful状态端点

提供/status端点，返回JSON格式的所有采集数据，便于其他系统集成或调试。

Systemd服务配置

如需将isg_exporter作为系统服务运行，可使用资源目录中的resources/systemd单元文件。该配置假设单二进制文件安装在/usr/local/bin，环境变量配置在/etc/default/isg_exporter文件中。