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 导出器包。您可以使用以下命令单独安装这些包：

pip install opentelemetry-exporter-{exporter}

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

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 文档中查阅。

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

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

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

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