Java サービスのプロファイリングを有効にすると、Code Hotspots の識別がデフォルトで有効化されます。手動でインスツルメントされたコードの場合、Continuous Profiler はスパンのスコープをアクティブにする必要があります。

final Span span = tracer.buildSpan("ServicehandlerSpan").start();
try (final Scope scope = tracer.activateSpan(span)) { // mandatory for Datadog continuous profiler to link with span
    // worker thread impl
  } finally {
    // Step 3: Finish Span when work is complete
    span.finish();
  }

Python サービスのプロファイリングを起動すると、コードのホットスポット識別がデフォルトで有効化されます。

dd-trace-py バージョン 0.44.0+ が必要です。

Ruby サービスのプロファイリングを起動すると、コードのホットスポット識別がデフォルトで有効化されます。

新しいタイムライン機能 (ベータ版) を有効にするには

• dd-trace-rb 1.15 以上にアップグレードする
• DD_PROFILING_EXPERIMENTAL_TIMELINE_ENABLED=true に設定する

Linux と macOS で Node.js サービスのプロファイリングを有効にすると、Code Hotspots の識別がデフォルトで有効になります。Windows ではこの機能は利用できません。

dd-trace-js のバージョン 5.0.0 以降、4.24.0 以降または 3.45.0 以降が必要です。

タイムライン機能 (ベータ版) を有効にするには

• dd-trace-js 5.1.0 以降、4.25.0 以降または 3.46.0 以降にアップグレードします
• DD_PROFILING_TIMELINE_ENABLED=1 を設定します

Go サービスのプロファイリングを起動すると、コードのホットスポット識別がデフォルトで有効化されます。

新しいタイムライン機能 (ベータ版) を有効にするには、以下の環境変数を設定してください。

os.Setenv("DD_PROFILING_EXECUTION_TRACE_ENABLED", "true")
os.Setenv("DD_PROFILING_EXECUTION_TRACE_PERIOD", "15m")

これらの変数を設定すると、実行トレースデータが 15 分ごとに最大 1 分間 (または 5 MiB) 記録されます。

このデータは、

• 検索クエリに go_execution_traced:yes を追加して Profile List で表示できます。プロファイルをクリックすると Profile Timeline が表示されます。さらに深く見るには、プロファイルをダウンロードし、go tool trace または gotraceui を使用して、含まれている go.trace ファイルを表示します。
• 検索クエリに @go_execution_traced:yes (@ に注意) を追加してトレースエクスプローラーで表示できます。スパンをクリックし、Code Hotspots タブを選択してスパンタイムラインを表示します。

実行トレースを記録している間、アプリケーションがガベージコレクションのように CPU 使用率の増加を観測する可能性があります。ほとんどのアプリケーションでは大きな影響はないはずですが、Go 1.21 にはこのオーバーヘッドをなくすためのパッチが含まれています。

この機能を利用するには、dd-trace-go のバージョン 1.37.0 以上 (タイムラインベータの場合は 1.52.0 以上) が必要で、Go のバージョン 1.18 以上 (タイムラインベータの場合は 1.21 以上) で最適に動作します。

.NET サービスのプロファイリングを起動すると、コードのホットスポット識別がデフォルトで有効化されます。

この機能を使用するには dd-trace-dotnet のバージョン 2.30.0 以上が必要です。

PHP サービスのプロファイリングを起動すると、コードのホットスポット識別がデフォルトで有効化されます。

dd-trace-php のバージョン 0.71 以上が必要です。

タイムライン機能 (ベータ版) を有効にするには

• dd-trace-php をバージョン 0.89 以上にアップグレードしてください。
• 環境変数 DD_PROFILING_EXPERIMENTAL_TIMELINE_ENABLED=1 または INI 設定 datadog.profiling.experimental_timeline_enabled=1 を設定します

• CPU は、CPU タスクを実行するのに費やした時間を示します。
• Synchronization は、モニター待ちの時間、スレッドがスリープしている時間、パークしている時間などを表示します。
• VM operations は、VM オペレーション (例えば、ガベージコレクション、コンパイル、セーフポイント、ヒープダンプ) の待ち時間を示します。
• ファイル I/O は、ディスクの読み取り/書き込み動作の実行待ちに費やした時間を示します。
• ソケット I/O は、ネットワークの読み取り/書き込み動作の実行待ちに費やした時間を示します。
• Monitor enter は、スレッドがロックでブロックされている時間を表示します。
• Uncategorized は、前述のカテゴリーに分類できないスパンの実行に要した時間を表示します。

• CPU は、CPU タスクを実行するのに費やした時間を示します。
• Lock Wait は、スレッドがロックでブロックされている時間を表示します。
• Uncategorized は、前述のカテゴリーに分類できないスパンの実行に要した時間を表示します。

