1. 课程导论：平台工程与可观测性的关系、为什么需要自助管线目录、课程目标与受众
1.1 平台工程与可观测性的共生关系
平台工程的核心使命是构建一条“黄金路径”，让开发者能够快速、安全地交付业务价值。而可观测性（Observability）正是这条路径上的“仪表盘与传感器”——没有它，平台团队和开发者都将在黑箱中飞行。
传统运维模式下，监控、日志、链路追踪由各团队独立搭建，工具链碎片化，数据孤岛严重。平台工程通过抽象基础设施、提供标准化服务层，将可观测性从“事后排查”升级为“内建能力”。两者的关系可以用下表概括：
| 维度 | 传统运维 | 平台工程 + 可观测性 |
|---|---|---|
| 数据采集 | 手动配置 Agent，格式各异 | OpenTelemetry 标准化采集，自动注入 |
| 数据关联 | 日志/指标/链路分离 | 统一上下文传播，三信号关联 |
| 自助能力 | 依赖运维开权限、配规则 | 开发者通过目录自服务，无需提工单 |
| 故障定位 | 平均 30 分钟以上 | 5 分钟内端到端定位 |
| 成本控制 | 数据冗余，存储爆炸 | 按需采样，目录级成本治理 |
关键洞察： 平台工程不是“造一个内部工具”，而是通过可观测性数据反馈，持续优化开发者体验和系统可靠性。OpenTelemetry 作为 CNCF 毕业项目，已成为连接平台与可观测性的“通用语言”。
1.2 为什么需要自助管线目录？
在大型组织中，可观测性管线的配置往往面临三大痛点：
- 配置爆炸： 每个微服务需要定义采集端点、采样率、导出目标、标签规则，手动配置极易出错。
- 团队瓶颈： 平台团队成为“可观测性工单处理中心”，开发者等待数天才能上线一条新管线。
- 治理缺失： 没有统一的目录，重复采集、数据泄露、成本失控等问题频发。
自助管线目录正是为解决这些问题而生。它本质上是一个“可观测性管线市场”，开发者可以从目录中选择预定义的管线模板，一键部署到自己的服务上，同时平台团队通过目录实现统一治理与成本管控。
类比理解： 自助管线目录就像云市场的“镜像商店”——开发者不需要自己从零搭建操作系统，只需选择经过认证的镜像，即可快速启动一个合规、安全的实例。
1.3 核心架构关系图
下图展示了平台工程、OpenTelemetry 与自助管线目录之间的核心关系：
1.4 课程目标与受众
本课程旨在帮助平台工程团队从零构建一套基于 OpenTelemetry 的自助管线目录系统，实现可观测性能力的“产品化”交付。
课程核心目标
- 架构设计能力： 掌握管线目录的分层架构、元数据模型与 API 设计。
- OpenTelemetry 实战： 深入理解 Collector 管线、采样策略、上下文传播与导出器配置。
- 自助服务体验： 设计开发者友好的目录界面与 CLI 工具，降低使用门槛。
- 治理与成本： 实现目录级别的数据治理、成本分摊与安全策略。
- 生产化落地： 涵盖多集群、多云、大规模场景下的部署与运维。
目标受众
| 角色 | 关注点 | 课程价值 |
|---|---|---|
| 平台架构师 | 整体架构、技术选型、扩展性 | 获得可落地的目录架构方案与最佳实践 |
| SRE / 可观测性工程师 | OpenTelemetry 配置、采样、告警 | 深入管线细节，掌握目录集成方法 |
| 后端 / 微服务开发者 | 如何快速接入可观测性 | 理解目录自助流程，提升日常排障效率 |
| 技术管理者 | 成本、效率、标准化 | 评估目录 ROI，推动组织落地 |
前置要求： 建议学员具备 Kubernetes 基础操作经验，了解微服务架构与基本监控概念。无需 OpenTelemetry 深度经验，课程会从核心概念讲起。
1.5 课程内容全景
本课程共 30 章，分为五大模块：
- 基础篇（第 1-5 章）： 平台工程与可观测性基础、OpenTelemetry 核心概念、目录需求分析。
- 设计篇（第 6-12 章）： 目录元数据模型、管线模板设计、API 与 UI 架构。
- 实现篇（第 13-20 章）： Collector 管线编排、采样策略、导出器集成、安全与认证。
- 治理篇（第 21-26 章）： 成本管理、数据质量、多租户、审计与合规。
- 运营篇（第 27-30 章）： 生产化部署、故障演练、社区生态与未来演进。
每章均包含理论讲解、架构图、代码示例与课后思考题，帮助学员从“知道”到“做到”。