プロファイラのトラブルシューティング

プロファイル検索ページにないプロファイル

プロファイラを設定してもプロファイル検索ページにプロファイルが表示されない場合は、デバッグモードをオンにし、デバッグファイルと次の情報でサポートチケットを開いてください。

オペレーティングシステムのタイプとバージョン (例: Linux Ubuntu 14.04.3)
ランタイムのタイプ、バージョン、ベンダー (例: Java OpenJDK 11 AdoptOpenJDK)

プロファイルからの機密情報の削除

システムプロパティにユーザー名やパスワードなどの機密情報が含まれている場合は、jdk.InitialSystemProperty を無効にして jfp オーバーライドテンプレートファイルを作成し、システムプロパティイベントをオフにします。

example-template.jfp

jdk.InitialSystemProperty#enabled=false

オーバーライドテンプレートの使用方法を学ぶ。

プロファイラを圧倒する大きな割り当て

割り当てプロファイリングをオフにするには、jfp オーバーライドテンプレートファイルで次のイベントを無効にします。

example-template.jfp

jdk.ObjectAllocationInNewTLAB#enabled=false
jdk.ObjectAllocationOutsideTLAB#enabled=false

オーバーライドテンプレートの使用方法を学ぶ。

プロファイラを圧倒する例外

Datadog 例外プロファイラは通常の条件下では、フットプリントとオーバーヘッドが小さくなります。ただし、多くの例外が作成されてスローされると、プロファイラに大きなオーバーヘッドが発生することがあります。これは、コントロールフローに例外を使用した場合などに発生する可能性があります。例外率が異常に高い場合は、例外の原因を修正するまで、例外プロファイリングを一時的にオフにします。

例外プロファイリングを無効にするには、-Ddd.integration.throwables.enabled=false JVM 設定でトレーサーを開始します。

より一般的な例外率に戻った後は、この設定をオンに戻すことを忘れないでください。

Java 8 のサポート

次の OpenJDK 8 ベンダーでは、最新バージョンに JDK Flight Recorder が含まれているため、Continuous Profiling がサポートされます。

ベンダー	Flight Recorder を含む JDK バージョン
Azul	u212 (u262 推奨)
AdoptOpenJDK	u262
RedHat	u262
Amazon (Corretto)	u262
Bell-Soft (Liberica)	u262
すべてのベンダーのアップストリームビルド	u272

ベンダーがリストにない場合は、サポートチケットを開いてください。サポートを計画しているかどうか、またはすでにベータサポートを提供しているかどうかをお知らせします。

JFR テンプレートオーバーライドファイルの作成と使用

オーバーライドテンプレートを使用すると、オーバーライドするプロファイリングプロパティを指定できます。ただし、デフォルトでは、オーバーヘッドとデータ密度の間でトレードオフのバランスを程よく保ち、大部分のユースケースに対応できるように設定されています。オーバーライドファイルを使用するには、次のステップを実行します。

アクセス可能なディレクトリで、サービスの起動時に dd-java-agent を使用して、オーバーライドファイルを作成します。
```
touch dd-profiler-overrides.jfp
```
必要なオーバーライドファイルを jfp ファイルに追加します。たとえば、割り当てプロファイリングと JVM システムプロパティを無効にする場合、dd-profiler-overrides.jfp ファイルは次のようになります。
example-template.jfp
```
    jdk.ObjectAllocationInNewTLAB#enabled=false
    jdk.ObjectAllocationOutsideTLAB#enabled=false
    jdk.InitialSystemProperty#enabled=false
    
```
アプリケーションを dd-java-agent で実行している場合は、サービスの起動時に -Ddd.profiling.jfr-template-override-file=</path/to/override.jfp> を使用してオーバーライドファイルを指定する必要があります。たとえば、次のようになります。
example-template.jfp
```
    java -javaagent:/path/to/dd-java-agent.jar -Ddd.profiling.enabled=true -Ddd.logs.injection=true -Ddd.trace.sample.rate=1 -Ddd.profiling.jfr-template-override-file=</path/to/override.jfp> -jar path/to/your/app.jar
    
```

その他の参考資料

お役に立つドキュメント、リンクや記事:

APM トラブルシューティングDOCUMENTATION