如何为Micrometer Timer发布SLO/百分位数分布指标？

要解决Spring Cloud Gateway指标无法添加百分位数和SLO桶的问题，核心是通过自定义MeterFilter干预Micrometer的指标统计配置——这也是应用内所有Timer、DistributionSummary类型指标的通用解决方案。

全局配置（所有Timer指标生效） #

创建配置类，注册自定义MeterFilter，为所有Timer类型指标统一设置百分位数和SLO桶：

import io.micrometer.core.instrument.Meter;
import io.micrometer.core.instrument.config.MeterFilter;
import io.micrometer.core.instrument.distribution.DistributionStatisticConfig;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import java.time.Duration;

@Configuration
public class MicrometerMetricsConfig {

    @Bean
    public MeterFilter customizeTimerDistribution() {
        return (id, config) -> {
            if (id.getType() == Meter.Type.TIMER) {
                return DistributionStatisticConfig.builder()
                        .percentiles(0.95, 0.99) // 指定需要的百分位数
                        .sla(
                            Duration.ofMillis(50).toNanos(),
                            Duration.ofMillis(100).toNanos(),
                            Duration.ofMillis(200).toNanos(),
                            Duration.ofMillis(300).toNanos(),
                            Duration.ofMillis(400).toNanos(),
                            Duration.ofMillis(500).toNanos()
                        ) // SLO桶，注意单位需转为纳秒
                        .build()
                        .merge(config); // 合并原有配置，保留默认统计项
            }
            return config;
        };
    }
}

仅针对Spring Cloud Gateway指标配置 #

如果只想给Gateway的gateway.requests指标单独配置，修改判断条件即可：

// 替换上述if判断逻辑
if (id.getType() == Meter.Type.TIMER && id.getName().equals("gateway.requests")) {
    // 同上配置内容
}

针对DistributionSummary指标的适配 #

如果要给DistributionSummary类型的指标配置（比如流量统计），只需调整类型判断和SLA单位：

if (id.getType() == Meter.Type.DISTRIBUTION_SUMMARY) {
    return DistributionStatisticConfig.builder()
            .percentiles(0.95, 0.99)
            .sla(1024, 2048, 4096) // 这里SLA用具体数值（比如字节数）
            .build()
            .merge(config);
}

关键说明 #

• 之所以用MeterFilter，是因为Spring Cloud Gateway启用metrics后，默认生成的gateway.requests等指标没有暴露直接的配置项，只能通过Micrometer的扩展机制调整。
• merge(config)必须保留，否则会覆盖Micrometer默认的统计配置（比如最大/最小值追踪）。
• SLO配置的单位要和指标的统计单位匹配：Timer用纳秒，DistributionSummary用指标本身的数值单位（如字节）。

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