website

OpenTelemetry Docs

所属分类:开发者在线工具箱

OpenTelemetry 官方文档:遥测数据采集、概念说明与集成列表

OpenTelemetry Docs 是开源可观测性项目 OpenTelemetry 的官方文档站,说明如何采集、处理和导出 traces、metrics 与 logs 等遥测数据。它适合需要为应用或基础设施接入可观测性能力的开发者与运维人员,也适合在选型前了解相关概念和已有集成。

OpenTelemetry Docs:按语言、概念与组件查阅遥测数据采集说明

发布于 2026年10月18日更新于 2026年10月29日

项目定位

首页把 OpenTelemetry(简称 OTel)定义为与厂商无关的开源可观测性框架,用来生成、收集和导出 traces、metrics 和 logs 等遥测数据。页面称它已获得 90 多家可观测性厂商支持,并被许多库、服务和应用集成。

目录与概念的组织方式

文档左侧目录依次为 What is OpenTelemetry?、Getting Started、Concepts、Demo、Language APIs & SDKs、Platforms、Zero-code Instrumentation、Collector、Blueprints and reference implementations、Compatibility、Specs、Security 和 Contributing。Getting Started 下分为 Dev 与 Ops 两个页面。Concepts 下又分出 Signals(Traces、Metrics、Logs、Baggage、Profiles)、Instrumentation(零代码、代码仪器化与库)、Semantic Conventions、Resources、Sampling 等页面。

OpenTelemetry 文档首页,左侧为文档目录,正文为 OpenTelemetry 简介,下方是 Microservices、Shared Infra、OTel Collector 与 Observability Frontends 等组件之间的数据流示意图

语言版本

页面顶部提供语言切换,链接包括中文(/zh/docs/)、日语、韩语、西班牙语、法语、波兰语、葡萄牙语等多种语言。

生态集成页的用途

Ecosystem 下的 Integrations 页面列出带有官方支持的库、服务和应用。页面分为 Libraries 与 Applications and Services 两张表,表头为名称、是否开源、所属语言或组件,以及了解更多的链接。Libraries 表包含 .NET HttpClient、ASP.NET Core、Quarkus 和 Next.js 的仪器化等条目;Applications 表包含 Argo Workflows、Backstage、containerd、Dapr 和 Deno 等条目。读者若要确认某个工具是否原生支持 OpenTelemetry,可以在这里找到对应条目,再打开其说明链接。

OpenTelemetry Integrations 页面,顶部为黄色的生态列表冻结提示,正文介绍原生支持 OpenTelemetry 的库、服务与应用,下方为 Libraries 与 Applications and Services 两个列表

生态列表暂不接收新条目

Integrations 页面顶部的提示说明,生态列表(包括 registry)目前不再接受新条目和更新,维护者正在讨论这些列表的未来,相关意见可在 GitHub issue #11377 中提出。因此,查找较新的集成时,需要同时核对工具自身的文档。

按接入方式选择路径

Integrations 页面区分了三类接入方式:零代码仪器化方案、仪器化库,以及直接集成 OpenTelemetry API 与 SDK 的应用。页面认为,应用最终应当直接集成 API 与 SDK,或提供与自身扩展生态相配的官方插件。读者可以据此判断自己的项目属于哪一类,再进入对应的 Zero-code Instrumentation 或 Language APIs & SDKs 分区。