3. 资源配额概述：etcd 资源配额（quota）机制、默认值、配额耗尽的影响
3.1 为什么需要资源配额？
etcd 作为 Kubernetes 等分布式系统的关键元数据存储，其数据平面必须受到保护。如果没有配额限制，单个异常客户端或失控的控制器可以持续写入大量数据，导致 etcd 存储空间膨胀、性能下降甚至 OOM。资源配额（quota）是 etcd 内置的存储容量上限机制，用于防止数据无限增长，保障集群的稳定性和可预测性。
核心原则：配额不是性能优化工具，而是 安全边界。在配额耗尽之前，性能调优措施（如 backup 缓存命中优化）才有意义。
3.2 配额机制工作原理
etcd 使用基于 MVCC（多版本并发控制） 的存储引擎，所有历史版本数据都保留在 boltdb 中。配额限制的是整个 etcd 数据目录（包括 wal 日志和快照）的总大小。当写入操作导致总大小超过配额阈值时，etcd 会拒绝后续写入，并返回 etcdserver: mvcc: database space exceeded 错误。
3.3 默认配额值
不同版本的 etcd 默认配额值有所差异，生产环境建议根据集群规模和数据量显式设置。
| etcd 版本 | 默认配额值 | 说明 |
|---|---|---|
| v3.2 及更早 | 2 GB | 早期版本默认值较小，容易触发配额告警 |
| v3.3 - v3.4 | 8 GB | 社区反馈后提升，适用于中等规模集群 |
| v3.5+ | 8 GB | 保持 8 GB，推荐根据实际数据量调整 |
生产建议：对于 Kubernetes 控制面集群，推荐将配额设置为 16 GB 或 32 GB，具体取决于节点数和资源对象数量。使用
--quota-backend-bytes 启动参数或环境变量 ETCD_QUOTA_BACKEND_BYTES 配置。
3.4 配额耗尽的影响
当 etcd 配额耗尽时，影响是全局且严重的，不仅限于写入失败。
- 写入完全拒绝：所有 PUT、DELETE、TXN 操作返回
ErrSpaceExceeded，集群进入只读模式。 - 租约续期失败：Leader 选举、Pod 心跳等依赖租约的机制中断，可能导致服务不可用。
- Watch 流中断：部分 etcd 版本在配额耗尽时 Watch 连接可能异常断开，客户端需要重连。
- 备份失效：etcd 快照（snapshot）可能无法正常创建，影响 backup 缓存的数据源。
- 性能雪崩：持续的写入重试和错误日志会消耗 CPU 和内存，进一步恶化集群状态。
⚠️ 关键风险：配额耗尽后，即使删除部分数据（如删除大量 Pod），etcd 也不会自动释放磁盘空间（因为 MVCC 历史版本仍保留）。必须手动执行 压缩（compact） 和 碎片整理（defrag） 才能恢复写入能力。
3.5 配额监控与告警阈值
建议在配额耗尽之前提前告警，预留足够的处理时间。
| 指标 | 告警阈值 | 严重级别 | 建议动作 |
|---|---|---|---|
| db 大小 / 配额 | > 80% | Warning | 检查数据增长趋势，准备压缩 |
| db 大小 / 配额 | > 95% | Critical | 立即执行 compact + defrag |
| etcd_server_quota_backend_bytes | 达到配额值 | Emergency | 集群只读，紧急恢复 |
3.6 配额与 backup 缓存命中巡检的关联
在《资源配额与性能调优协同的 etcd backup 缓存命中巡检》课程中，配额状态直接影响 backup 缓存的有效性：
- 配额健康时：backup 缓存可以正常更新，缓存命中率稳定，巡检关注点在于缓存策略优化。
- 配额接近耗尽时：写入变慢，backup 缓存更新延迟，命中率可能下降，巡检需识别缓存陈旧问题。
- 配额已耗尽时：backup 缓存无法写入新数据，缓存完全失效，巡检应触发紧急告警。
巡检最佳实践：将配额使用率作为 backup 缓存命中巡检的 前置条件指标。在分析缓存命中率之前，先确认配额状态是否正常。如果配额使用率超过 90%，缓存命中率分析结果可能失真。