用途:这是 OpenTelemetry 在 Python 服务中落地的机制入口,按具体任务加载对应参考文档,每份参考相对独立。
主要能力(按参考文件):declarative-setup.md 介绍用声明式 YAML 配置 SDK(opentelemetry-configuration / opentelemetry.configuration),涉及 load_config_file、configure_sdk、file_format、环境变量替换、OTEL_CONFIG_FILE 及程序化激活;api.md 覆盖导入路径、全局 API 访问、tracer/meter/logger 用法、attributes、propagation,以及 Python 日志桥接 LoggingHandler;instrumentation-libraries.md 覆盖零代码方案(opentelemetry-distro、opentelemetry-bootstrap、opentelemetry-instrument)、contrib 目录与遵循 semconv 的手动埋点;performance.md 涉及采样、批量 span 处理器、周期性指标读取器、views、asyncio context、导出器与优雅关闭的调优;breaking-changes.md 用于审计既有代码中已弃用或改名的 API 及近期 SDK/contrib 发布中的 semconv 变更。
使用方式:按任务选择上述参考文件。文档还列出事实来源,可用 WebFetch 查询 PyPI JSON 接口获取 opentelemetry-sdk、opentelemetry-configuration、opentelemetry-distro、opentelemetry-instrumentation-<pkg>、opentelemetry-exporter-otlp 的最新版本,并可拉取 v1.45.0 的声明式配置 README、schema.json、SDK CHANGELOG、contrib CHANGELOG 及 Python getting-started 文档。
交叉引用:schema 级事实见 otel-declarative-config 技能;跨语言 SDK 版本选择见 otel-sdk-versions;语义约定查询见 otel-semantic-conventions。
限制:资料未提供具体安装命令、价格、支持平台与效果数据,上述内容暂未提供。