如何查看Vert.x HttpClient特定时刻的活跃HTTP连接数？

方法一：启用Vert.x Metrics（推荐） #

Vert.x原生支持Metrics能力，开启后可直接获取连接池的各项运行指标，包括活跃连接数、空闲连接数、等待队列长度等，是生产环境下的首选方案。

1. 开启Metrics配置
   在创建HttpClientOptions时添加Metrics启用配置（以Micrometer实现为例，也可适配其他Metrics框架）：

HttpClientOptions httpClientOptions = new HttpClientOptions()
        .setKeepAlive(KeepAlive)
        .setDefaultHost(baseUrl)
        .setTcpNoDelay(true)
        .setVerifyHost(verifyHost)
        .setTrustAll(trustAll)
        .setMaxPoolSize(50)
        .setPoolCleanerPeriod(POOL_CLEANER_PERIOD)
        .setDefaultPort(port)
        .setSsl(isSSl)
        .setMetricsOptions(new MicrometerMetricsOptions().setEnabled(true));

2. 获取并打印关键指标
   通过Metrics Registry可直接读取以下核心指标：

• vertx_http_client_connections_active：当前活跃连接数
• vertx_http_client_connections_idle：当前空闲连接数
• vertx_http_client_connections_pending：等待获取连接的请求数

在超时触发时打印这些指标，就能快速判断连接池是否处于耗尽状态。

方法二：直接读取连接池内部状态（仅用于临时调试） #

如果不想引入Metrics依赖，可通过Vert.x内部API直接获取连接池状态（注意：该方式依赖Vert.x内部实现，版本升级时可能需要调整代码）。

以Vert.x 4.x版本为例，代码示例如下：

import io.vertx.core.http.impl.VertxHttpClient;
import io.vertx.core.http.impl.pool.ConnectionPool;

// 假设你的HttpClient实例为httpClient
VertxHttpClient vertxHttpClient = (VertxHttpClient) httpClient;
ConnectionPool pool = vertxHttpClient.pool();

int activeConn = pool.active();
int idleConn = pool.idle();
int pendingReq = pool.pending();

// 打印连接池状态
System.out.printf("连接池状态：活跃连接=%d，空闲连接=%d，等待请求=%d，最大连接数=%d%n",
        activeConn, idleConn, pendingReq, httpClientOptions.getMaxPoolSize());

排查逻辑 #

• 若活跃连接数达到maxPoolSize且等待队列有请求堆积：说明连接池已耗尽，超时由连接不够用导致，可考虑调大maxPoolSize、优化请求复用逻辑，或排查服务端响应过慢导致连接无法释放的问题。
• 若活跃连接数远小于maxPoolSize：则超时大概率由服务端响应慢、网络故障等外部因素导致，需重点排查下游服务。

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