Spring Boot Micrometer启用Percentiles Histogram配置报错求正确示例

错误原因 #

你遇到的启动失败问题，是因为management.metrics.distribution.percentiles-histogram的配置类型为Map<String, Boolean>，不能直接赋值为布尔值true。该配置项需要针对特定指标ID（或用通配符*全局生效）来开启直方图功能。

正确配置示例 #

1. 全局启用所有指标的Percentiles Histogram #

适用于需要对所有Micrometer指标开启直方图的场景：

logging:
  level:
    root: DEBUG
management:
  tracing:
    enabled: false
  endpoint:
    prometheus:
      enabled: true
    health:
      enabled: true
  endpoints:
    web:
      exposure:
        include: health, prometheus
  metrics:
    distribution:
      percentiles-histogram:
        "*": true

2. 仅针对HTTP请求响应时间开启（常用场景） #

如果只需监控Spring Boot的HTTP接口响应时间，只需对http.server.requests这个核心指标开启：

logging:
  level:
    root: DEBUG
management:
  tracing:
    enabled: false
  endpoint:
    prometheus:
      enabled: true
    health:
      enabled: true
  endpoints:
    web:
      exposure:
        include: health, prometheus
  metrics:
    distribution:
      percentiles-histogram:
        http.server.requests: true

验证配置生效 #

应用启动成功后，访问/actuator/prometheus端点，查看是否存在类似http_server_requests_bucket的指标（带le标签的直方图分桶数据），若存在则说明配置生效。

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