4. API监控指标体系：请求量、错误率、延迟（RED指标）、饱和度、自定义业务指标

在API弃用迁移过程中，监控体系是判断迁移是否成功、新API是否稳定、旧API是否可安全下线的核心依据。本章围绕RED指标（Rate、Errors、Duration）与饱和度、自定义业务指标，构建完整的API监控指标体系，确保迁移过程可观测、可量化、可告警。

4.1 RED指标：API可观测性的黄金三角

RED指标由Google SRE团队提出，是衡量微服务/API健康度的最小必要集合。在API弃用迁移场景中，RED指标用于对比新旧API的实时表现，验证新API是否达到或超越旧API的服务水平。

4.2 饱和度指标：容量与资源瓶颈

饱和度衡量API服务接近容量极限的程度。在弃用迁移中，新API可能因流量突增而达到资源瓶颈，旧API可能因流量减少而出现资源浪费。饱和度指标帮助SRE在迁移过程中动态调整资源分配。

• CPU饱和度：node_cpu_seconds_total → 使用率 > 80% 触发扩容
• 内存饱和度：node_memory_MemAvailable_bytes → 可用内存 < 20% 触发告警
• 连接池饱和度：api_connections_active / api_connections_max → 比例 > 0.8 需扩容
• 队列深度：api_queue_length → 持续增长表明处理能力不足

4.3 自定义业务指标：迁移成功的关键验证

RED指标和饱和度指标反映系统层面的健康度，但无法回答“业务是否正常”。自定义业务指标直接衡量API的业务价值，是迁移是否成功的最终判断依据。

4.4 指标体系架构图

下图展示了API弃用迁移过程中，从基础设施到业务层的完整监控指标体系，以及各指标之间的关联关系。

4.5 Prometheus指标采集与告警规则

以下是一组针对API弃用迁移场景的Prometheus告警规则示例，覆盖RED指标、饱和度和自定义业务指标。

groups:
  - name: api_migration_alerts
    rules:
      # RED指标告警
      - alert: NewAPIErrorRateHigh
        expr: |
          rate(new_api_errors_total[5m]) / rate(new_api_requests_total[5m]) >
          rate(old_api_errors_total[5m]) / rate(old_api_requests_total[5m]) * 1.1
        for: 5m
        labels:
          severity: critical
        annotations:
          summary: "新API错误率超过旧API的1.1倍"

      - alert: NewAPILatencyHigh
        expr: |
          histogram_quantile(0.99, rate(new_api_duration_seconds_bucket[5m])) >
          histogram_quantile(0.99, rate(old_api_duration_seconds_bucket[5m])) * 1.2
        for: 5m
        labels:
          severity: warning
        annotations:
          summary: "新API p99延迟超过旧API的1.2倍"

      # 饱和度告警
      - alert: NewAPICPUHigh
        expr: |
          avg by (pod) (rate(container_cpu_usage_seconds_total{container="new-api"}[5m])) > 0.8
        for: 3m
        labels:
          severity: warning
        annotations:
          summary: "新API CPU使用率超过80%"

      # 自定义业务指标告警
      - alert: RegistrationSuccessRateDrop
        expr: |
          rate(user_registration_success_total{api_version="v2"}[5m]) / rate(user_registration_total{api_version="v2"}[5m]) < 0.99
        for: 5m
        labels:
          severity: critical
        annotations:
          summary: "新API注册成功率低于99%"

4.6 迁移过程中的指标对比策略

在弃用迁移的不同阶段，监控指标的关注重点有所不同。下表总结了各阶段的指标对比策略：