OpenTelemetry Python

项目状态

项目版本信息以及稳定性保证可在此处找到。

*破坏性变更

[!IMPORTANT] 我们正在致力于稳定 Log 信号，这需要引入弃用项和破坏性变更。我们将尽量减少可能需要更新代码的发布次数，特别是针对 instrumentation 或 SDK 开发者。

您可以在此处找到 OpenTelemetry Python 的入门指南。

如果您正在寻找如何使用 OpenTelemetry API 手动对代码进行 instrumentation 的示例，或者如何配置 OpenTelemetry Python SDK，请参阅文档。

本项目确保与当前受支持的 Python 版本兼容。随着新 Python 版本的发布，我们将添加对它们的支持；随着旧 Python 版本到达生命周期终点，我们将移除对它们的支持。

我们在新 Python 版本稳定后不超过 3 个月内添加对其的支持。

我们在旧 Python 版本到达其生命周期终点后 6 个月移除对其的支持。

此仓库包含多个可安装的包。opentelemetry-api 包包含抽象类和空操作实现，构成了遵循 OpenTelemetry 规范的 OpenTelemetry API。 opentelemetry-sdk 包是 API 的参考实现。

生成遥测数据的库应仅依赖于 opentelemetry-api，并将 SDK 的选择权留给应用程序开发者。应用程序可以依赖于 opentelemetry-sdk 或另一个实现 API 的包。

API 和 SDK 包可在 Python 包索引（PyPI）上获取。您可以通过 pip 使用以下命令安装它们：

pip install opentelemetry-api
pip install opentelemetry-sdk

The exporter/ 目录包含 OpenTelemetry 导出器包。您可以使用以下命令单独安装这些包：

pip install opentelemetry-exporter-{exporter}

The propagator/ 目录包含 OpenTelemetry propagator 包。您可以使用以下命令单独安装这些包：

pip install opentelemetry-propagator-{propagator}

若要改为安装这些包的开发版本，请克隆或 fork 此仓库并执行可编辑安装：

pip install -e ./opentelemetry-api -e ./opentelemetry-sdk -e ./opentelemetry-semantic-conventions

有关其他导出器和仪表化软件包，请参阅 opentelemetry-python-contrib 仓库。

有关向 OpenTelemetry Python 贡献的信息，请参阅 CONTRIBUTING.md。

我们每周四上午 9 点（太平洋标准时间）举行会议。会议时间可能会根据贡献者的时间安排而有所变动。请查看 OpenTelemetry 社区日历以获取具体日期和 Zoom 会议链接。

会议记录以公开的 Google 文档形式提供。

会议向所有人开放。我们邀请所有人加入我们的会议，无论您的经验水平如何。无论您是经验丰富的 OpenTelemetry 开发者、刚刚开始您的旅程，还是仅仅对我们所做的工作感到好奇，都非常欢迎您参与！

有关维护者角色的更多信息，请参阅社区仓库。

有关审批者角色的更多信息，请参阅社区仓库。

有关 emeritus 角色的更多信息，请参阅 community repository。