连接池水位模型：容量模型与核心指标

连接池水位模型是设计 SLA 告警阈值的基础。只有准确理解连接池的容量模型、最小连接数、最大连接数、空闲连接数、活跃连接数这五个核心维度的关系，才能将“水位”量化为可监控、可告警的指标。本节从容量模型出发，逐一拆解每个参数的定义、作用及水位含义。

2.1 连接池容量模型

连接池本质上是一个受控的共享资源池，其容量模型可以用“水库-管道”类比：连接池如同一个水库，上游是应用线程（取水者），下游是数据库（水源）。水库的容量由最大连接数决定，而最小连接数则是保证基础供水的水位线。活跃连接数是当前正在出水的管道数，空闲连接数是待命的备用管道。

容量模型的核心公式：

总连接数 = 活跃连接数 + 空闲连接数
水位百分比 = (活跃连接数 / 最大连接数) × 100%
空闲率 = (空闲连接数 / 总连接数) × 100%

2.2 核心参数详解

2.3 水位状态与转换关系

连接池中的连接在生命周期内会在不同状态间转换。理解状态转换是设计告警阈值的前提：

• 创建（Create）： 当总连接数 < 最大连接数且无空闲连接可用时，连接池创建新连接。
• 借用（Borrow）： 线程从空闲队列中获取一个空闲连接，该连接变为活跃状态。
• 归还（Return）： 线程使用完毕，将活跃连接归还池中，变为空闲状态。
• 销毁（Destroy）： 空闲连接超过空闲超时时间或总连接数超过最小连接数太多时，连接被销毁。
• 阻塞（Block）： 当总连接数达到最大连接数且所有连接均活跃时，新请求线程阻塞等待。

2.4 水位模型的关键指标矩阵

在实际监控中，需要将上述参数组合成可操作的指标矩阵，用于判断连接池的健康状态：

2.5 水位模型与 SLA 告警的映射关系

将水位模型映射到 SLA 告警阈值时，需要遵循以下原则：

1. 分层告警： 水位百分比设置 3 级阈值（警告、严重、紧急），对应不同的 SLA 响应时间。
2. 组合条件： 单一指标触发可能只是毛刺，组合条件（水位 > 80% 且等待时间 > 50ms）才真正触发告警。
3. 动态基线： 水位模型应参考业务高峰期的历史基线，而非固定值。例如，大促期间水位 85% 可能正常，平时 70% 就需关注。
4. 预留缓冲： 最大连接数不要用满，预留 10% ~ 20% 的缓冲给突发流量和管理操作。