3. 水位指标：连接池水位（活跃连接数、空闲连接数、等待队列深度）的数学定义与业务含义

连接池水位是衡量数据库连接池资源使用状态的核心指标集合，直接反映后端服务的数据库访问压力与健康程度。本章从数学定义与业务含义两个维度，对三个关键水位指标进行精确拆解。

3.1 指标全景与数学定义

连接池水位由三个基本量构成：活跃连接数（Active）、空闲连接数（Idle）、等待队列深度（Pending）。三者满足守恒关系：

总连接数 = Active + Idle
等待队列深度 = 当前等待获取连接的请求数

下表给出每个指标的数学符号、定义域及单位：

3.2 业务含义与水位解读

每个水位指标对应不同的业务场景与风险信号：

• 活跃连接数（A） —— 数据库实际负载的直接体现。
  • 正常范围：A < 0.7 × MaxTotal，表示连接池有充足余量。
  • 高水位：A > 0.85 × MaxTotal，需关注慢查询或长事务。
  • 满水位：A = MaxTotal，连接池耗尽，即将产生等待。
• 空闲连接数（I） —— 连接池资源冗余度。
  • 健康状态：I ≥ MinIdle，保证突发请求能快速获取连接。
  • 空闲堆积：I 持续接近 MaxIdle，说明连接池过大或业务请求不足。
  • 空闲枯竭：I = 0 且 A < MaxTotal，可能是连接泄漏或回收不及时。
• 等待队列深度（P） —— 连接池瓶颈的直接指标。
  • 零等待：P = 0，系统无排队。
  • 轻度排队：P > 0 且持续增长，表明连接池容量不足或数据库响应变慢。
  • 深度排队：P > 0.2 × MaxTotal，请求超时风险急剧上升，需立即扩容或优化。

3.3 水位关系与状态机

三个指标并非独立变化，而是遵循一个确定的状态转移过程。下图展示了连接池水位的核心状态机：

3.4 水位指标的计算与采样

在实际巡检中，水位指标通过连接池中间件暴露的 JMX 或 HTTP 端点获取。以 HikariCP 为例，其核心采样公式如下：

// HikariCP 连接池水位采样伪代码
class PoolWaterLevelSampler {
    // 活跃连接数 = 当前正在使用的连接数
    long activeConnections = pool.getActiveConnections();

    // 空闲连接数 = 池中可用连接数
    long idleConnections = pool.getIdleConnections();

    // 等待队列深度 = 等待获取连接的线程数
    long pendingThreads = pool.getThreadsAwaitingConnection();

    // 总连接数 = 活跃 + 空闲
    long totalConnections = activeConnections + idleConnections;

    // 水位利用率
    double utilizationRate = (double) activeConnections / pool.getMaximumPoolSize();
}

3.5 水位指标的业务关联分析

水位指标不能孤立看待，必须与业务指标联动分析才能准确定位根因：