Repolode
提交项目
open-telemetry

open-telemetry/opentelemetry-python

OpenTelemetry 的 Python API 与 SDK，用于采集应用的链路追踪、指标和日志数据。

在 GitHub 查看官网
Star
2,702
Fork
1,059
未关闭 Issue
428
最近提交
19小时前

这是什么？

OpenTelemetry Python 是 OpenTelemetry 可观测性标准的 Python 实现。它提供用于在代码中埋点、采集链路追踪、指标和日志的 API，以及作为该 API 参考实现的 SDK，负责遥测数据的采样、处理和导出。

项目按包拆分。产生遥测数据的库只需依赖 opentelemetry-api，SDK 的选择交给应用开发者。仓库内同时包含 exporter 和 propagator 包，API 与 SDK 发布在 PyPI 上。目前链路追踪和指标已标记为稳定，日志仍处于开发阶段。

对于希望把 Python 服务的遥测数据发送到任意兼容 OpenTelemetry 的后端、又不想把代码绑定到某个厂商的团队，这个项目较为合适。常用框架的自动埋点库则在 opentelemetry-python-contrib 仓库中单独维护。

核心功能

  • 01提供与厂商无关的链路追踪、指标和日志 API。
  • 02包含参考 SDK，用于处理和导出遥测数据。
  • 03API 与 SDK 分离，库作者无需选择后端即可产生遥测数据。
  • 04exporter 与 propagator 包可通过 pip 单独安装。
  • 05跟随 Python 版本演进，并在旧版本结束生命周期后移除支持。

适用场景

  • 为 Python Web 服务添加埋点，追踪跨分布式系统的请求链路。
  • 将应用指标导出到兼容 OpenTelemetry 的监控后端。
  • 开发会产生遥测数据的 Python 库，同时把 SDK 的选择留给使用者。

快速上手

  1. 1

    从 PyPI 安装 API 包

    pip install opentelemetry-api
  2. 2

    从 PyPI 安装 SDK 包

    pip install opentelemetry-sdk

使用前须知

  • 日志信号仍处于开发阶段，可能出现破坏性变更。

收录于专题

OpenTelemetry 与可观测性平台

标签

#opentelemetry#observability#distributed-tracing#metrics#logging#python#sdk#correlationcontext#tracecontext

常见问题

opentelemetry-python 是什么？
OpenTelemetry 的 Python API 与 SDK，用于采集应用的链路追踪、指标和日志数据。 OpenTelemetry Python 是 OpenTelemetry 可观测性标准的 Python 实现。它提供用于在代码中埋点、采集链路追踪、指标和日志的 API，以及作为该 API 参考实现的 SDK，负责遥测数据的采样、处理和导出。
opentelemetry-python 可以免费使用吗？用的什么许可证？
opentelemetry-python 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。
opentelemetry-python 还在维护吗？
活跃维护中。opentelemetry-python 最近一次提交是在 2026年11月6日。
opentelemetry-python 适合用来做什么？
为 Python Web 服务添加埋点，追踪跨分布式系统的请求链路。 将应用指标导出到兼容 OpenTelemetry 的监控后端。 开发会产生遥测数据的 Python 库，同时把 SDK 的选择留给使用者。
opentelemetry-python 怎么安装和运行？
从 PyPI 安装 API 包: pip install opentelemetry-api 从 PyPI 安装 SDK 包: pip install opentelemetry-sdk
在哪里获取 opentelemetry-python？
源代码和安装说明在 GitHub 上：https://github.com/open-telemetry/opentelemetry-python

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目