otel-python

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 へのアクセス、トレーサー／メーター／ロガーの使用方法、属性、伝搬、Python ロギングブリッジ（LoggingHandler）について説明しています。
references/instrumentation-libraries.md	ゼロコード（opentelemetry-distro、opentelemetry-bootstrap、opentelemetry-instrument）、contrib カタログ、semconv に準拠した手動計装について説明しています。
references/performance.md	サンプリング、バッチスパンプロセッサー、周期的メトリックリーダー、ビュー、asyncio コンテキスト、エクスポーター、正常なシャットダウンの調整について説明しています。
references/breaking-changes.md	最近の SDK／contrib リリースにおける非推奨／名称変更された API や semconv の変更について、既存コードを監査する場合に使用します。

信頼できる情報源

YAML スキーマの詳細については、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>（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
SDK の CHANGELOG（1.45.1 まで）	WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-python/v1.45.1/CHANGELOG.md
contrib の CHANGELOG（0.66b1 まで）	WebFetch 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 スキル。