• CPU は、CPU タスクを実行するのに費やした時間を示します。
• Uncategorized は、CPU 実行以外のスパン実行に要した時間を表示します。

• CPU は、CPU タスクの実行にかかった時間を示します。Node.js experimental CPU プロファイラーで収集されたプロファイルにのみ表示されます。
• Uncategorized は、CPU 実行以外のスパン実行に要した時間を表示します。

• CPU は、CPU タスクを実行するのに費やした時間を示します。
• Off-CPU は、CPU 実行以外のスパン実行に要した時間を表示します。

• CPU は、CPU タスクを実行するのに費やした時間を示します。
• Lock Wait は、スレッドがロックでブロックされている時間を表示します。
• Uncategorized は、前述のカテゴリーに分類できないスパンの実行に要した時間を表示します。

• CPU は、CPU タスクを実行するのに費やした時間を示します。
• Uncategorized は、CPU 実行以外のスパン実行に要した時間を表示します。

各レーンはスレッドを表しています。共通のプールからのスレッドはまとめてグループ化されています。プールを展開することで、各スレッドの詳細を確認できます。

上のレーンは、余分なレイテンシーを追加するかもしれないランタイムアクティビティです。これらはリクエスト自体に関係ないこともあります。

タイムラインを使って p95 リクエストの遅延やタイムアウトをデバッグする方法については、ブログ記事 プロファイリングでリクエストの遅延を理解するを参照してください。

各レーンは goroutine を表します。これには、選択されたスパンを開始した goroutine と、その goroutine が作成した goroutine とその子孫が含まれます。同じ go ステートメントで作成された goroutine はグループ化されます。グループを展開して各 goroutine の詳細を見ることができます。

上のレーンは、余分なレイテンシーを追加するかもしれないランタイムアクティビティです。これらはリクエスト自体に関係ないこともあります。

タイムラインを使って p95 リクエストの遅延やタイムアウトをデバッグする方法については、ブログ記事 Datadog のプロファイリングタイムラインによる Go リクエストレイテンシーのデバッグを参照してください。

Ruby でこの機能を有効にする方法については、前提条件を参照してください。

各レーンはスレッドを表します。共通のプールからのスレッドは一緒にグループ化されます。プールを展開すると、各スレッドの詳細を表示できます。

各レーンはスレッドを表します。共通のプールからのスレッドは一緒にグループ化されます。プールを展開すると、各スレッドの詳細を表示できます。

上部のレーンは、余分なレイテンシーを追加する可能性のあるランタイムアクティビティを表しています。これらはリクエスト自体に関係ないこともあります。

Node.js でこの機能を有効にする方法については、前提条件を参照してください。

JavaScript のスレッドには 1 つのレーンがあります。

上のレーンはガベージコレクターのランタイムアクティビティで、リクエストに余分なレイテンシーを追加する可能性があります。

PHP でこの機能を有効にする方法については、前提条件を参照してください。

PHPのスレッドには 1 つのレーンがあります。このスレッドで実行されるファイバーは、グループ化された別々のレーンで表されます。

上部のレーンは、ファイルのコンパイルやガベージコレクションによりリクエストのレイテンシーが増加する可能性のあるランタイムアクティビティを表しています。

Java サービスのプロファイリングを起動すると、エンドポイントプロファイリングがデフォルトで有効化されます。

Datadog プロファイラーの使用が必要です。JFR はサポートされていません。

Python サービスのプロファイリングを起動すると、エンドポイントプロファイリングがデフォルトで有効化されます。

dd-trace-py のバージョン 0.54.0 以上が必要です。

Go サービスのプロファイリングを起動すると、エンドポイントプロファイリングがデフォルトで有効化されます。

dd-trace-go バージョン 1.37.0 以上が必要で、Go バージョン 1.18 以降で最適に動作します。

Ruby サービスのプロファイリングを起動すると、エンドポイントプロファイリングがデフォルトで有効化されます。

dd-trace-rb のバージョン 0.54.0 以上が必要です。

Linux と macOS で Node.js サービスのプロファイリングを有効にすると、エンドポイントプロファイリングがデフォルトで有効になります。Windows ではこの機能は利用できません。

dd-trace-js のバージョン 5.0.0 以降、4.24.0 以降または 3.45.0 以降が必要です。

.NET サービスのプロファイリングを起動すると、エンドポイントプロファイリングがデフォルトで有効化されます。

dd-trace-dotnet のバージョン 2.15.0 以上が必要です。

PHP サービスのプロファイリングを起動すると、エンドポイントプロファイリングがデフォルトで有効化されます。

dd-trace-php のバージョン 0.79.0 以上が必要です。