mcpField
O
observability-edot-java-migrate

observability-edot-java-migrate

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

observability-edot-java-migrate について

Java アプリケーションを従来の Elastic APM から EDOT に移行する手順を示すスキルです。旧エージェントの置き換え、新しい Java エージェントの適用、OTLP エクスポート設定を行う開発者向けです。

主な機能

  1. 01従来の APM エージェントと設定の削除
  2. 02elastic-otel-javaagent.jar の使用
  3. 03-javaagent または JAVA_TOOL_OPTIONS で適用
  4. 04OTLP エンドポイントと認証ヘッダーの設定
  5. 05同一 JVM での両エージェント併用の回避

活用シーン

  1. 01Java サービスを従来の Elastic APM から EDOT に移行
  2. 02EDOT Java エージェントを読み込む JVM の設定
  3. 03テレメトリーのサービス名、エンドポイント、認証の設定

インストール

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

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

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

詳細

EDOT Java の移行

変更を加える前に、移行ガイドをお読みください。

ガイドライン

  1. クラシック APM に関する参照をすべて削除します。elastic-apm-agent.jar、elasticapm.properties、すべての ELASTIC_APM_* 環境変数、および co.elastic.apm の Maven／Gradle 依存関係が対象です。
  2. elastic-otel-javaagent.jar を使用します（Maven Central からダウンロードしてください。Maven／Gradle のコンパイル依存関係にはしないでください）。
  3. -javaagent:/path/to/elastic-otel-javaagent.jar または JAVA_TOOL_OPTIONS="-javaagent:/path/to/elastic-otel-javaagent.jar" を使ってアタッチします。これを指定しないと、エージェントは何もしません。
  4. 必須の環境変数を正確に3つ設定します。
    • OTEL_SERVICE_NAME（ELASTIC_APM_SERVICE_NAME を置き換えます）
    • OTEL_EXPORTER_OTLP_ENDPOINT — マネージド OTLP エンドポイントまたは EDOT Collector の URL を指定する必要があります。古い ELASTIC_APM_SERVER_URL の値を再利用しないでください。APM Server の URL は使用しないでください（apm-server、:8200、/intake/v2/events を含まないもの）。
    • OTEL_EXPORTER_OTLP_HEADERS — "Authorization=ApiKey <key>" または "Authorization=Bearer <token>" を指定します（ELASTIC_APM_SECRET_TOKEN／API_KEY を置き換えます）。
  5. OTEL_TRACES_EXPORTER、OTEL_METRICS_EXPORTER、OTEL_LOGS_EXPORTER は設定しないでください。デフォルトがすでに適切です。
  6. 同じ JVM 上で、クラシック Elastic APM エージェントと EDOT エージェントを同時に実行しないでください。

例

詳しい例は、EDOT Java の移行ガイドをご覧ください。

コメント

Markdown 対応