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 点 (PST) 开会。会议可能会根据贡献者的可用性进行更改。请查看 OpenTelemetry 社区日历了解具体日期和 Zoom 会议链接。

会议记录可在公开的 Google 文档中找到。

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

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

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

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