Java で Symbol Database を有効にする

Join the Private Beta

ダイナミックインスツルメンテーションプローブ作成時のユーザーエクスペリエンスの改善にご興味がおありですか？こちらから、Symbol Database 非公開データ版に参加しましょう。

Request Access

Symbol Database は、ダイナミックインスツルメンテーションの非公開ベータ版の機能です。

要件

インフラストラクチャーリスト

ダイナミックインスツルメンテーションを有効にしてサービスを実行し、さらに Symbol Database のアップロードを有効にするには:

  1. -Ddd.symbol.database.upload.enabled フラグ、または DD_SYMBOL_DATABASE_UPLOAD_ENABLED 環境変数を true に設定します。
  2. -Ddd.symbol.database.includes フラグ、または DD_SYMBOL_DATABASE_INCLUDES 環境変数を利用しているパッケージのプレフィックス (例: com.datadoghq) に設定します。設定にはカンマ区切りリストを使用し、複数のプレフィックスを追加できます。
  3. 統合サービスタグの 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 ...
    1. Symbol Database を有効にした状態でサービスを起動すると、APM > ダイナミックインスツルメンテーションページで Symbol Database の IDE 同様の機能を利用することができます。