📚 课程目录第3章连接池水位模型

3. 连接池水位模型：低水位、高水位、警戒水位、溢出水位定义与业务含义

连接池水位模型借鉴了水库或蓄水池的水位管理思想，将连接池中的连接数量变化抽象为四个关键水位线。每个水位线对应不同的资源状态和业务影响，是设置监控阈值与告警策略的基础。

下图展示了连接池水位模型的完整结构，包含四个水位线及其对应的连接池状态区域：

水位名称	定义	阈值参考	业务含义
低水位	连接池中活跃连接数低于该值时，表示连接资源处于闲置状态	maxActive × 20% ~ 30%	业务低峰期或连接池配置过大；存在资源浪费，可考虑缩容
高水位	连接池中活跃连接数达到该值时，表示连接复用率较高，接近满载	maxActive × 70% ~ 80%	业务正常高峰期；需关注连接获取耗时是否开始上升
警戒水位	连接池中活跃连接数超过该值时，连接获取延迟明显增加，系统进入高负载状态	maxActive × 85% ~ 90%	业务接近极限；需要立即排查慢查询或连接泄漏，准备扩容
溢出水位	连接池中活跃连接数达到 maxActive，新请求无法获取连接，触发等待或拒绝	maxActive（100%）	业务过载或连接泄漏；请求排队超时或直接失败，影响可用性

  关键原则：水位阈值不是固定值，需要根据业务流量特征、数据库处理能力、连接获取耗时等指标动态调整。建议以高水位作为日常监控基线，警戒水位作为告警触发线。

连接池在不同水位区间表现出不同的行为特征，理解这些行为有助于精准设置告警规则：

低水位区（空闲区）：连接池中大部分连接处于空闲状态。连接获取几乎无等待，但存在资源浪费。此时应关注 idleTimeout 配置是否合理，避免空闲连接长期占用数据库资源。
正常区（高水位以下）：连接复用率良好，获取连接的平均耗时在可接受范围内（通常 < 5ms）。系统处于健康运行状态。
警戒区（高水位~警戒水位）：连接获取开始出现排队现象，平均获取耗时上升至 10ms~50ms。数据库 CPU 和 IO 负载升高，需要排查是否存在慢查询或突发流量。
溢出区（警戒水位~maxActive）：连接池接近或达到上限。新请求进入等待队列，若超过 maxWait 时间则抛出异常。此时业务响应时间急剧恶化，需要立即介入处理。

水位线的设置与连接池核心参数紧密相关，下表展示了参数调整对水位的影响：

连接池参数	参数说明	对水位的影响
`maxActive`	最大活跃连接数	决定所有水位的上限值，溢出水位固定为 maxActive
`minIdle`	最小空闲连接数	影响低水位的基准值，通常低水位应 ≥ minIdle
`maxWait`	获取连接的最大等待时间	溢出区内的等待时长上限，超过则抛出异常
`timeBetweenEvictionRunsMillis`	空闲连接回收检测间隔	影响低水位区空闲连接的释放速度
`testOnBorrow`	获取连接时是否校验有效性	在高水位和警戒区，开启此参数会增加获取延迟

基于水位模型，推荐设置以下监控指标和告警规则：

推荐监控指标：

告警分级建议：

以一个典型的电商系统订单服务为例，连接池配置为 maxActive=50，各水位线设置如下：

某次大促期间，监控系统发现活跃连接数持续在 42~45 之间（警戒区），连接获取平均耗时从平时的 2ms 上升到 25ms。SRE 团队根据水位模型判断系统处于高负载状态，立即执行了以下操作：

这个案例说明，水位模型不仅用于监控告警，还能指导 SRE 在故障发生时快速定位问题并采取针对性措施。