Spring Boot升级后Observability指标标签配置生效不全问题咨询

变更背景 #

这是Spring Boot 3.x引入Micrometer Observation API后带来的配置迁移：全局指标标签的配置路径从management.metrics.tags改为management.observations.key-values。Observation API的核心是统一指标、链路追踪的上下文传递逻辑，让全局键值对能同时作用于指标标签和追踪日志。

为什么部分指标未带上新配置的标签？ #

• 旧配置management.metrics.tags是直接给Micrometer的MeterRegistry全局添加标签，所有通过MeterRegistry创建的指标都会自动继承。
• 新配置management.observations.key-values是给Observation上下文注入全局键值对，只有基于Observation API生成的指标才会自动把这些键值对转为标签。
• 未带上标签的指标，要么是Spring Boot内置的、还未完成Observation迁移的旧指标，要么是自定义指标仍在使用旧的MeterRegistry方式创建，没有接入Observation API。

解决方案 #

• 兼容旧指标：如果需要让所有指标都带上全局标签，可以同时保留management.metrics.tags和management.observations.key-values配置，直到所有指标都完成Observation迁移。
• 迁移自定义指标：把自定义指标的创建逻辑切换到Observation API，这样就能自动继承observations.key-values的全局标签，同时还能获得链路追踪的上下文支持。
• 版本适配：Spring Boot 3.x的后续小版本会逐步把内置指标迁移到Observation API，升级到对应版本后，内置指标会自动适配新配置。

配置示例 #

原Spring Boot 2.x及之前的配置：

management:
  metrics:
    tags:
      application: my-service

Spring Boot 3.x后的新配置：

management:
  observations:
    key-values:
      application: my-service

内容的提问来源于stack exchange，提问作者aweis