能否借助Micrometer为Spring默认指标添加动态标签？

核心思路 #

Spring Boot 集成的Micrometer支持通过自定义标签提供者或全局Meter过滤器，从请求上下文（如请求头、当前用户、请求参数等）动态获取标签值，替代硬编码方式。以下是两种实用实现方案：

方案一：自定义WebMvcTagsProvider（Spring MVC场景） #

继承默认的WebMvcTagsProvider，重写标签生成逻辑，从请求上下文提取动态值并追加到默认HTTP指标标签中。

@Component
public class CustomWebMvcTagsProvider extends DefaultWebMvcTagsProvider {
    @Override
    public Iterable<Tag> getTags(HttpServletRequest request, HttpServletResponse response, Object handler, Throwable exception) {
        // 从Security上下文获取当前登录用户ID
        String userId = Optional.ofNullable(SecurityContextHolder.getContext().getAuthentication())
                .map(Authentication::getName)
                .orElse("anonymous");
        // 从请求头获取租户ID
        String tenantId = request.getHeader("X-Tenant-ID");
        // 合并默认标签与自定义动态标签
        return Tags.concat(super.getTags(request, response, handler, exception),
                Tag.of("user_id", userId),
                Tag.of("tenant_id", tenantId != null ? tenantId : "unknown")
        );
    }
}

Spring Boot会自动识别并使用这个自定义提供者，所有http.server.requests指标都会带上动态生成的user_id和tenant_id标签。

方案二：全局MeterFilter（通用场景） #

通过MeterFilter实现全局标签动态注入，可针对特定指标（如HTTP请求指标）添加标签，适合需要跨指标统一处理的场景。

@Configuration
public class DynamicMeterConfig {
    // 全局Meter过滤器
    @Bean
    public MeterFilter dynamicTagFilter() {
        return new MeterFilter() {
            @Override
            public Meter.Id map(Meter.Id id) {
                // 仅对HTTP请求指标添加动态标签
                if (id.getName().startsWith("http.server.requests")) {
                    String requestId = RequestContextHolder.getRequestId();
                    return id.withTags(Tag.of("request_id", requestId));
                }
                return id;
            }
        };
    }

    // 请求上下文拦截器，存储动态值到ThreadLocal
    @Component
    public static class RequestContextInterceptor implements HandlerInterceptor {
        private static final ThreadLocal<String> REQUEST_ID_HOLDER = new ThreadLocal<>();

        @Override
        public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) {
            // 从请求头取ID，无则生成UUID
            String requestId = request.getHeader("X-Request-ID");
            REQUEST_ID_HOLDER.set(requestId != null ? requestId : UUID.randomUUID().toString());
            return true;
        }

        @Override
        public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) {
            // 清理ThreadLocal，避免内存泄漏
            REQUEST_ID_HOLDER.remove();
        }

        public static String getRequestId() {
            return REQUEST_ID_HOLDER.get();
        }
    }

    // 注册拦截器
    @Autowired
    public void registerInterceptor(InterceptorRegistry registry) {
        registry.addInterceptor(new RequestContextInterceptor());
    }
}

注意事项 #

1. 线程安全：使用ThreadLocal存储上下文信息时，必须在请求结束后清理，防止内存泄漏；Spring WebFlux场景需改用Reactor Context传递值，避免ThreadLocal不适配异步模型。
2. 标签基数控制：避免添加高基数标签（如每个请求的唯一ID），否则会导致监控系统存储压力激增，这类追踪需求建议用分布式追踪工具（如Zipkin）而非指标标签。
3. WebFlux适配：WebFlux场景需替换为WebFluxTagsProvider，通过ServerWebExchange获取请求上下文。

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