2. OpenTelemetry 简介
OpenTelemetry（简称 OTel）是云原生计算基金会（CNCF）旗下的可观测性标准框架，旨在统一分布式系统中指标（Metrics）、日志（Logs）和链路追踪（Traces）三大信号的数据采集、处理与导出规范。本章将系统介绍其起源、项目目标、核心组件以及与 CNCF 的关系，为后续实现日志采集标准化奠定理论基础。
2.1 起源：从 OpenTracing 与 OpenCensus 到统一标准
在 OpenTelemetry 出现之前，可观测性领域存在两大主流开源项目：
| 项目 | 发起方 | 主要贡献 | 局限性 |
|---|---|---|---|
| OpenTracing | CNCF（2016） | 定义了链路追踪的 API 规范，提供厂商中立的接口 | 仅覆盖链路追踪，缺乏指标和日志的统一抽象 |
| OpenCensus | Google（2017） | 提供指标和链路追踪的 SDK，支持多种后端导出 | 与 Google 内部库耦合较深，社区扩展性受限 |
两个项目在目标上高度重叠，但 API 不兼容，导致用户和厂商面临“二选一”的困境。2019 年，CNCF 推动两大项目合并，正式启动 OpenTelemetry 项目，继承 OpenTracing 的 API 设计理念与 OpenCensus 的 SDK 实现经验，成为可观测性领域的“单一标准”。
关键里程碑：2021 年，OpenTelemetry 成为 CNCF 继 Kubernetes、Prometheus 之后的第三个毕业项目，标志着其生产就绪性获得社区广泛认可。
2.2 项目目标：三大核心原则
OpenTelemetry 的设计围绕以下三个核心目标展开：
- 厂商中立：不绑定任何特定后端（如 Jaeger、Prometheus、Datadog），用户可自由切换或同时使用多个后端。
- 信号统一：用同一套 API/SDK 采集 Traces、Metrics、Logs 三类信号，消除数据孤岛。
- 无侵入集成：通过自动插桩（Auto-instrumentation）和手动插桩（Manual-instrumentation）两种方式，最小化对业务代码的侵入。
实践提示：在日志采集标准化场景中，OpenTelemetry 的“信号统一”能力尤为关键——它允许将日志与对应的 Trace ID、Span ID 自动关联，实现从日志到链路追踪的快速跳转。
2.3 核心组件：API、SDK、Collector
OpenTelemetry 的架构由三个核心层组成，下图展示了它们之间的协作关系：
各组件职责如下：
| 组件 | 职责 | 典型使用场景 |
|---|---|---|
| API | 定义 Tracer、Meter、Logger 等接口规范，不包含实现 | 库作者依赖 API 编写插桩代码，避免绑定具体 SDK |
| SDK | 实现 API 接口，提供采样、上下文传播、批处理、导出等能力 | 应用程序引入 SDK 依赖，配置导出地址和采样率 |
| Collector | 独立代理服务，接收、处理、转发遥测数据 | 作为数据管道，统一过滤、脱敏、路由日志到不同后端 |
常见误区：API 和 SDK 必须配对使用。如果只引入 API 而不引入 SDK，应用程序不会产生任何遥测数据；如果只引入 SDK 而不通过 API 编码，则无法利用标准接口实现厂商中立。
2.4 与 CNCF 的关系
OpenTelemetry 是 CNCF 的毕业项目（Graduated Project），与 Kubernetes、Prometheus、Envoy 等处于同一成熟度级别。CNCF 为其提供：
- 治理框架：由技术委员会（TOC）监督，确保项目发展符合社区利益。
- 基础设施支持：包括 CI/CD 流水线、文档托管、社区论坛等。
- 生态整合：与 Prometheus（指标）、Fluentd（日志）、Jaeger（链路）等 CNCF 项目深度集成。
下图展示了 OpenTelemetry 在 CNCF 可观测性生态中的核心位置：
生态优势：由于 CNCF 的背书，OpenTelemetry 已成为云原生可观测性的事实标准。主流云厂商（AWS、Azure、GCP）和可观测性 SaaS 厂商（Datadog、New Relic、Honeycomb）均已原生支持 OTel 协议，用户无需为每个后端编写专属采集代码。
2.5 本章小结
OpenTelemetry 通过合并 OpenTracing 与 OpenCensus，构建了覆盖 Trace、Metrics、Logs 的统一采集标准。其三层组件架构（API → SDK → Collector）实现了“一次插桩，随处导出”的愿景。作为 CNCF 毕业项目，OTel 已成为云原生可观测性生态的核心枢纽，为日志采集标准化提供了坚实的标准化基础。