规范状态概览

OpenTelemetry 是基于各种信号逐一开发的。链路追踪、指标、Baggage 和日志都是一种信号。 每个信号都构建在上下文传播机制之上，这是一种用于在分布式系统中关联数据的共享机制。

每个信号由四个核心组件组成：

• API
• SDK
• OpenTelemetry 协议（OTLP）
• Collector

信号还包括 contrib 组件，这是插件和插桩组成的生态体系。 所有插桩遵循统一的语义约定，以确保在观察常见操作（如 HTTP 请求）时生成相同的数据。

如需了解信号和组件的信息，请参阅 OTel 规范的概览页面。

组件生命周期

组件遵循以下开发生命周期：

• **草案（Draft）**组件仍在设计中，尚未纳入规范。
• **实验性（Experimental）**组件已发布并可进行测试。
• **稳定（Stable）**组件向后兼容，并享有长期支持。
• **弃用（Deprecated）**组件仍然稳定，但未来可能被移除。

有关生命周期和长期支持的完整定义， 参阅版本管理与稳定性。

当前状态

以下是目前各个信号的高层次状态报告。请注意，虽然 OpenTelemetry 各客户端遵循统一规范开发，但它们是独立开发的。

建议查看每个客户端在其 GitHub 仓库中 README 文件的当前状态说明。客户端对特性支持的具体情况可在 规范兼容性表中查看。

注意，以下各部分中的 Collector 状态与协议状态一致。

链路追踪

• 规范
• 备注：
  • 链路追踪规范现已完全稳定，并纳入长期支持范围。
  • 链路追踪规范仍可扩展，但必须保持向后兼容。
  • 一旦链路追踪实现完成，OpenTelemetry 客户端将进入 v1.0 版本。

指标

• 规范
• 备注：
  • OpenTelemetry 各项指标正在积极开发中。
  • 数据模型已稳定，并作为 OTLP 协议的一部分发布。
  • Collector 中已提供对指标处理的实验性支持。
  • Collector 正与 Prometheus 社区合作，开发对 Prometheus 的支持。

Baggage

• 规范
• SDK： 稳定
• 协议： 不适用
• 备注：
  • Baggage 现已完全稳定。
  • Baggage 不是可观测性工具，而是一种在事务中附加任意键值对的系统，使下游服务可以访问这些值。 因此，Baggage 没有 OTLP 或 Collector 组件。

日志

• 规范
• 备注：
  • 日志数据模型已作为 OpenTelemetry 协议的一部分发布。
  • 多种数据格式的日志处理已通过 Stanza 捐赠集成至 Collector。
  • OpenTelemetry 的 Log Bridge API 允许开发日志附加器，用于将现有日志框架中的日志桥接到 OpenTelemetry 中。该 API 并不面向终端用户直接调用。目前正在开发多种编程语言的日志附加器。
  • OpenTelemetry Log SDK 是 Log Bridge API 的标准实现。应用可以通过配置该 SDK 来指定日志的处理与导出方式（例如使用 OTLP 协议）。
  • OpenTelemetry 的 Log Bridge API 还包含实验性支持， 可用于生成符合事件语义约定的日志记录。

分析配置

• 规范