Vert.x多httpClient实例如何添加专属标签实现分实例指标采集

Vert.x 完全支持为多个独立HttpClient实例配置专属标识、按实例拆分采集指标，你可以通过HttpClient配置项直接实现需求，无需二次开发自定义指标逻辑。

实现步骤 #

1. 基础配置（给每个HttpClient指定专属名称） #

你只需要在创建每个HttpClient实例时，通过HttpClientOptions的setMetricsName方法设置唯一的客户端标识即可，所有内置采集的HttpClient指标会自动带上对应名称作为标签：

// 对接订单服务的HttpClient实例
HttpClient orderClient = vertx.createHttpClient(new HttpClientOptions()
    .setMetricsName("order-service-client")
    .setDefaultHost("order.api.com")
    .setDefaultPort(443)
    .setSsl(true));

// 对接用户服务的HttpClient实例
HttpClient userClient = vertx.createHttpClient(new HttpClientOptions()
    .setMetricsName("user-service-client")
    .setDefaultHost("user.api.com")
    .setDefaultPort(443)
    .setSsl(true));

配置完成后，所有HttpClient相关指标（如vertx_http_client_requests_total请求总量、vertx_http_client_response_time_seconds响应耗时、vertx_http_client_errors_total错误量等）都会自动新增client标签，标签值就是你设置的metricsName值，直接通过该标签即可筛选不同实例的指标数据。

2. 自定义额外标签（可选） #

如果你需要为不同HttpClient补充更多业务专属标签（如业务域、环境标识等），可以通过MicrometerMetricsOptions配置全局的HttpClient标签生成规则：

// 配置全局指标规则
MicrometerMetricsOptions metricsOptions = new MicrometerMetricsOptions()
    .setEnabled(true)
    .addHttpClientTagsProvider(request -> {
        List<Tag> customTags = new ArrayList<>();
        // 按HttpClient的metricsName匹配添加业务标签
        String clientName = request.client().options().getMetricsName();
        if (clientName.startsWith("order")) {
            customTags.add(Tag.of("biz_domain", "order"));
        } else if (clientName.startsWith("user")) {
            customTags.add(Tag.of("biz_domain", "user"));
        }
        customTags.add(Tag.of("env", "production"));
        return customTags;
    });

// 初始化Vertx实例时加载指标配置
Vertx vertx = Vertx.vertx(new VertxOptions().setMetricsOptions(metricsOptions));

注意事项 #

• 该特性在Vert.x 3.9+、4.x所有稳定版本都原生支持，低版本需要先升级Vert.x核心依赖
• 如果你使用的是封装后的WebClient，配置逻辑完全一致，在WebClientOptions中设置metricsName即可生效
• 不要使用动态可变值作为标签内容（如请求ID、用户ID等），避免指标基数过高导致采集服务负载异常

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