3. 水位监控指标：活跃连接数、等待队列长度、连接获取等待时间、连接超时次数、连接创建/销毁速率

连接池的水位监控是SLA告警阈值设计的核心数据基础。只有对池内状态进行多维度、高频率的量化采集，才能准确判断池的健康度并触发合理的告警。本章详细拆解5项关键水位指标的定义、采集方式、典型异常模式及其在阈值设计中的用途。

3.1 指标全景与数据采集维度

下表汇总了5项核心指标的数据类型、采集粒度与典型监控工具支持情况，便于你在设计监控方案时快速对照选型。

3.2 活跃连接数（Active Connections）

活跃连接数表示当前正在被业务线程持有并执行数据库操作的连接数量。它是连接池负载最直接的体现，也是水位告警的首选指标。

• 正常范围：通常维持在最大连接数的40%~70%之间，波动平缓。
• 异常模式：持续接近或达到最大连接数（如95%以上），表明池容量不足或存在连接泄漏。
• 阈值设计用途：作为高水位告警的主触发条件，通常与最大连接数绑定（如活跃连接数 > 最大连接数 × 80% 持续30秒）。

3.3 等待队列长度（Pending Queue Depth）

等待队列长度表示当前正在排队等待获取连接的线程数量。当活跃连接数达到上限且所有连接均被占用时，新请求会进入等待队列。

• 正常范围：理想情况下为0，偶发瞬时值不超过1~2。
• 异常模式：队列长度持续大于0且呈上升趋势，说明连接池已饱和，请求开始堆积。
• 阈值设计用途：作为紧急告警的辅助条件。当等待队列长度 > 0 且持续超过5秒时，应触发告警；若队列长度 > 最大连接数 × 10%，则需立即介入。

3.4 连接获取等待时间（Connection Acquire Wait Time）

该指标衡量一个线程从请求连接到成功获取连接所花费的时间，通常以毫秒为单位。它反映了连接池的响应速度与争用程度。

在阈值设计中，通常使用P99分位值作为告警依据，而非平均值。例如：P99连接获取等待时间 > 100ms 持续1分钟，触发告警。

3.5 连接超时次数（Connection Timeout Count）

连接超时次数是累计计数器，记录在指定时间窗口内因等待超时而未能获取连接的请求数量。它是连接池故障最严重的信号之一。

• 正常范围：0次/分钟。
• 异常模式：任何非零的超时次数都代表有请求被拒绝，直接影响业务成功率。
• 阈值设计用途：作为P0级告警的触发条件。建议设置：连续2个采集周期内超时次数 > 0，立即触发告警。

3.6 连接创建/销毁速率（Connection Create/Destroy Rate）

该指标反映连接池在单位时间内创建和销毁连接的频率。高创建速率通常意味着连接池在频繁伸缩，可能由突发流量或连接泄漏导致；高销毁速率则可能由空闲超时回收或网络抖动引起。

在阈值设计中，建议将创建速率与销毁速率的比值作为稳定性指标。若创建速率 / 销毁速率 > 2 且持续超过30秒，说明池处于不稳定扩张状态，应触发告警。

3.7 指标关联关系与联合监控策略

5项指标并非孤立存在，它们之间存在明确的因果链。理解这些关联关系有助于设计更精准的告警规则，避免误报与漏报。

上图展示了5项指标之间的驱动关系：活跃连接数升高导致等待队列增长，队列增长进一步推高连接获取等待时间，等待时间超过阈值则引发连接超时，而频繁的超时与重建又会加剧创建/销毁速率的波动。在设计告警规则时，建议采用因果链告警策略：当上游指标（如活跃连接数）触发告警时，自动关联下游指标（如等待队列长度）进行二次确认，减少误报。

3.8 指标采集代码示例（HikariCP + Micrometer）

以下代码展示了如何在Spring Boot应用中通过Micrometer暴露HikariCP连接池的5项水位指标，便于Prometheus拉取。

// application.yml 配置
spring:
  datasource:
    hikari:
      pool-name: MyPool
      maximum-pool-size: 50
      minimum-idle: 10
      connection-timeout: 30000
      idle-timeout: 600000
      max-lifetime: 1800000

// 指标暴露（自动通过Micrometer注册）
// 无需额外代码，Spring Boot Actuator + Micrometer会自动采集：
// - hikaricp_connections_active（活跃连接数）
// - hikaricp_connections_pending（等待队列长度）
// - hikaricp_connections_acquire_seconds（连接获取等待时间）
// - hikaricp_connections_timeout_total（连接超时次数）
// - hikaricp_connections_creation_seconds（连接创建耗时，可推算速率）

// 自定义告警规则示例（Prometheus Alertmanager）
groups:
  - name: connection_pool_alerts
    rules:
      - alert: HighActiveConnections
        expr: hikaricp_connections_active / hikaricp_connections_max > 0.8
        for: 30s
        labels:
          severity: warning
        annotations:
          summary: "连接池活跃连接数超过80%"

      - alert: ConnectionTimeoutOccurred
        expr: rate(hikaricp_connections_timeout_total[1m]) > 0
        for: 10s
        labels:
          severity: critical
        annotations:
          summary: "连接超时次数大于0，请立即排查"