跟踪、指标、日志于一身的OpenTelemetry发布跟踪规范RC版本 + GA计划

作者：Morgan McLean

正如我们之前公告中所讨论，我们正在努力构建OpenTelemetry的第一个GA版本。自从3月份beta版以来，OpenTelemetry已经解决了2640个github问题，合并了5721个PR，使其成为第二大活跃的CNCF项目。今天是这个过程中的另一个里程碑，跟踪规范的冻结和发布第一个候选（release candidate，RC）版本。

跟踪规范RC版本

跟踪规范现在冻结，并且是一个RC版本。OpenTelemetry的API和SDK有一个稳定的跟踪规范来构建自己的RC版本。这意味着：

• 实现跟踪规范的API、SDK和Collector（收集器）的RC版本将在未来几周内出现。
• 从现在到最终的GA规范之间，不允许任何破坏跟踪规范的更改，除了RC期间发现的任何严重（P1）问题。我们不期望这些出现，但RC时期的目的是为了让我们验证一个值得GA的规范。
• RC期间允许一些不破坏性的改变。其中大多数是对现有行为的澄清或简单的编辑更新。

规范的RC部分包括所有与跟踪相关的依赖项，特别是以下部分：跟踪（Trace）、行李（Baggage）、资源（Resource）、上下文传播（Context Propagation）、环境变量（Environment Variables）和导出器（用于跟踪的Exporters）。你可以在项目状态矩阵中查看每个OpenTelemetry组件的实现进度。

https://github.com/open-telemetry/opentelemetry-specification/blob/master/spec-compliance-matrix.md

接下来是什么呢？

实现跟踪规范的RC版本，是OpenTelemetry在3月份发布beta以来的首要任务。完成这些工作后，我们现在将重点，转移到RC跟踪API、SDK、收集器和自动仪表（auto instrumentation）组件的实现，以及生成指标规范的RC版本。

RC跟踪的实现

大多数OpenTelemetry的API和SDK已经接近完成RC跟踪实现，我们预计第一波将在未来两周内发布。希望提供工具（针对各种web框架、存储客户端等）的贡献者，可以在RC API发布后开始构建。虽然在RC使用和测试过程中发现的问题可能会导致API的改变（这些组件将有多个pre-GA的RC版本），但这些将受到极大的限制。

SDK可能会有两波RC里程碑。第一个将包含来自规范的跟踪和上下文传播部分的功能，第二个将包含针对行李、导出器、资源和环境变量的RC实现。

指标

在跟踪RC组件发布的同时，我们将对跟踪的关注转到指标规范。从这周开始，我们将优先考虑与指标规范相关的变更。之后，API、SDK、收集器和其他组件将发布带有RC质量的跟踪和指标功能的版本。

生产和GA的准备工作

当指标规范、SDK、收集器和其他组件达到RC版本状态，我们将专注于生产工作，如编写文档、GA后的版本策略、构建额外的自动化测试等等。当我们对每个组件的应用进展和应用反馈感到满意，我们将宣布它们的GA版本。

整体时间表

1. 规范中的跟踪部分达到了RC的质量并且冻结了（这是今天的公告）
2. 组件（API、SDK、收集器、自动仪表等）发布具有RC质量跟踪功能的RC版本
3. 规格的指标部分达到RC质量，并且冻结
4. 组件发布带有RC质量跟踪和指标功能的RC版本
5. 当我们对指标 + 跟踪的RC版本感到满意时，OpenTelemetry会GA
6. 日志进入beta版，然后发布RC规范，每个组件中紧接着是RC质量的日志功能，然后是日志的GA

在接下来的几周中，评估了指标规范的工作之后，我们将对GA发布时间表有更好的理解。

关注某一种语言的进展

除了项目状态矩阵，每个组件的实现都有自己的github项目来跟踪进度，例如JavaScript、Java、Go、Python、.NET和Java auto instrumentation。

https://github.com/open-telemetry/opentelemetry-js/projects/12

https://github.com/open-telemetry/opentelemetry-java/projects/2

https://github.com/orgs/open-telemetry/projects/5

https://github.com/open-telemetry/opentelemetry-python/projects/3

https://github.com/open-telemetry/opentelemetry-dotnet/projects/1

https://github.com/open-telemetry/opentelemetry-java-instrumentation/projects/2

FAQ

我想在生产服务上使用OpenTelemetry；今天的公告有什么影响？

带有RC质量跟踪支持的SDK将在几周后面世。不建议将RC版本用于关键的生产服务，但是它们是有实用功能的，旨在提供与即将到来的GA对应版本兼容的API。

我想为OpenTelemetry编写仪器；今天的公告有什么影响？

带有RC质量跟踪支持的API将很快面世（在SDK之前）。你可以绑定这些来生成跟踪，这些跟踪将与OpenTelemetry SDK或OpenTelemetry API的任何其他实现对接。

OpenTelemetry什么时候会提供OpenCensus和OpenTracing的替代？

目前，桥接API的工作正在进行中，它允许OpenTelemetry SDK无缝替换OpenCensus库或OpenTracing实现。虽然该功能的交付日期与OpenTelemetry的GA目标无关，但我们希望它能在每个API + SDK的RC版本和GA里程碑之间提供。

总结

对于OpenTelemetry社区来说，生成规范的RC版本是一个重要的里程碑，我们的贡献者为此付出了巨大的努力。我们要感谢参与此版本的每个人和每个组织，并认识到他们的贡献为项目的长期成功奠定了基础。

组织提供了主要开发支持OpenTelemetry包括（根据提交排名）：Splunk、微软、谷歌、Lightstep、Dynatrace、New Relic、Infostellar、Toptal、Red Hat、Shopify、Zillow、Kinvolk、Postmates、Uber、Honeycomb、Out There Labs、NCR、MailChimp、Datadog、Reelevant、大众汽车、Transit、亚马逊（今天宣布他们的支持）和蒙特利尔市。在我们的Dev Stats站点上可以关注贡献组织的完整列表。我们感谢这些公司对这个项目的投资，因为我们知道工程时间是非常昂贵的；如此多的公司看到了为OpenTelemetry做贡献的价值，这一事实证明了该项目在整个行业的影响力。

如果你还没有加入OpenTelemetry社区，但想加入的话，现在就是最佳时机！按周提交量和累积提交量计算，OpenTelemetry目前位居CNCF前三名，不管你对项目的提交水平（哈！），都欢迎你的贡献。如果你对某个特定领域感兴趣（例如，Python API + SDK），最好的参与方式是参加相关的每周SIG会议或与Gitter上的其他贡献者进行交互。

https://github.com/open-telemetry/community#calendar

https://gitter.im/open-telemetry/community