1. 课程导论：分布式追踪与日志埋点的背景、核心价值、课程目标与学习路径
1.1 为什么需要分布式追踪与日志埋点？
在单体应用时代，一次请求的生命周期通常局限在单个进程内。开发人员可以通过查看单台服务器的应用日志，结合请求入参和返回时间，快速定位性能瓶颈或错误根源。然而，当架构演进为微服务后，一个用户请求往往需要跨越数十甚至上百个服务节点，传统的日志排查方式面临以下困境：
- 日志碎片化：每个服务独立输出日志，缺乏全局请求标识，难以将一次请求的完整调用链串联起来。
- 性能瓶颈模糊：无法准确判断延迟究竟发生在哪个服务、哪个数据库调用或哪个外部 API 上。
- 错误根因定位困难：一个错误可能由上游服务超时、下游服务异常或中间件故障引发，缺乏上下文传递机制。
- 缺乏全局拓扑视图：服务间的依赖关系、调用频率、成功率等关键指标无法直观呈现。
核心矛盾：微服务架构带来了独立部署、弹性伸缩和语言异构等优势，但也使得“一次请求”的可见性从单机单进程变成了分布式多进程问题。分布式追踪与日志埋点正是解决这一可见性问题的关键技术手段。
1.2 分布式追踪与日志埋点的核心价值
分布式追踪（Distributed Tracing）和日志埋点（Log Instrumentation）共同构成了微服务可观测性（Observability）的基石。它们并非相互替代，而是互补关系：
| 维度 | 分布式追踪 | 日志埋点 |
|---|---|---|
| 核心关注点 | 请求的完整调用链路、各节点耗时、拓扑关系 | 业务状态、错误详情、调试信息、审计记录 |
| 数据模型 | Trace / Span / SpanContext | 结构化日志条目（时间戳、级别、消息、字段） |
| 典型用途 | 延迟分析、依赖分析、瓶颈定位、SLA 监控 | 错误排查、业务审计、安全分析、运维告警 |
| 关联方式 | 通过 TraceID / SpanID 串联 | 日志中嵌入 TraceID 实现关联 |
两者的结合能够带来以下核心价值：
- 端到端可见性：从用户请求入口到最终响应，完整还原每一次请求的调用路径。
- 精准性能分析：精确到每个 Span 的耗时统计，快速识别慢调用和瓶颈服务。
- 高效故障排查：通过 TraceID 快速检索关联日志，从链路上下文直接跳转到错误详情。
- 服务拓扑可视化：自动生成服务依赖图，辅助架构治理和容量规划。
- 数据驱动优化：基于链路数据做服务拆分、缓存策略、数据库查询优化等决策。
1.3 课程目标
本课程旨在帮助 Go 微服务开发者系统性地掌握日志埋点与分布式追踪的工程实践。完成本课程后，你将能够：
- 理解核心概念：掌握 Trace、Span、SpanContext、Baggage、采样率等分布式追踪核心术语，以及结构化日志、日志级别、日志聚合等日志埋点基础。
- 掌握 Go 语言实现：熟练使用 OpenTelemetry Go SDK 进行手动和自动埋点，包括 HTTP/gRPC 中间件、数据库调用、消息队列等常见场景。
- 构建日志链路：在日志库（如 zap、logrus）中集成 TraceID，实现日志与追踪的无缝关联。
- 部署与运维：搭建 Jaeger 或 Zipkin 后端，配置采样策略，对接日志收集系统（如 Loki + Grafana）。
- 生产级实践：处理高并发下的性能开销、链路采样、敏感数据脱敏、多租户隔离等进阶问题。
1.4 学习路径与课程大纲
本课程共分为 6 个模块，30 个章节，按照从理论到实践、从基础到进阶的顺序组织：
| 模块 | 章节范围 | 核心内容 |
|---|---|---|
| 模块一：基础概念 | 第 1-4 章 | 分布式追踪原理、OpenTelemetry 协议、日志埋点规范、TraceID 传播机制 |
| 模块二：Go 埋点实战 | 第 5-12 章 | HTTP/gRPC 中间件、数据库、Redis、消息队列的手动与自动埋点 |
| 模块三：日志链路集成 | 第 13-18 章 | zap/logrus 集成 TraceID、日志上下文传递、多服务日志关联查询 |
| 模块四：后端部署 | 第 19-23 章 | Jaeger/Zipkin 部署、采样策略配置、Grafana 仪表盘、告警规则 |
| 模块五：进阶实践 | 第 24-27 章 | 性能优化、敏感数据过滤、多租户链路隔离、异步场景追踪 |
| 模块六：综合案例 | 第 28-30 章 | 电商订单全链路追踪、日志链路故障排查演练、生产级最佳实践总结 |
1.5 预备知识
为了获得最佳学习体验，建议你具备以下基础：
- Go 语言基础：熟悉 Go 语法、goroutine、channel、接口等核心特性。
- 微服务基础：了解微服务架构的基本概念，如服务注册与发现、RPC 通信、API 网关等。
- Docker / Kubernetes 基础：能够使用 Docker 运行容器，了解 Pod、Service 等基本 K8s 概念（课程中的部署环节会用到）。
- 日志基础：了解常见日志级别（DEBUG / INFO / WARN / ERROR）和结构化日志的基本思想。
提示：如果你对上述预备知识中的某些部分不够熟悉，课程附录中提供了快速参考链接和推荐阅读材料，可以在学习过程中随时查阅。
1.6 课程配套与实验环境
本课程提供完整的配套代码仓库，包含以下内容：
- 示例代码：每个章节对应的 Go 代码示例，包含完整的埋点、日志集成和追踪配置。
- Docker Compose 环境：一键启动 Jaeger、Elasticsearch、Kibana、Grafana 等依赖组件。
- 实验手册：每个模块配套的实验指导，包含具体步骤、预期结果和常见问题解答。
- 故障场景模拟：模块六中提供预置的故障注入脚本，用于演练链路排查能力。