OpenTelemetry Python

项目状态

有关项目版本信息和稳定性保证，请在此处找到。

*重大更改

重要

我们正在努力稳定日志信号，这可能需要进行一些弃用和重大更改。我们将尽量减少可能需要更新您的代码的版本，特别是对于仪器或 SDK 开发者。

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

如果您正在寻找有关如何使用 OpenTelemetry API 手动检测代码，或如何设置 OpenTelemetry Python SDK 的示例，请参阅 https://opentelemetry.io/docs/instrumentation/python/manual/。

本项目确保与当前支持的 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

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

pip install opentelemetry-exporter-{exporter}

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

pip install opentelemetry-propagator-{propagator}

要安装这些包的开发版本，请克隆或 fork 本存储库并执行可编辑安装：

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

有关其他 exporter 和 instrumentation 包，请参阅 opentelemetry-python-contrib 存储库。

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

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

会议记录可作为一个公共 Google 文档获取。

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

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

有关荣誉角色的更多信息，请参阅社区存储库。

有关荣誉角色的更多信息，请参阅社区存储库。