博客 on OpenTelemetry

宣布启动 RPC 语义约定稳定性项目

Thu, 03 Jul 2025 14:36:48 +0800

语义约定 SIG 很高兴宣布正式启动 RPC 稳定性推进工作！

继 2025 年 5 月数据库语义约定完成稳定后，我们将继续推进关键领域的标准化，而 RPC 是下一个重点。

要制定出坚实的约定，尤其在像 RPC 这样技术多样的领域，需要集体协作。RPC 涵盖了 gRPC、JSON-RPC、Apache Dubbo 等众多框架。如果你正在使用或开发这些框架，或对它们感兴趣，欢迎加入我们的工作 —— 我们非常欢迎你的参与！

致力于构建可靠的遥测约定

可靠、定义清晰的约定是构建丰富遥测体验的前提。当信号和属性名称保持一致时，开发者就能专注于构建告警、仪表板和可视化，而不是应对由不兼容变更引发的问题。

现有的实验性约定已被使用了一段时间，我们也意识到对相关探针做出破坏性更改将带来干扰。

但我们坚信，从长远来看，这些更改对于实现高质量、可操作的遥测数据是必不可少的。

为了平稳过渡，我们将遵循一项温和迁移计划。各类探针库将：

将新语义约定作为“可选开启”功能与现有约定并行提供；
在较长一段时间内同时支持新旧两个版本；
提供详细的迁移指南。

语义约定如何完成“稳定”？

在稳定化阶段，我们将审查现有约定，确保它们能为大多数应用提供有意义的洞察。我们会验证这些约定是否支持通用探针实现，且在性能、隐私、遥测体积、一致性以及与应用层或传输层遥测的关联性方面达成合理平衡。

我们追求“有用、可用、可扩展”的语义约定。

关于 RPC，我方将聚焦以下关键领域：

核心信号：定义一套核心遥测信号（如 client/server span 及调用时延直方图），可在不同框架中一致记录，支持常见调试流程和 RED 指标（请求率、错误率、延迟）。我们将审查现有约定，识别关键属性，并文档化其通用定义与框架特定实现。
框架特定遥测：我们鼓励各框架在通用约定基础上，扩展其特有属性、span 或指标。例如社区维护的 gRPC metrics。我们也将审查这些扩展内容。
适用范围：双向流式调用天然存在可观测性限制，我们将评估哪些信号具有现实可行性。
一致性与最佳实践：我们过去几年在命名、记录对端信息和错误方面积累了不少最佳实践， RPC 约定也将对齐这些新准则。
原型验证：要完成稳定，必须有符合约定的真实世界探针或原型。这些实现能帮助验证约定的清晰度、可行性和实际价值，也能确保它们适用于不同的库和协议。

如何参与？

我们正在寻找熟悉任何主流 RPC 框架的开发者，也欢迎希望参与原型探针开发的贡献者。如果你有兴趣参与，请在 RPC 稳定化项目提案下留言，与我们一同推进这个项目。

需要采取的行动 - Slack 工作区将于 6 月 20 日（星期五）进行变更

Thu, 03 Jul 2025 14:36:48 +0800

昨天，云原生计算基金会（CNCF）发布公告，表示 CNCF 的 Slack 工作区将于 2025 年 6 月 20 日（星期五） 从企业版转换为免费版。这将对 OpenTelemetry 社区使用 Slack 的方式产生一些影响，包括我们需要注意的若干限制；不过，我们预计此次变更不会对我们的协作造成根本性影响。

虽然 OpenTelemetry 社区在 Slack 工作区中的访问权限不会中断，但所有用户和项目贡献者应考虑采取以下操作：

导出私密频道历史记录和私信内容。 免费版 Slack 仅保留过去 90 天的消息记录。到了星期五，您将无法访问超过 90 天的历史消息。CNCF 将备份所有公开频道的历史记录。如果您有想要保留的私密频道或私信内容，请根据 CNCF 提供的指南导出并在本地保存内容。
备份文件。 如果您在 Slack 中保存了文件，这些文件将会被删除！请在星期五之前下载并保存至 GitHub 或 Google Docs。
保存置顶消息。 如果您在置顶消息中保存了重要信息，可能在星期五之后将无法再访问。请复制这些信息并存储到 GitHub 或 Google Docs 中，并为频道添加一个书签指向该位置。

有关细节请参阅 CNCF 的博客文章。如有问题或想参与讨论，请加入 #slack-faq 频道。

OpenTelemetry 网站支持多语言！

Sat, 02 Nov 2024 13:01:16 -0400

我们很高兴地宣布，OpenTelemetry 网站现已提供多种语言版本！本地化团队已经开始将网站页面翻译成中文、日语、葡萄牙语以及西班牙语。

OpenTelemetry 项目已发展壮大，包括来自世界各地的贡献者和用户。提供多种语言的网站是确保每个人（无论其母语是什么）都能为项目做出贡献的重要一步。我们也很高兴这一举措让最终用户可以访问多语言文档，从而更轻松地学习和理解 OpenTelemetry。

要以您的首选语言访问网站，请使用页面右上角的语言选择菜单。我们邀请您为此做出贡献。您可以在 #otel-docs-localization Slack 频道中找到其他本地化贡献者。如果您精通已支持的语言，您可以通过编写或审阅翻译来提供帮助。如果您的语言尚不受支持，并且您想帮忙翻译，请创建一个 Issue。

您的贡献会产生重要的影响！

我们感谢所有的贡献者使之成为可能，并且我们期待看到这些新的语言选项可以改善 OpenTelemetry 的用户体验。