Micrometer：如何创建关联执行结果/响应的带标签Timer指标

核心思路：延迟标签绑定，而非提前定义 #

Micrometer的Timer不需要在创建时就确定标签值，标签键可以提前固定，但标签值完全可以在任务执行完成后，根据结果动态绑定——这是解决你问题的核心逻辑。

方案1：Micrometer原生API手动实现 #

适合自定义任务或对RestTemplate做轻量封装的场景，步骤直接清晰：

1. 注入MeterRegistry #

在Spring Boot中直接注入框架自动配置的MeterRegistry：

@Autowired
private MeterRegistry meterRegistry;

2. 手动计时+动态绑定结果标签 #

以RestTemplate调用为例，在请求完成后（无论成功失败），根据响应状态码、执行结果设置标签：

public String callExternalApi(String url) {
    // 先启动计时采样
    Timer.Sample sample = Timer.start(meterRegistry);
    String resultTag = "success";
    int statusCode = 200;

    try {
        ResponseEntity<String> response = restTemplate.getForEntity(url, String.class);
        statusCode = response.getStatusCodeValue();
        // 根据状态码标记执行结果
        if (statusCode >= 400) {
            resultTag = "failure";
        }
        return response.getBody();
    } catch (Exception e) {
        resultTag = "error";
        statusCode = 500;
        throw e;
    } finally {
        // 停止采样并记录，同时传入动态标签
        sample.stop(Timer.builder("external.api.call.duration")
                .tag("result", resultTag)
                .tag("http_status", String.valueOf(statusCode))
                .register(meterRegistry));
    }
}

方案2：结合Spring Observation API（对齐Spring官方实现） #

Spring Boot 3+用Observation API统一处理观测、指标、日志，核心是通过上下文传递执行过程中的数据，自动绑定为指标标签：

1. 定义ObservationConvention（自定义标签规则） #

创建约定类，指定从上下文提取哪些数据作为标签：

public class ApiCallObservationConvention implements ObservationConvention<RestTemplateObservationContext> {
    @Override
    public String getName() {
        return "external.api.call";
    }

    @Override
    public Map<String, String> getLowCardinalityKeyValues(RestTemplateObservationContext context) {
        // 从上下文获取响应状态码，生成结果标签
        int statusCode = context.getResponse() != null ? context.getResponse().getStatusCodeValue() : 500;
        String result = (statusCode >= 200 && statusCode < 400) ? "success" : "failure";
        return Map.of(
                "http_status", String.valueOf(statusCode),
                "result", result
        );
    }
}

2. 注册自定义约定类 #

把它注册为Spring Bean，让框架自动识别：

@Bean
public ApiCallObservationConvention apiCallObservationConvention() {
    return new ApiCallObservationConvention();
}

3. 开启观测支持 #

Spring Boot的RestTemplate自动配置已集成Observation，只要引入spring-boot-starter-actuator和micrometer-core依赖，RestTemplate的所有调用都会自动生成带你自定义标签的Timer指标。

如果是自定义定时任务，也可以手动用Observation包裹任务逻辑：

@Autowired
private ObservationRegistry observationRegistry;

public void runDailySyncTask() {
    Observation.createNotStarted("daily.sync.task", observationRegistry)
            .lowCardinalityKeyValue("task_name", "data_sync")
            .observe(() -> {
                // 执行定时任务逻辑
                boolean taskSuccess = executeSyncLogic();
                // 将执行结果写入上下文，自动转为标签
                Observation.getCurrent().lowCardinalityKeyValue("result", taskSuccess ? "success" : "failure");
            });
}

关键原理说明 #

• Micrometer指标的标签键需要提前固定，但标签值可以在指标被使用时动态传入，不需要在创建Timer时就确定。
• Spring Observation API的核心是通过上下文传递执行过程中的数据，由ObservationConvention统一将上下文数据转化为指标标签，指标的创建由Spring自动配置在后台完成，无需手动调用MeterRegistry.register()。

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