OpenTelemetry Collector中SimplePrometheus接收器的标签配置问题解析

问题背景

在OpenTelemetry Collector的simpleprometheus接收器组件中，存在一个关于标签传递的配置问题。这个问题在v0.127.0版本中变得明显，但实际上在之前的版本中就已经存在，只是由于Prometheus接收器内部实现的变化才暴露出来。

问题现象

当用户通过simpleprometheus接收器配置额外的标签时，这些标签在v0.126.0版本中能够正确附加到采集的指标上，但在v0.127.0版本中却不再生效。具体表现为：

• 在v0.126.0版本中，指标会包含配置的自定义标签（如example_label: example_value）
• 在v0.127.0版本中，这些自定义标签不再出现在指标数据中

技术分析

问题的根源在于simpleprometheus接收器如何将标签传递给底层Prometheus接收器的配置方式不正确。

在simpleprometheus接收器的实现中，它创建了一个Prometheus的targetgroup结构体，其中包含两个字段：

• Targets：目标地址列表
• Labels：要附加的标签

问题出在当前的实现方式中，标签被错误地添加到了Targets字段中，而不是正确地放在Labels字段中。这种错误的配置方式在早期版本中"碰巧"能够工作，是因为Prometheus接收器内部处理逻辑较为宽松。

随着Prometheus接收器的升级（特别是Reload功能的引入），配置现在会经过更严格的YAML反序列化处理。Prometheus有自己的序列化函数实现，它只接受特定格式的标签（特别是特定类型的标签），导致自定义标签被过滤掉。

解决方案

正确的实现方式应该是：

1. 将目标地址放在Targets字段中
2. 将自定义标签放在Labels字段中

具体代码修改应该是将原来的：

Targets: []model.LabelSet{labels, {model.AddressLabel: model.LabelValue(cfg.Endpoint)}},

改为：

Targets: []model.LabelSet{{model.AddressLabel: model.LabelValue(cfg.Endpoint)}},
Labels:  labels,

这种修改符合Prometheus官方文档中static_config的配置规范，确保标签能够正确地传递给目标指标。

影响范围

这个问题影响所有使用simpleprometheus接收器并希望通过配置添加自定义标签的用户。虽然指标采集本身不会中断，但自定义标签将无法附加到指标上，可能导致监控数据缺乏必要的上下文信息。

最佳实践

对于需要使用simpleprometheus接收器的用户，建议：

1. 如果需要使用v0.127.0及以上版本，等待包含此修复的版本发布
2. 如果必须使用当前版本，可以考虑暂时降级到v0.126.0
3. 在配置中验证标签是否确实附加到了指标上

这个问题提醒我们，在集成不同监控系统时，需要仔细理解底层组件的配置规范和行为，而不仅仅是依赖表面上的功能实现。