Python

OpenTelemetry 的 Python 实现。

这是 OpenTelemetry Python 文档。OpenTelemetry 是一个可观测性框架——它包含 API、SDK 和工具，旨在帮助生成和收集应用程序遥测数据，如指标、日志和跟踪。本手册旨在帮助您了解如何开始使用 OpenTelemetry Python。

状态和版本

OpenTelemetry Python 主要功能组件的当前状态如下

有关发行版（包括 最新发行版）的信息，请参阅 发行版。

版本支持

OpenTelemetry-Python 支持 Python 3.9 及更高版本。

安装

API 和 SDK 包可在 PyPI 上找到，可以通过 pip 安装

pip install opentelemetry-api
pip install opentelemetry-sdk

此外，还有几个扩展包可以单独安装，例如

pip install opentelemetry-exporter-{exporter}
pip install opentelemetry-instrumentation-{instrumentation}

这些分别用于导出器和仪器库。Jaeger、Zipkin、Prometheus、OTLP 和 OpenCensus 导出器可以在仓库的 exporter 目录中找到。仪器库和其他导出器可以在 contrib 仓库的 instrumentation 和 exporter 目录中找到。

扩展

要查找相关项目，例如导出器、仪器库、跟踪器实现等，请访问 注册表。

安装最新软件包

有些功能尚未发布到 PyPI。在这种情况下，您可能需要直接从仓库安装这些包。这可以通过克隆仓库并执行 可编辑安装 来完成

git clone https://github.com/open-telemetry/opentelemetry-python.git
cd opentelemetry-python
pip install -e ./opentelemetry-api -e ./opentelemetry-sdk -e ./opentelemetry-semantic-conventions

仓库和基准测试

• 主仓库：opentelemetry-python
• Contrib 仓库：opentelemetry-python-contrib