observability-edot-python-instrument について
アプリケーションのテレメトリー向けに EDOT Python の自動計装を設定するスキルです。Python サービスを計装する開発者を対象とし、コード内の SDK 設定ではなく環境変数による構成を重視します。
主な機能
- 01`elastic-opentelemetry` のインストール
- 02検出されたライブラリの計装を準備
- 03アプリケーション起動コマンドのラップ
- 04必須 OTLP 環境変数の設定
- 05エクスポーターと classic `elastic-apm` の競合回避
活用シーン
- 01デプロイ時の Python アプリケーション計装
- 02マネージド OTLP エンドポイントまたは EDOT Collector へのテレメトリー送信設定
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ elastic/ agent-skills --skill observability-edot-python-instrumentインストール後、Claude Code で/observability-edot-python-instrumentを入力して読み込まれたか確認します。
詳細
EDOT Python の計装
変更を加える前に、セットアップガイドをお読みください。
ガイドライン
elastic-opentelemetryを pip 経由でインストールします(requirements.txtまたは同等のファイルに追加します)。- イメージのビルド時に
edot-bootstrap --action=installを実行し、検出されたライブラリ用の自動計装パッケージをインストールします。 - アプリケーションのエントリーポイントを
opentelemetry-instrumentでラップします。例:opentelemetry-instrument gunicorn app:appまたはopentelemetry-instrument python app.py。これを行わないと、テレメトリは収集されません。 - 必須の環境変数を正確に3つ設定します。
OTEL_SERVICE_NAMEOTEL_EXPORTER_OTLP_ENDPOINT— 管理対象の OTLP エンドポイントまたは EDOT Collector の URL を指定する必要があります。APM Server の URL は使用しないでください(apm-server、:8200、/intake/v2/eventsは使用不可)。OTEL_EXPORTER_OTLP_HEADERS—"Authorization=ApiKey <key>"または"Authorization=Bearer <token>"
OTEL_TRACES_EXPORTER、OTEL_METRICS_EXPORTER、OTEL_LOGS_EXPORTERは設定しないでください。デフォルト値はすでに 適切です。- コードレベルで SDK を設定するコード(
TracerProvider、configure_azure_monitorなど)は追加しないでください。opentelemetry-instrumentがすべて処理します。 - 同じアプリケーションで、従来の
elastic-apmと EDOT を同時に実行しないでください。
例
完全な例については、EDOT Python セットアップガイドをご覧ください。
コメント
Markdown 対応