如何为Feign-Micrometer添加自定义name标签？

问题根源 #

之前的实现将自定义MicrometerCapability注册为全局Spring Bean，导致Micrometer会把该能力应用到所有指标的MeterRegistry中，进而给JVM、Kafka等非Feign指标也加上了自定义标签。

正确实现方案 #

核心思路是不为自定义MicrometerCapability注册全局Bean，而是针对每个Feign客户端单独配置，仅将该能力绑定到目标Feign客户端。

1. 编写自定义Feign专属的MicrometerCapability #

不要添加@Component或@Bean注解，避免全局注册：

public class FeignNameLabelCapability extends MicrometerCapability {
    private final String feignClientName;

    public FeignNameLabelCapability(String feignClientName) {
        this.feignClientName = feignClientName;
    }

    @Override
    public Meter.Id customizeMeterId(Meter.Id id) {
        // 仅对Feign的http_client_requests_seconds系列指标添加自定义标签
        if ("http_client_requests_seconds".equals(id.getName())) {
            return id.withTag("name", feignClientName);
        }
        // 其他指标直接返回原ID，不做修改
        return id;
    }
}

2. 为每个Feign客户端创建独立配置类 #

在配置类中手动创建Feign Builder，并注入自定义的Capability，指定对应@FeignClient的name值：

public class UserFeignClientConfig {
    @Bean
    public Feign.Builder feignBuilder() {
        return Feign.builder()
                // 这里的参数要和@FeignClient注解的name属性完全一致
                .addCapability(new FeignNameLabelCapability("user-service"));
    }
}

3. 绑定配置类到Feign客户端接口 #

在@FeignClient注解中指定对应的配置类：

@FeignClient(
        name = "user-service",
        url = "${user.service.url}",
        configuration = UserFeignClientConfig.class
)
public interface UserFeignClient {
    // 你的Feign接口方法
    @GetMapping("/users/{id}")
    UserDTO getUserById(@PathVariable("id") Long id);
}

关键说明 #

• 该方案仅对指定的Feign客户端生效，不会修改全局的MeterRegistry，因此JVM、Kafka、HikariCP等其他指标不会被添加自定义标签。
• 每个Feign客户端需要单独配置，确保FeignNameLabelCapability构造参数与@FeignClient的name属性一致，保证标签值准确。

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