Java で Symbol Database を有効にする
Join the Private Beta
ダイナミックインスツルメンテーションプローブ作成時のユーザーエクスペリエンスの改善にご興味がおありですか?こちらから、Symbol Database 非公開データ版に参加しましょう。
Request AccessSymbol Database は、ダイナミックインスツルメンテーションの非公開ベータ版の機能です。
要件
インフラストラクチャーリスト
ダイナミックインスツルメンテーションを有効にしてサービスを実行し、さらに Symbol Database のアップロードを有効にするには:
-Ddd.symbol.database.upload.enabled
フラグ、または DD_SYMBOL_DATABASE_UPLOAD_ENABLED
環境変数を true
に設定します。-Ddd.symbol.database.includes
フラグ、または DD_SYMBOL_DATABASE_INCLUDES
環境変数を利用しているパッケージのプレフィックス (例: com.datadoghq
) に設定します。設定にはカンマ区切りリストを使用し、複数のプレフィックスを追加できます。- 統合サービスタグの
dd.service
と dd.version
を指定します。
サービス起動コマンドの例:
java \
-javaagent:dd-java-agent.jar \
-Ddd.service=<YOUR_SERVICE> \
-Ddd.env=<YOUR_ENVIRONMENT> \
-Ddd.version=<YOUR_VERSION> \
-Ddd.dynamic.instrumentation.enabled=true \
-Ddd.symbol.database.upload.enabled=true \
-Ddd.symbol.database.includes=<YOUR_PACKAGE_PREFIX> \
-jar <YOUR_SERVICE>.jar <YOUR_SERVICE_FLAGS>
export DD_SERVICE=<YOUR_SERVICE>
export DD_ENV=<YOUR_ENV>
export DD_VERSION=<YOUR_VERSION>
export DD_DYNAMIC_INSTRUMENTATION_ENABLED=true
export DD_SYMBOL_DATABASE_UPLOAD_ENABLED=true
export DD_SYMBOL_DATABASE_INCLUDES=<YOUR_PACKAGE_PREFIX>
java \
-javaagent:dd-java-agent.jar \
-jar <YOUR_SERVICE>.jar <YOUR_SERVICE_FLAGS>
注: -javaagent
引数は -jar
ファイルより前にあり、アプリケーション引数ではなく JVM オプションとして追加される必要があります。詳しくは、Oracle ドキュメントを参照してください。
# Correct:
$ java -javaagent:dd-java-agent.jar ... -jar my-service.jar -more-flags
# Incorrect:
$ java -jar my-service.jar -javaagent:dd-java-agent.jar ...
- Symbol Database を有効にした状態でサービスを起動すると、APM > ダイナミックインスツルメンテーションページで Symbol Database の IDE 同様の機能を利用することができます。