observability-edot-java-instrument は何をしますか？
Elastic Distribution of OpenTelemetry (EDOT) Javaエージェントを使用してJavaアプリケーションを自動トレーシング、メトリクス、ログで計装します。既存のAPMエージェントがないJavaサービスに可観測性を追加する場合に使用します。
概要
Elastic Distribution of OpenTelemetry (EDOT) は、OpenTelemetry SDKとElasticの拡張機能を組み合わせたものです。EDOT Javaエージェントは、コード変更なしでアプリケーションを計装するためのJVMエージェントです。
前提条件
- Java 8以上
- Elastic Observabilityへのアクセス (Elastic Cloudまたはセルフマネージド)
- 認証情報 (APIキーまたはシークレットトークン)
使用方法
1. Elastic Observabilityエンドポイントを確認する
以下の情報を取得してください:
ELASTIC_APM_SERVER_URL: APMサーバーのURL (例:https://my-deployment.apm.us-east-1.aws.cloud.es.io)ELASTIC_APM_SECRET_TOKENまたはELASTIC_APM_API_KEY: 認証のためのシークレットトークンまたはAPIキー
2. エージェントをダウンロードする
EDOT Javaエージェントの最新バージョンをMaven Centralからダウンロードします:
wget https://repo1.maven.org/maven2/co/elastic/otel/elastic-otel-javaagent/1.0.0/elastic-otel-javaagent-1.0.0.jar
3. アプリケーションを起動する
以下のJVM引数を使用してアプリケーションを起動します:
java -javaagent:./elastic-otel-javaagent-1.0.0.jar \
-Dotel.exporter.otlp.endpoint=https://my-deployment.apm.us-east-1.aws.cloud.es.io \
-Dotel.exporter.otlp.headers="Authorization=Bearer my-api-key" \
-jar my-app.jar
環境変数を使用する場合:
export OTEL_EXPORTER_OTLP_ENDPOINT=https://my-deployment.apm.us-east-1.aws.cloud.es.io
export OTEL_EXPORTER_OTLP_HEADERS="Authorization=Bearer my-api-key"
java -javaagent:./elastic-otel-javaagent-1.0.0.jar -jar my-app.jar
設定オプション
| プロパティ | 環境変数 | 説明 |
|---|---|---|
otel.service.name | OTEL_SERVICE_NAME | サービス名 (デフォルト: unknown_service) |
otel.exporter.otlp.endpoint | OTEL_EXPORTER_OTLP_ENDPOINT | OTLPエクスポーターのエンドポイント |
otel.exporter.otlp.headers | OTEL_EXPORTER_OTLP_HEADERS | 認証ヘッダー |