4. etcd 数据目录结构：数据目录布局、wal日志目录、snap快照目录、member目录详解

etcd 的数据目录是其存储组件的物理基础。理解数据目录的布局结构，是进行容量水位评估、故障恢复和性能调优的前提。etcd 默认的数据目录由 --data-dir 参数指定（通常为 /var/lib/etcd/default.etcd），其内部按功能划分为多个子目录和关键文件。

4.1 顶层目录布局总览

一个运行中的 etcd 节点，其数据目录的典型结构如下：

/var/lib/etcd/default.etcd/
├── member/
│   ├── snap/
│   │   ├── 0000000000000001-0000000000000001.snap
│   │   └── db
│   └── wal/
│       ├── 0000000000000000-0000000000000000.wal
│       └── 0.tmp
└── snap/
    └── db

核心目录与文件说明：

4.2 member 目录：核心数据容器

member 目录是 etcd 数据存储的核心，包含了 Raft 协议运行所需的所有持久化数据。它内部主要包含 snap 和 wal 两个子目录。

4.3 snap 快照目录详解

member/snap/ 目录用于存储 Raft 协议的快照数据。快照是 etcd 在特定时刻对状态机（BoltDB）的完整备份，用于日志压缩和加速节点恢复。

snap 目录中的关键文件：

• *.snap 文件： 命名格式为 {term}-{index}.snap，例如 0000000000000001-0000000000000001.snap。其中 term 是 Raft 任期号，index 是快照包含的最后一条日志的索引。每个文件包含一个完整的快照数据。
• db 文件： 这是 etcd 的核心数据库文件，本质是一个 BoltDB 实例。它存储了所有用户写入的键值数据、集群元数据以及 MVCC 历史版本信息。该文件的大小是评估存储水位最直接的指标。

4.4 wal 日志目录详解

member/wal/ 目录存储预写日志（Write-Ahead Log）。WAL 是 Raft 协议的核心组件，所有对状态机的修改操作必须先写入 WAL 才能提交。WAL 保证了数据的持久性和一致性。

WAL 文件命名与生命周期：

WAL 文件大小与容量关系：

• 每个 WAL 文件默认最大为 64MB（硬编码，不可配置）。
• 当当前 WAL 文件写满后，etcd 会创建新的 WAL 文件继续写入。
• WAL 文件在快照完成后会被清理（删除旧的 WAL 文件），但清理策略取决于 --snapshot-count 和 --experimental-compaction-batch-limit 等参数。
• 在写入高峰或快照延迟时，WAL 目录可能积累大量文件，导致磁盘空间告警。

4.5 数据目录与容量水位的关系

理解数据目录结构后，我们可以将容量水位评估聚焦于以下几个关键路径：

关键水位指标总结：