mcpField
O
observability-edot-java-instrument

observability-edot-java-instrument

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

observability-edot-java-instrument について

Elastic Distribution of OpenTelemetry（EDOT）による Java 計装の設定を支援するスキルです。エージェントの適用方法や OTLP 設定、従来の Elastic APM エージェントとの併用回避を案内します。

主な機能

  1. 01Java エージェントの適用
  2. 02必須 OTLP 環境変数の設定
  3. 03管理 OTLP エンドポイントまたは EDOT Collector の使用
  4. 04Elastic エージェントの同時実行回避

活用シーン

  1. 01Java アプリケーションへの EDOT 計装
  2. 02Java サービスのテレメトリー出力設定

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/elastic/agent-skills --skill observability-edot-java-instrument

インストール後、Claude Code で/observability-edot-java-instrumentを入力して読み込まれたか確認します。

詳細

EDOT Java インストルメンテーション

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

ガイドライン

  1. elastic-otel-javaagent.jar を使用します（Maven Central からダウンロードしてください。Maven/Gradle のコンパイル依存関係としては使用しないでください）
  2. -javaagent:/path/to/elastic-otel-javaagent.jar または JAVA_TOOL_OPTIONS="-javaagent:/path/to/elastic-otel-javaagent.jar" を指定してアタッチします。これを指定しないと、エージェントは機能しません。
  3. 必須の環境変数を正確に 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>"
  4. OTEL_TRACES_EXPORTER、OTEL_METRICS_EXPORTER、OTEL_LOGS_EXPORTER は設定しないでください。デフォルト値はすでに正しく設定されています。
  5. 同じ JVM 上で、従来の Elastic APM エージェントと EDOT エージェントを同時に実行しないでください。

例

Dockerfile と docker-compose の完全な例については、EDOT Java セットアップガイドをご覧ください。

コメント

Markdown 対応