mcpField
O
otel-python

otel-python

github.com/ollygarden开发117109 次安装2 天前更新
代码仓库

关于 otel-python

面向在 Python 服务中使用 OpenTelemetry 的工程师的参考技能，按任务提供 SDK 配置、插桩、性能、API 和变更指南。

主要功能

  1. 01声明式 YAML 配置指导
  2. 02Python API 与日志桥接参考
  3. 03零代码及手动插桩指导
  4. 04采样与性能调优
  5. 05弃用 API 和变更审查

适用场景

  1. 01使用 YAML 配置 SDK
  2. 02为 Python 服务添加插桩
  3. 03调整遥测处理
  4. 04检查代码中的 API 变更

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/ollygarden/opentelemetry-agent-skills --skill otel-python

安装后在 Claude Code 中输入/otel-python确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
api.md
breaking-changes.md
declarative-setup.md
instrumentation-libraries.md
performance.md

详细介绍

Python 中的 OpenTelemetry

Python 服务中 OpenTelemetry 机制的入口。根据任务加载下面的参考资料；每份参考资料均可独立使用。

参考资料

文件适用场景
references/declarative-setup.md通过声明式 YAML（opentelemetry-configuration / opentelemetry.configuration）配置 SDK：load_config_file、configure_sdk、file_format、环境变量替换、OTEL_CONFIG_FILE 和编程式激活。
references/api.md导入路径、全局 API 访问、tracer/meter/logger 的用法、属性、传播、Python 日志桥接（LoggingHandler）。
references/instrumentation-libraries.md零代码（opentelemetry-distro、opentelemetry-bootstrap、opentelemetry-instrument）、contrib 目录，以及遵循 semconv 的手动插桩。
references/performance.md调整采样、批量 span 处理器、周期性指标读取器、视图、asyncio 上下文、导出器、优雅关闭。
references/breaking-changes.md审查现有代码中的弃用/重命名 API，以及近期 SDK/contrib 版本中的 semconv 变更。

权威来源

有关 YAML 架构的详情，请获取 otel-declarative-config 技能中列出的上游来源。 有关 Python 的具体信息：

信息获取方式
最新的 opentelemetry-sdk / opentelemetry-apiWebFetch https://pypi.org/pypi/opentelemetry-sdk/json（.info.version）
最新的 opentelemetry-configurationWebFetch https://pypi.org/pypi/opentelemetry-configuration/json
最新的 opentelemetry-distroWebFetch https://pypi.org/pypi/opentelemetry-distro/json
最新的 opentelemetry-instrumentation-<pkg>（contrib）WebFetch https://pypi.org/pypi/opentelemetry-instrumentation-<pkg>/json
最新的 OTLP 导出器WebFetch https://pypi.org/pypi/opentelemetry-exporter-otlp/json
声明式配置支持（1.45.1 版概述；已于 2026-10-25 验证）WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-python/v1.45.1/opentelemetry-configuration/README.rst
声明式配置随附的架构（1.45.1 版）WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-python/v1.45.1/opentelemetry-configuration/src/opentelemetry/configuration/schema.json
截至 1.45.1 版的 SDK CHANGELOGWebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-python/v1.45.1/CHANGELOG.md
截至 0.66b1 版的 Contrib CHANGELOGWebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-python-contrib/v0.66b1/CHANGELOG.md
Python 入门文档WebFetch https://opentelemetry.io/docs/languages/python/getting-started/

交叉参考

  • 架构层面的信息：otel-declarative-config 技能（语言无关的 YAML 架构来源）。
  • 跨语言的 SDK 版本选择：otel-sdk-versions 技能。
  • 语义约定查询：otel-semantic-conventions 技能。

评论

支持 Markdown