1. 课程导论：etcd压测沙盘概述、分布式追踪与日志动态切换的重要性、课程目标与学习路径
1.1 为什么需要一套“压测沙盘”？
etcd 作为云原生架构中的“神经系统”，其稳定性直接决定上层 Kubernetes 集群、服务发现、分布式锁等核心组件的健康度。然而，在生产环境中对 etcd 进行压测往往面临三大困境：
- 环境隔离难：压测流量可能污染线上数据或引发级联故障。
- 观测盲区大：默认日志级别下，关键延迟抖动和 Raft 协议细节被淹没。
- 调参反馈慢：修改配置后需要重启进程，迭代周期长。
本课程提出的 “压测沙盘” 是一套轻量级、可复现的调试环境，它允许你在隔离的容器或进程中模拟真实流量，同时通过分布式追踪和动态日志切换实现“手术灯级”的观测能力。
💡 核心观点： 压测沙盘不是简单的测试工具，而是一个集成了“注入-观测-调优”闭环的调试平台。它让 etcd 的内部状态变得可编程、可追踪、可实时调整。
1.2 分布式追踪与日志动态切换：压测调试的两大支柱
在沙盘环境中，传统的 tail -f 查看日志方式已无法满足精细化调试需求。我们需要两种互补的观测手段：
| 观测手段 | 解决的问题 | 典型场景 |
|---|---|---|
| 分布式追踪 | 追踪一次读写请求在 etcd 内部（网络层、Raft 层、存储层）的完整调用链，定位延迟热点。 | 发现“P99 延迟突增”是由于 Raft 提案提交阶段等待磁盘 fsync 导致。 |
| 日志动态切换 | 在不重启 etcd 进程的前提下，按需调整特定模块（如 rafthttp、mvcc）的日志级别。 |
压测中出现“Leader 频繁切换”时，动态开启 raft 模块的 Debug 日志，捕获选举超时细节。 |
两者结合，构成了沙盘调试的“全景图”：追踪提供“请求维度的纵向链路”，日志提供“模块维度的横向细节”。
1.3 课程目标与学习路径
本课程面向 SRE 工程师、分布式系统开发者、etcd 运维人员，旨在帮助你掌握以下核心能力：
- 搭建压测沙盘：基于 Docker Compose 或 Kind 集群，快速拉起一个包含 etcd 集群、Prometheus、Jaeger 的调试环境。
- 注入分布式追踪：通过 OpenTelemetry SDK 对 etcd 客户端和服务器端进行插桩，生成 Trace 数据。
- 实现日志动态切换：利用 etcd 的
/debug/pprof接口或自定义信号处理，在不重启的情况下调整日志级别。 - 联合分析：结合 Trace 和日志，快速定位压测中的性能瓶颈与异常行为。
1.4 课程知识体系与章节地图
整个课程分为四个阶段，共 30 章。下表展示了核心模块与对应章节：
| 阶段 | 核心内容 | 覆盖章节 |
|---|---|---|
| 基础篇 | etcd 架构回顾、压测沙盘环境搭建、基础压测工具（benchmark、ghz） | 第 1-8 章 |
| 观测篇 | OpenTelemetry 集成、Jaeger 部署、分布式追踪数据解读 | 第 9-15 章 |
| 调试篇 | 日志级别动态切换原理、gRPC 拦截器实现、信号处理与热加载 | 第 16-22 章 |
| 实战篇 | Leader 选举抖动、存储延迟、网络分区等典型故障的沙盘复现与调试 | 第 23-30 章 |
🎯 本章小结： 压测沙盘是 etcd 调试的“安全实验室”，分布式追踪和日志动态切换是沙盘中的两盏“手术灯”。本课程将带你从零搭建这套体系，并最终具备独立诊断复杂 etcd 故障的能力。