4. 压测工具选型与部署：benchmark、etcdctl check perf、go-ycsb 的安装与基本用法

在构建 etcd 压测沙盘时，选择合适的压测工具并正确部署是获取可靠 IO 曲线数据的前提。本章聚焦三种主流压测工具——benchmark（etcd 官方内置）、etcdctl check perf（快速健康检查）、go-ycsb（云原生基准测试框架）——的选型逻辑、安装步骤与基本用法，帮助你在沙盘环境中快速搭建压测能力。

4.1 工具选型对比

三种工具在压测场景、负载模型、部署复杂度上各有侧重。下表从关键维度进行对比，便于你根据沙盘目标选择合适工具。

4.2 工具部署与安装

4.2.1 benchmark：编译安装

benchmark 工具位于 etcd 官方仓库的 tools/benchmark 目录下，需要从源码编译。推荐在压测沙盘节点上执行以下步骤：

# 1. 克隆 etcd 仓库（指定稳定版本，如 v3.5.15）
git clone -b v3.5.15 https://github.com/etcd-io/etcd.git
cd etcd/tools/benchmark

# 2. 编译 benchmark 二进制
go build -o benchmark .

# 3. 验证安装
./benchmark --help

编译完成后，将 benchmark 二进制复制到 /usr/local/bin 或沙盘工作目录下，方便后续调用。

4.2.2 etcdctl check perf：零安装

etcdctl check perf 是 etcdctl 内置子命令，只要 etcdctl 版本与集群匹配即可直接使用。无需额外安装步骤：

# 直接执行，默认进行 60 秒性能检查
etcdctl --endpoints=https://127.0.0.1:2379 --cacert=/etc/etcd/ca.pem \
  --cert=/etc/etcd/server.pem --key=/etc/etcd/server-key.pem \
  check perf

# 指定检查时长（秒）
etcdctl check perf --duration 30

4.2.3 go-ycsb：Go 环境部署

go-ycsb 是 PingCAP 维护的 YCSB 实现，支持 etcd 作为后端存储。安装需要 Go 1.20+ 环境：

# 1. 安装 go-ycsb
go install github.com/pingcap/go-ycsb@latest

# 2. 验证安装
go-ycsb --help

# 3. 查看支持的数据库（应包含 etcd）
go-ycsb database list

如果 etcd 后端未在列表中，需要手动编译带 etcd 支持的版本：

# 克隆仓库并编译
git clone https://github.com/pingcap/go-ycsb.git
cd go-ycsb
make build
# 编译产物在 bin/go-ycsb

4.3 基本用法与压测示例

4.3.1 benchmark 基本用法

benchmark 支持多种负载模式，最常用的是 put（写入）和 get（读取）。以下示例展示如何对 3 节点 etcd 集群执行写入压测：

# 写入压测：10 并发，总计 10000 次写入，key 大小 256 字节，value 大小 1024 字节
./benchmark --endpoints=https://10.0.0.1:2379,https://10.0.0.2:2379,https://10.0.0.3:2379 \
  --cacert=/etc/etcd/ca.pem \
  --cert=/etc/etcd/server.pem \
  --key=/etc/etcd/server-key.pem \
  put --key-size 256 --val-size 1024 \
  --total 10000 --conns 10 --clients 10

输出关键指标包括：平均延迟、P99 延迟、吞吐量（ops/sec）、错误数。这些数据是后续 IO 曲线复核的基础。

4.3.2 etcdctl check perf 基本用法

该命令专为快速性能验证设计，输出简洁明了：

# 执行 30 秒性能检查
etcdctl check perf --duration 30

# 输出示例：
# 60 / 60  requests done in 30.001 seconds
# Average write: 12345.67 ops/sec
# Average latency: 0.81 ms
# 99th percentile latency: 2.34 ms
# Slowest request: 5.67 ms
# Error rate: 0.00%

如果错误率不为 0% 或延迟超过预期阈值（如 P99 > 10ms），说明集群存在 IO 瓶颈或网络抖动，需要进入 IO 曲线复核流程。

4.3.3 go-ycsb 基本用法

go-ycsb 使用 YCSB 工作负载配置文件定义压测参数。以下示例展示如何运行 Workload A（50% 读 / 50% 写，均匀分布）：

# 1. 创建工作负载配置文件 workload-a.yaml
cat <<EOF > workload-a.yaml
recordcount: 10000
operationcount: 50000
workload: core
readallfields: true
readproportion: 0.5
updateproportion: 0.5
scanproportion: 0
insertproportion: 0
requestdistribution: uniform
EOF

# 2. 执行压测
go-ycsb run etcd -P workload-a.yaml \
  --threads 20 \
  --target 1000 \
  --etcd.endpoints https://10.0.0.1:2379 \
  --etcd.cacert /etc/etcd/ca.pem \
  --etcd.cert /etc/etcd/server.pem \
  --etcd.key /etc/etcd/server-key.pem

go-ycsb 输出包含 吞吐量、平均延迟、P99 延迟、操作分布 等详细统计，适合生成多维度的 IO 曲线数据。

4.4 工具部署架构与压测流程

下图展示三种压测工具在沙盘环境中的部署位置与数据流向，帮助你理解压测工具与 etcd 集群、监控系统之间的协作关系。

4.5 压测执行流程与风险控制点

在沙盘环境中执行压测时，建议遵循以下标准化流程，确保 IO 曲线数据的有效性和安全性：

1. 环境准备：确认 etcd 集群健康（etcdctl endpoint health），记录基线 IO 指标。
2. 工具选择：根据压测目标选择对应工具（快速检查用 check perf，固定负载用 benchmark，复杂场景用 go-ycsb）。
3. 参数配置：设置并发数、key/value 大小、总请求数、超时时间等参数，避免压测导致集群过载。
4. 执行压测：启动压测并同步采集 IO 曲线数据（磁盘读写、网络 IO、延迟分布）。
5. 数据复核：对比压测结果与基线，识别异常抖动或性能拐点。
6. 风险控制：设置熔断阈值（如 P99 延迟 > 50ms 自动停止），防止压测影响生产级集群。

4.6 常见问题与避坑指南