Spring Boot management.metrics.distribution.percentiles配置技术问询

1. 除"all"外的常见Key，以及HTTP服务器请求专属配置 #

• 除了all（对所有指标全局生效），常见的key是具体的meter名称或名称匹配模式。针对HTTP服务器请求的http.server.requests就是典型的专属key，完全可以单独给它设置分位数，示例配置：

management.metrics.distribution.percentiles:
  http.server.requests: 0.5, 0.9, 0.99

• 其他常见key还包括jvm.memory.used（JVM已用内存）、system.cpu.usage（系统CPU使用率）、jdbc.connections.active（活跃JDBC连接数）这类对应不同监控指标的meter名称。

2. 查询可用Key的渠道 #

• 查看应用的Actuator Metrics端点：启动应用后访问/actuator/metrics（需提前开启Actuator组件），返回的列表里包含了当前应用所有可用的meter名称，这些都可以作为配置的key
• 查看Spring Boot自动配置类：比如WebMvcMetricsAutoConfiguration、JvmMetricsAutoConfiguration这类自动配置类中，会定义对应指标的meter名称常量
• 查看Micrometer核心源码：Micrometer是Spring Boot metrics的底层实现，其核心包io.micrometer.core.instrument下的各类MeterRegistry实现类、内置指标类里，会明确默认生成的meter名称

3. 自定义配置Key的方法 #

• 自定义meter名称：在业务代码中手动创建监控指标时指定名称，比如用MeterRegistry.timer("custom.api.requests").record(...)，之后就可以用custom.api.requests作为key配置分位数
• 使用通配符匹配：如果需要批量匹配一类指标，可以用*通配符，比如http.server.requests.*匹配所有HTTP请求相关指标，或者更精准的http.server.requests{uri=/user/**}匹配特定URI的请求（语法遵循Micrometer的tag匹配规则）
• 扩展指标生成逻辑：通过自定义MeterFilter或者自定义MetricsProperties绑定规则，修改或新增符合业务需求的meter名称，以此作为配置的自定义key

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