1. 课程导论：OTel管线自助目录的概念、课程目标与适用人群
1.1 什么是 OTel 管线自助目录？
在微服务与云原生架构日益复杂的今天，可观测性数据的采集、处理与导出不再是“一次配置、永久运行”的静态任务。不同团队、不同服务、不同环境对遥测数据（Trace、Metric、Log）的采样率、标签增强、过滤规则、后端目的地有着截然不同的需求。
OTel 管线自助目录是一套标准化、可复用、可搜索的 OpenTelemetry Collector 管线配置模板集合。它允许平台工程团队预先定义好一系列经过验证的管线“配方”，让应用团队通过简单的参数选择（如服务名、环境、采样率）即可自助生成并部署完整的 Collector 配置，无需从零编写 YAML。
核心价值：将“专家经验”转化为“自助服务”，缩短可观测性配置的交付周期，降低配置错误风险，统一组织内的遥测数据治理标准。
1.2 课程目标
完成本课程后，学员将能够：
| 目标维度 | 具体能力 | 交付物 |
|---|---|---|
| 概念理解 | 掌握 OTel Collector 管线（Receivers/Processors/Exporters）的组件化设计思想 | 能绘制管线组件关系图 |
| 模板设计 | 设计可参数化的 YAML 模板，支持环境、采样率、标签等变量注入 | 一套标准管线模板目录 |
| 目录构建 | 使用 Git 仓库 + CI/CD 构建可搜索、可版本化的模板目录 | 自助目录平台原型 |
| 自助集成 | 通过 API 或 CLI 实现“选择模板 → 填写参数 → 生成配置”的自助流程 | 自助生成脚本/工具 |
| 治理与演进 | 制定模板版本策略、审批流程与废弃机制 | 模板治理规范文档 |
1.3 适用人群
本课程面向以下三类核心角色：
- 平台工程 / SRE 团队：负责建设内部可观测性平台，需要将 OTel 配置能力产品化、自助化，减少重复性支持工作。
- 可观测性架构师：需要设计组织级的遥测数据采集标准，确保多团队、多技术栈下的数据一致性与治理合规。
- 后端 / 微服务开发者：希望理解 OTel Collector 配置原理，并能通过自助目录快速为自己的服务接入符合规范的可观测性管线。
前置要求：建议学员具备基础的 YAML 编写能力，了解 OpenTelemetry 的基本概念（Trace/Span/Metric/Log），并接触过 OTel Collector 的简单部署。
1.4 管线自助目录的核心架构
下图展示了 OTel 管线自助目录在组织中的位置与核心组件关系：
1.5 课程内容概览
本课程共分为 6 个模块，逐步深入：
- 基础篇（第 1-5 章）：OTel Collector 管线组件详解、YAML 模板化设计原则、参数化模式。
- 目录构建篇（第 6-12 章）：模板目录结构设计、Git 仓库组织、版本化策略、搜索与发现机制。
- 自助集成篇（第 13-18 章）：CLI 工具开发、API 服务设计、Web 门户集成、配置校验与预览。
- 治理篇（第 19-23 章）：模板审批流程、权限模型、废弃与迁移策略、合规审计。
- 实战篇（第 24-28 章）：基于真实场景（多环境 Trace 采样、动态标签注入、多后端分发）构建完整目录。
- 总结篇（第 29-30 章）：最佳实践总结、常见陷阱、未来演进方向。
注意：本课程不深入讲解 OTel Collector 的安装部署细节，也不覆盖特定云厂商的托管 Collector 服务。重点聚焦于“模板设计”与“自助目录构建”的方法论与工程实践。
1.6 为什么需要自助目录？—— 典型痛点对比
| 场景 | 传统方式（无目录） | 自助目录方式 |
|---|---|---|
| 新服务接入 | 开发者提工单 → 平台工程师手动编写 YAML → 多次沟通修改 → 部署 | 开发者登录门户 → 选择模板 → 填写服务名/环境 → 一键生成配置 → 自动部署 |
| 采样率调整 | 修改全局配置 → 影响所有服务 → 需要全量测试 | 按服务/环境独立调整参数 → 仅影响目标管线 → 局部生效 |
| 新增后端 | 平台工程师逐个修改所有 Collector 配置 → 容易遗漏或出错 | 更新模板目录 → 所有引用该模板的服务自动获得新后端支持 |
| 配置审计 | 散落在各服务仓库中的 YAML 文件 → 难以统一审查 | 所有配置均从目录模板生成 → 审计只需检查模板与参数 |
通过以上对比可以看出，OTel 管线自助目录不仅提升了效率，更关键的是建立了可观测性配置的标准化治理基础，让平台团队从“救火队员”转变为“能力提供者”。