3. 容量水位概念：容量、水位、阈值、预留量、利用率的核心定义与度量单位

在构建服务目录平台的容量水位巡检体系之前，必须统一对核心概念的定义。容量管理领域存在大量易混淆的术语，若定义不清晰，后续的 Rego 策略将无法准确表达巡检规则。本节将围绕五个核心概念——容量、水位、阈值、预留量和利用率，给出精确的工程定义及其度量单位。

3.1 核心概念定义与度量单位

3.2 概念关系与计算模型

五个概念之间存在严格的数学关系，理解这些关系是编写巡检策略的基础。核心公式如下：

利用率（%）= （水位 / 容量）× 100%

可用容量 = 容量 - 预留量

有效利用率（%）= （水位 / （容量 - 预留量））× 100%

告警条件：水位 ≥ 容量 × 阈值百分比

其中，有效利用率是实际巡检中更关键的指标，因为它扣除了预留量，反映了真正可被业务使用的资源压力。

3.3 容量水位概念关系图

下图展示了五个核心概念之间的逻辑关系与计算流向：

3.4 不同资源类型的度量差异

在实际的服务目录平台中，不同资源类型的容量水位度量方式存在差异，巡检策略需要针对性地适配：

3.5 水位巡检中的关键指标计算示例

以一个实际的服务目录平台场景为例，展示如何计算并判断容量水位状态：

// 输入数据（input）
{
  "resource_type": "cloud_disk",
  "capacity_gib": 500,
  "water_level_gib": 320,
  "reservation_gib": 25,
  "threshold_pct": 80
}

// Rego 策略计算
utilization := (input.water_level_gib / input.capacity_gib) * 100
// 结果: 64%

effective_capacity := input.capacity_gib - input.reservation_gib
// 结果: 475 GiB

effective_utilization := (input.water_level_gib / effective_capacity) * 100
// 结果: 67.37%

// 告警判定
violation := effective_utilization >= input.threshold_pct
// 结果: false (67.37% < 80%)

上述计算表明，虽然水位值（320 GiB）较高，但扣除预留量后的有效利用率（67.37%）仍在安全范围内，无需触发告警。这正是引入“预留量”概念的价值所在。

3.6 容量水位状态分类

基于上述概念，可以将资源状态划分为四个等级，便于巡检策略输出清晰的告警级别：

• 健康（Green）：有效利用率 < 安全阈值（如 70%），资源充裕，无需关注。
• 关注（Yellow）：有效利用率 ≥ 安全阈值但 < 告警阈值（如 70% ~ 80%），需纳入观察。
• 告警（Orange）：有效利用率 ≥ 告警阈值但 < 紧急阈值（如 80% ~ 90%），需触发告警并准备扩容。
• 紧急（Red）：有效利用率 ≥ 紧急阈值（如 90%），资源即将耗尽，需立即介入。