.NET ランタイムメトリクス

ランタイムメトリクスの互換性

  • .NET フレームワーク 4.5+
  • .NET Core 3.1
  • .NET 5

自動コンフィギュレーション

DD_RUNTIME_METRICS_ENABLED=true 環境変数を使用して、.NET Tracer 1.23.0+ でランタイムメトリクス収集を有効にします。

ランタイムメトリクスを .NET サービスと相関して表示します。Datadog のサービス詳細画面を参照してください。

初期設定では、アプリケーションからのランタイムメトリクスは、ポート 8125 を介して DogStatsD と共に Datadog Agent に送信されます。DogStatsD が Agent に対して有効になっていることを確認してください。

Agent をコンテナとして実行している場合は、DD_DOGSTATSD_NON_LOCAL_TRAFFIC が true に設定されていることと、Agent コンテナでポート 8125 が開いていることを確認してください。また、

収集データ

以下のメトリクスは .NET メトリクスを有効にした後、デフォルトで収集されます。

runtime.dotnet.cpu.system
(gauge)		The number of milliseconds executing in the kernel
Shown as millisecond
runtime.dotnet.cpu.user
(gauge)		The number of milliseconds executing outside the kernel
Shown as millisecond
runtime.dotnet.cpu.percent
(gauge)		The percentage of total CPU used by the application
Shown as percent
runtime.dotnet.mem.committed
(gauge)		Memory usage
Shown as byte
runtime.dotnet.threads.count
(gauge)		The number of threads
Shown as thread
runtime.dotnet.threads.workers_count
(gauge)		The number of workers in the threadpool (.NET Core only)
Shown as thread
runtime.dotnet.threads.contention_time
(gauge)		The cumulated time spent by threads waiting on a lock (.NET Core only)
Shown as millisecond
runtime.dotnet.threads.contention_count
(count)		The number of times a thread stopped to wait on a lock
runtime.dotnet.exceptions.count
(count)		The number of first-chance exceptions
Shown as exception
runtime.dotnet.gc.size.gen0
(gauge)		The size of the gen 0 heap
Shown as byte
runtime.dotnet.gc.size.gen1
(gauge)		The size of the gen 1 heap
Shown as byte
runtime.dotnet.gc.size.gen2
(gauge)		The size of the gen 2 heap
Shown as byte
runtime.dotnet.gc.size.loh
(gauge)		The size of the large object heap
Shown as byte
runtime.dotnet.gc.memory_load
(gauge)		The percentage of the total memory used by the process. The GC changes its behavior when this value gets above 85. (.NET Core only)
Shown as percent
runtime.dotnet.gc.pause_time
(gauge)		The amount of time the GC paused the application threads (.NET Core only)
Shown as millisecond
runtime.dotnet.gc.count.gen0
(count)		The number of gen 0 garbage collections
Shown as garbage collection
runtime.dotnet.gc.count.gen1
(count)		The number of gen 1 garbage collections
Shown as garbage collection
runtime.dotnet.gc.count.gen2
(count)		The number of gen 2 garbage collections
Shown as garbage collection
runtime.dotnet.aspnetcore.requests.total
(gauge)		The total number of HTTP requests received by the server (.NET Core only)
Shown as request
runtime.dotnet.aspnetcore.requests.failed
(gauge)		The number of failed HTTP requests received by the server (.NET Core only)
Shown as request
runtime.dotnet.aspnetcore.requests.current
(gauge)		The total number of HTTP requests that have started but not yet stopped (.NET Core only)
Shown as request
runtime.dotnet.aspnetcore.requests.queue_length
(gauge)		The current length of the server HTTP request queue (.NET Core only)
Shown as request
runtime.dotnet.aspnetcore.connections.total
(gauge)		The total number of HTTP connections established to the server (.NET Core only)
Shown as connection
runtime.dotnet.aspnetcore.connections.current
(gauge)		The current number of active HTTP connections to the server (.NET Core only)
Shown as connection
runtime.dotnet.aspnetcore.connections.queue_length
(gauge)		The current length of the HTTP server connection queue (.NET Core only)
Shown as connection

Datadog では、APM サービス詳細画面にこれらのメトリクスを表示し、これらのメトリクスに適用された service および runtime-id タグ付きのデフォルトの .NET ランタイムダッシュボードを提供します。

IIS の追加のアクセス許可

.NET フレームワークでは、メトリクスはパフォーマンスカウンターを使用して収集されます。非対話型ログオンセッションのユーザー (IIS アプリケーションプールアカウントと一部のサービスアカウントを含む) は、カウンターデータにアクセスするために Performance Monitoring Users グループに追加する必要があります。

IIS アプリケーションプールは、ユーザーのリストに表示されない特別なアカウントを使用します。それらを Performance Monitoring Users グループに追加するには、IIS APPPOOL\<name of the pool> を探します。たとえば、DefaultAppPool のユーザーは IIS APPPOOL\DefaultAppPool になります。

これは、“Computer Management” UI から、または管理者コマンドプロンプトから実行できます。

net localgroup "Performance Monitor Users" "IIS APPPOOL\DefaultAppPool" /add

その他の参考資料

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

ログとトレースの接続DOCUMENTATION more more アプリケーションを手動でインストルメントしてトレースを作成します。DOCUMENTATION more more アプリケーション全体に Opentracing を実装します。DOCUMENTATION more more サービス、リソース、トレースの詳細DOCUMENTATION more more Datadog を使用した .NET ランタイムメトリクスの監視ブログ more more