OpenDTU项目中Prometheus监控指标变更解析

背景介绍

OpenDTU是一个开源的太阳能逆变器监控系统，它能够收集并展示光伏系统的运行数据。在v24.2.12版本更新后，系统对Prometheus监控指标的输出格式进行了重要调整，这导致部分用户在使用过程中遇到了数据获取方式的变化。

指标变更详情

在之前的版本中，OpenDTU会输出两种类型的Yield指标：按逆变器汇总的和按交流通道(AC)分类的。但在v24.2.12版本后，系统进行了以下主要变更：

1. 移除了按交流通道(AC)分类的Yield指标
2. 将所有Yield指标统一归类到逆变器(INV)部分
3. 不再提供全局的Yield总和指标

技术影响分析

这一变更主要影响的是多相逆变器系统的监控。在旧版本中，对于多相逆变器，Yield值实际上是无法按相单独计算的，因为逆变器本身只提供整体输出数据。新版本将指标统一归类到逆变器部分，更加符合实际硬件的数据输出特性。

解决方案

对于需要获取总Yield值的用户，可以通过以下方式调整查询语句：

1. 对于日发电量(YieldDay)： 旧查询：sum(opendtu_YieldDay{type="AC"}) 新查询：sum(opendtu_YieldDay{type="INV"})

2. 对于累计发电量(YieldTotal)： 旧查询：sum(opendtu_YieldTotal{type="AC"}) 新查询：sum(opendtu_YieldTotal{type="INV"})

最佳实践建议

1. 对于单逆变器系统，直接使用逆变器级别的指标即可
2. 对于多逆变器系统，使用sum函数对多个逆变器的指标进行汇总
3. 在仪表盘配置中，建议添加注释说明指标来源，便于后期维护
4. 定期检查OpenDTU的更新日志，了解可能的指标变更

总结

OpenDTU在v24.2.12版本中对Prometheus监控指标的调整是为了更准确地反映逆变器的实际数据输出特性。虽然这导致了部分用户需要调整他们的查询语句，但从长远来看，这种变更使得监控数据更加真实可靠。用户只需简单修改查询条件，即可继续获取所需的监控数据。