etcd 存储上限

最佳实践与监控
推荐配置组合
生产环境建议配置：

配额值：物理内存的50%（不超过8GB）
自动压缩：保留24小时数据
快照策略：每小时1次，保留最近5份
关键监控指标
etcd_debugging_mvcc_db_total_size_in_bytes：当前存储大小
etcd_server_quota_backend_bytes：配额上限值
etcd_server_alarm_active{alarm="NOSPACE"}：空间告警状态

 

quota-backend-bytes 是 etcd 的存储空间硬配额参数，用来限制 etcd 后端 BoltDB 文件的最大尺寸，单位是 字节（Byte）。

• 默认值：0（表示使用内置的保守值，官方二进制通常等价于 2 GB）
• 作用：当 etcd 的磁盘占用达到该值时，集群会触发 NOSPACE 告警，并立即进入只读模式（仅允许 get/delete，拒绝 put/create）。
• 取值范围：官方建议最小 100 MB，最大 8 GB（8589934592 B）

   

  。
• 配置方式：启动参数或环境变量
  bash

  复制

  etcd --quota-backend-bytes=4294967296      # 4 GB
  # 等价于
  export ETCD_QUOTA_BACKEND_BYTES=4294967296

   

一句话：它是 etcd 的“磁盘容量红线”，超过即锁写，必须提前根据业务规模调大并配合自动压缩与定期碎片整理

 

。