如何为Micrometer Timer配置SLA与标签？

你的问题核心在于：你最初注册的Timer没有声明要使用的标签键，导致后续带标签的调用触发Micrometer自动生成了一个不带SLA配置的同名指标，而Prometheus要求同一指标名称的所有时间序列必须拥有完全相同的标签键集合，这就引发了冲突报错。

下面是具体的解决方法，确保你能同时配置SLA桶和标签，且符合Prometheus的要求：

1. 提前注册带标签键和SLA的Timer实例 #

首先，你需要在应用启动时（或者首次使用指标前）注册一个带有所有目标标签键和SLA配置的Timer，明确告诉Micrometer这个指标是绑定这些标签的：

// 全局预注册Timer，确保只初始化一次
private static final Timer REQUEST_DURATION_TIMER = Timer.builder("http.request.duration")
        .description("Duration in seconds for processing a request.")
        // 声明所有要使用的标签键，必须和后续使用的标签完全对应
        .tagKeys("http.method", "http.status", "java.class", "java.method")
        // 设置你的SLA桶（和原Prometheus Histogram一致，保留额外的5000ms桶）
        .sla(Duration.ofMillis(10), Duration.ofMillis(25), Duration.ofMillis(50),
             Duration.ofMillis(100), Duration.ofMillis(500), Duration.ofMillis(1000),
             Duration.ofMillis(5000))
        // 如果你用的是全局Metrics注册表，就用Metrics.globalRegistry；否则传入自定义registry
        .register(Metrics.globalRegistry);

2. 使用预注册的Timer记录指标 #

现在你可以直接复用这个预配置的Timer实例，传入具体的标签值来记录请求时长：

// 传入具体的标签值和时长（这里用纳秒转Duration，和你原代码的调用逻辑一致）
REQUEST_DURATION_TIMER.record(Duration.ofNanos(nanoseconds),
        Tags.of(
                "http.method", httpMethod,
                "http.status", httpStatus,
                "java.class", javaClass,
                "java.method", javaMethod
        ));

3. （可选）使用全局Metrics工具类调用 #

如果你习惯用Metrics.timer()的方式，只要确保在第一次调用前已经完成了上述预注册步骤，Micrometer就会自动匹配到带SLA和标签键的预配置实例，不会创建新的无配置指标：

// 前提：已经提前注册好带标签键和SLA的Timer
Metrics.timer("http.request.duration",
        "http.method", httpMethod,
        "http.status", httpStatus,
        "java.class", javaClass,
        "java.method", javaMethod)
        .record(Duration.ofNanos(nanoseconds));

关键注意事项 #

• 禁止混合无标签和带标签的同名指标：这是Prometheus的硬性要求，同一指标名的所有时间序列必须有完全相同的标签键集合，否则就会报错。
• SLA配置仅在注册时生效：Micrometer的Timer SLA是实例级配置，必须在注册时指定，后续获取的实例会继承这个配置，无法通过Metrics.timer()动态添加。
• 单位转换无需担心：你的原Prometheus Histogram用的是毫秒，而Micrometer Timer默认导出到Prometheus时用秒作为单位，但SLA桶的Duration配置会自动转换，最终生成的直方图桶和原逻辑一致。

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