mcpField
O
observability-edot-python-instrument

observability-edot-python-instrument

github.com/elasticクラウド・DevOps6022.7k 回インストール今日更新
リポジトリ

observability-edot-python-instrument について

アプリケーションのテレメトリー向けに EDOT Python の自動計装を設定するスキルです。Python サービスを計装する開発者を対象とし、コード内の SDK 設定ではなく環境変数による構成を重視します。

主な機能

  1. 01`elastic-opentelemetry` のインストール
  2. 02検出されたライブラリの計装を準備
  3. 03アプリケーション起動コマンドのラップ
  4. 04必須 OTLP 環境変数の設定
  5. 05エクスポーターと classic `elastic-apm` の競合回避

活用シーン

  1. 01デプロイ時の Python アプリケーション計装
  2. 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 の計装

変更を加える前に、セットアップガイドをお読みください。

ガイドライン

  1. elastic-opentelemetry を pip 経由でインストールします(requirements.txt または同等のファイルに追加します)。
  2. イメージのビルド時に edot-bootstrap --action=install を実行し、検出されたライブラリ用の自動計装パッケージをインストールします。
  3. アプリケーションのエントリーポイントを opentelemetry-instrument でラップします。例:opentelemetry-instrument gunicorn app:app または opentelemetry-instrument python app.py。これを行わないと、テレメトリは収集されません。
  4. 必須の環境変数を正確に3つ設定します。
    • OTEL_SERVICE_NAME
    • OTEL_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>"
  5. OTEL_TRACES_EXPORTER、OTEL_METRICS_EXPORTER、OTEL_LOGS_EXPORTER は設定しないでください。デフォルト値はすでに 適切です。
  6. コードレベルで SDK を設定するコード(TracerProvider、configure_azure_monitor など)は追加しないでください。 opentelemetry-instrument がすべて処理します。
  7. 同じアプリケーションで、従来の elastic-apm と EDOT を同時に実行しないでください。

例

完全な例については、EDOT Python セットアップガイドをご覧ください。

コメント