4. 误差预算台账定义：Error Budget 在制品管理中的含义与台账数据结构设计
在代理缓存容量规划中，误差预算（Error Budget） 是连接制品可用性与缓存策略的核心量化指标。它衡量的是“在制品代理缓存未命中或服务降级被允许发生的最大累积时间或次数”。台账（Ledger）则是记录、追踪和审计该预算消耗与补充的持久化数据结构。
4.1 误差预算在制品管理中的含义
误差预算并非简单的“允许出错次数”，而是从制品消费方（如 CI/CD 流水线、开发者）的视角出发，定义缓存代理在特定时间窗口内可接受的“不完美服务”上限。其核心含义包括：
- 可用性承诺的逆向指标：若制品代理缓存承诺 99.9% 的命中率（或可用性），则误差预算为 0.1% 的总请求量或时间。每发生一次缓存穿透或回源失败，即消耗预算。
- 缓存策略调整的触发器：当预算消耗超过阈值（如 70%），系统应自动触发缓存预热、容量扩容或降级策略。
- 制品生命周期管理的锚点：不同制品（如稳定版、快照版、第三方镜像）拥有独立的误差预算，避免“一刀切”导致关键制品缓存被非关键制品挤占。
关键公式：
Error Budget = (1 - SLO) × Total Request Window
其中 SLO 为服务等级目标（如 0.999），Total Request Window 为评估周期内的总请求次数或总时间。
Error Budget = (1 - SLO) × Total Request Window
其中 SLO 为服务等级目标（如 0.999），Total Request Window 为评估周期内的总请求次数或总时间。
4.2 误差预算台账的数据结构设计
台账需要支持高并发写入（每次请求命中/未命中均需记录）、快速聚合查询（按分钟/小时/天粒度）以及持久化审计。推荐采用 时序 + 维度宽表 的混合结构，核心字段如下：
| 字段组 | 字段名 | 类型 | 说明 |
|---|---|---|---|
| 时间维度 | timestamp | DateTime (UTC) | 事件发生时间戳，精度到秒 |
| window_start | DateTime | 所属误差预算窗口起始时间（如每小时/每天） | |
| window_end | DateTime | 窗口结束时间 | |
| 制品维度 | artifact_key | String | 制品唯一标识（如 group:artifact:version） |
| artifact_type | Enum | RELEASE | SNAPSHOT | PROXY_CACHE | RAW | |
| repository_name | String | 所属 Nexus 仓库名称 | |
| 预算消耗 | total_requests | Long | 窗口内总请求次数 |
| miss_count | Long | 缓存未命中次数（回源或失败） | |
| error_count | Long | 服务错误次数（超时、5xx） | |
| budget_consumed | Float | 已消耗预算比例（0.0 ~ 1.0） | |
| 元数据 | source_ip | String | 请求来源（用于定位异常消费者） |
| extra_tags | Map<String,String> | 扩展标签（如 ci_job_id, branch） |
4.3 误差预算台账的写入与聚合流程
台账数据流需要兼顾实时性与存储成本。推荐采用 两级聚合 架构：
- 一级（实时计数器）：在 Nexus 代理缓存层使用 Redis 或内存原子计数器，按分钟粒度记录每个 artifact_key 的 miss_count 和 error_count。
- 二级（持久化台账）：每分钟将一级计数器快照写入时序数据库（如 InfluxDB 或 ClickHouse），并更新窗口聚合值。
- 预算计算：查询窗口内总请求数与消耗数，计算 budget_consumed = (miss_count + error_count) / total_requests。
设计建议： 对于 SNAPSHOT 制品，由于版本频繁更新，建议将误差预算窗口缩短至 15 分钟，并允许更高的预算消耗阈值（如 5%），避免因频繁回源导致缓存抖动。
4.4 误差预算台账的查询视图
为支撑容量规划决策，台账需提供以下典型查询模式：
- 按仓库聚合：显示每个仓库的当前预算消耗率，识别“预算饥饿”仓库。
- 按制品类型对比：比较 RELEASE 与 SNAPSHOT 制品的预算消耗趋势。
- 异常制品定位：查询 budget_consumed > 0.8 且 error_count > 0 的制品，标记为“缓存高危”。
- 时间序列分析：展示过去 7 天每小时预算消耗曲线，用于预测未来容量需求。
4.5 误差预算台账的存储与保留策略
考虑到数据量随制品数量线性增长，台账需制定合理的保留策略：
| 数据粒度 | 保留时长 | 存储引擎 | 用途 |
|---|---|---|---|
| 原始事件（秒级） | 24 小时 | Redis / 内存 | 实时告警与调试 |
| 分钟级聚合 | 7 天 | ClickHouse / InfluxDB | 短期趋势分析与容量调整 |
| 小时级聚合 | 90 天 | ClickHouse / 列式存储 | 中期容量规划与 SLO 审计 |
| 天级聚合 | 1 年 | 冷存储 / 对象存储 | 长期合规与容量预测模型训练 |
容量规划警示： 若台账查询显示某个仓库的误差预算在 1 小时内消耗超过 50%，且 miss_count 主要来自特定第三方代理缓存，应立即检查该代理的源站响应时间与带宽限制，避免因回源过载导致级联故障。