otel-python

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Chinese

Entry point for OpenTelemetry mechanics in Python services. Load a reference below based on the task; each reference is self-contained.

Python 服务中 OpenTelemetry 机制的入口。根据任务加载下方的参考文档；每个参考文档都是独立完整的。

File	Use when
`references/declarative-setup.md`	Configuring the SDK via declarative YAML ( `opentelemetry-configuration` / `opentelemetry.configuration` ): `load_config_file` , `configure_sdk` , `file_format` , env substitution, `OTEL_CONFIG_FILE` and programmatic activation.
`references/api.md`	Import paths, global API access, tracer/meter/logger usage, attributes, propagation, the Python logging bridge ( `LoggingHandler` ).
`references/instrumentation-libraries.md`	Zero-code ( `opentelemetry-distro` , `opentelemetry-bootstrap` , `opentelemetry-instrument` ), the contrib catalog, and manual instrumentation following semconv.
`references/performance.md`	Tuning sampling, batch span processor, periodic metric reader, views, asyncio context, exporters, graceful shutdown.
`references/breaking-changes.md`	Auditing existing code for deprecated/renamed APIs and semconv changes across recent SDK/contrib releases.

文件	使用场景
`references/declarative-setup.md`	通过声明式 YAML 配置 SDK（ `opentelemetry-configuration` / `opentelemetry.configuration` ）： `load_config_file` 、 `configure_sdk` 、文件格式、环境变量替换、 `OTEL_CONFIG_FILE` 以及程序化激活。
`references/api.md`	导入路径、全局 API 访问、tracer/meter/logger 使用、属性、传播、Python 日志桥接器（ `LoggingHandler` ）。
`references/instrumentation-libraries.md`	零代码方案（ `opentelemetry-distro` 、 `opentelemetry-bootstrap` 、 `opentelemetry-instrument` ）、社区贡献插件目录，以及遵循语义规范的手动插桩。
`references/performance.md`	调优采样、批量跨度处理器、定期指标读取器、视图、asyncio 上下文、导出器、优雅关闭。
`references/breaking-changes.md`	检查现有代码中已弃用/重命名的 API，以及近期 SDK/社区贡献版本中的语义规范变更。

For YAML schema details, fetch the upstream sources listed in the

otel-declarative-config

skill. For Python-specific facts:

Fact	Fetch
Latest `opentelemetry-sdk` / `opentelemetry-api`	`WebFetch https://pypi.org/pypi/opentelemetry-sdk/json` ( `.info.version` )
Latest `opentelemetry-configuration`	`WebFetch https://pypi.org/pypi/opentelemetry-configuration/json`
Latest `opentelemetry-distro`	`WebFetch https://pypi.org/pypi/opentelemetry-distro/json`
Latest `opentelemetry-instrumentation-<pkg>` (contrib)	`WebFetch https://pypi.org/pypi/opentelemetry-instrumentation-<pkg>/json`
Latest OTLP exporter	`WebFetch https://pypi.org/pypi/opentelemetry-exporter-otlp/json`
Declarative config support (released 1.44.0 overview)	`WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-python/v1.44.0/opentelemetry-configuration/README.rst`
Declarative config vendored schema (released 1.44.0)	`WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-python/v1.44.0/opentelemetry-configuration/src/opentelemetry/configuration/schema.json`
SDK CHANGELOG through 1.44.0	`WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-python/v1.44.0/CHANGELOG.md`
Contrib CHANGELOG through 0.65b0	`WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-python-contrib/v0.65b0/CHANGELOG.md`
Python getting-started docs	`WebFetch https://opentelemetry.io/docs/languages/python/getting-started/`

如需了解 YAML schema 细节，请查阅

otel-declarative-config

技能中列出的上游来源。针对 Python 相关信息：

信息	获取方式
最新版 `opentelemetry-sdk` / `opentelemetry-api`	`WebFetch https://pypi.org/pypi/opentelemetry-sdk/json` （ `.info.version` ）
最新版 `opentelemetry-configuration`	`WebFetch https://pypi.org/pypi/opentelemetry-configuration/json`
最新版 `opentelemetry-distro`	`WebFetch https://pypi.org/pypi/opentelemetry-distro/json`
最新版 `opentelemetry-instrumentation-<pkg>` （社区贡献）	`WebFetch https://pypi.org/pypi/opentelemetry-instrumentation-<pkg>/json`
最新版 OTLP 导出器	`WebFetch https://pypi.org/pypi/opentelemetry-exporter-otlp/json`
声明式配置支持（1.44.0 版本概述）	`WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-python/v1.44.0/opentelemetry-configuration/README.rst`
声明式配置内置 schema（1.44.0 版本）	`WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-python/v1.44.0/opentelemetry-configuration/src/opentelemetry/configuration/schema.json`
SDK 变更日志（截至 1.44.0 版本）	`WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-python/v1.44.0/CHANGELOG.md`
社区贡献变更日志（截至 0.65b0 版本）	`WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-python-contrib/v0.65b0/CHANGELOG.md`
Python 入门文档	`WebFetch https://opentelemetry.io/docs/languages/python/getting-started/`

Schema-level facts:
```
otel-declarative-config
```
skill (language-agnostic YAML schema sources).
SDK version selection across languages:
```
otel-sdk-versions
```
skill.
Semantic conventions lookup:
```
otel-semantic-conventions
```
skill.