次の方法で共有

.NET 拡張機能メトリック

この記事では、System.Diagnostics.Metrics API を使用して生成される診断 .NET 拡張機能ライブラリの組み込みメトリックについて説明します。 For a listing of metrics based on the older EventCounters API, see Available counters.

Tip

For more information about how to collect and report these metrics, see Collecting Metrics.

Microsoft.Extensions.Diagnostics.HealthChecks

Microsoft.Extensions.Diagnostics.HealthChecks メトリックは、.NET 正常性チェックからの正常性チェック情報を報告します。

これらのメトリックを有効にするには、 AddTelemetryHealthCheckPublisher 拡張メソッドを呼び出します。 これらのメトリックは、プッシュベースのメトリックに対してのみ有効にでき、プルベースのメトリックでは使用できません。

メトリック: dotnet.health_check.reports
Name Instrument Type Unit (UCUM) Description
dotnet.health_check.reports Counter {report} 正常性レポートがアプリケーションの正常性状態を報告した回数。
Attribute タイプ Description Examples Presence
dotnet.health_check.status 文字列 アプリケーションの正常性状態。 Healthy;Unhealthy Always

dotnet.health_check.status は次のいずれかになります。

Value Description
Degraded アプリケーションが機能低下状態でした。
Healthy アプリケーションが正常でした。
Unhealthy アプリケーションが異常でした。

利用開始になる対象: .NET 8.0

メトリック: dotnet.health_check.unhealthy_checks
Name Instrument Type Unit (UCUM) Description
dotnet.health_check.unhealthy_checks Counter {unhealthy_check} 正常性チェックが、アプリケーションの正常性状態を Degraded または Unhealthy と報告した回数。
Attribute タイプ Description Examples Presence
dotnet.health_check.name 文字列 正常性チェックの名前。 ApplicationLifecycle Always
dotnet.health_check.status 文字列 アプリケーションの正常性状態。 Healthy;Unhealthy Always

dotnet.health_check.status は次のいずれかになります。

Value Description
Degraded アプリケーションが機能低下状態でした。
Healthy アプリケーションが正常でした。
Unhealthy アプリケーションが異常でした。

利用開始になる対象: .NET 8.0

Microsoft.Extensions.Diagnostics.ResourceMonitoring

The Microsoft.Extensions.Diagnostics.ResourceMonitoring metrics report resource information from resource monitoring:

Note

Microsoft.Extensions.Diagnostics.ResourceMonitoring メーターによって出力されるメトリックは、試験段階にあります。 これは、破壊的変更が加えられる可能性があることを意味します。

メトリック: container.cpu.limit.utilization

このインストルメントは、Windows と Linux の両方のコンテナーで実行されているシステムでのみ使用できます。

Name Instrument Type Unit (UCUM) Description
container.cpu.limit.utilization ObservableGauge 1 範囲 [0, 1]のリソース制限に対する、実行中のコンテナー化されたアプリケーションの CPU 消費量。

.NET 8.8.0 以降で使用できます。

メトリック: container.cpu.request.utilization

このインストルメントは、Linux 上のコンテナーで実行されているシステムでのみ使用できます。

Name Instrument Type Unit (UCUM) Description
container.cpu.request.utilization ObservableGauge 1 範囲内のリソース要求に対する実行中のコンテナー化されたアプリケーションの CPU 消費量 [0, 1]。

.NET 8.8.0 以降で使用できます。

メトリック: container.cpu.time

このインストルメントは、Windows または Linux 上のコンテナーで実行されているシステムでのみ使用できます。

Name Instrument Type Unit (UCUM) Description
container.cpu.time ObservableCounter s コンテナーによって使用される CPU 時間。

.NET 9.8.0 以降で使用できます。

メトリック: container.memory.limit.utilization

このインストルメントは、Windows と Linux の両方のコンテナーで実行されているシステムでのみ使用できます。

Name Instrument Type Unit (UCUM) Description
container.memory.limit.utilization ObservableGauge 1 範囲 [0, 1]のリソース制限に対する、実行中のコンテナー化されたアプリケーションのメモリ消費量。

.NET 8.8.0 以降で使用できます。

メトリック: container.memory.usage

このインストルメントは、Windows または Linux 上のコンテナーで実行されているシステムでのみ使用できます。

Name Instrument Type Unit (UCUM) Description
container.memory.usage ObservableUpDownCounter By コンテナー内のすべてのプロセスのメモリ使用量 (バイト単位)。

.NET 9.8.0 以降で使用できます。

メトリック: process.cpu.utilization
Name Instrument Type Unit (UCUM) Description
process.cpu.utilization ObservableGauge 1 実行中のアプリケーションの範囲 [0, 1] における CPU 消費量。

利用開始になる対象: .NET 8.0

メトリック: dotnet.process.memory.virtual.utilization
Name Instrument Type Unit (UCUM) Description
dotnet.process.memory.virtual.utilization ObservableGauge 1 実行中のアプリケーションの範囲 [0, 1] のメモリ消費量。

利用開始になる対象: .NET 8.0

メトリック: system.network.connections
Name Instrument Type Unit (UCUM) Description
system.network.connections ObservableUpDownCounter {connection} 状態別のネットワーク接続の数。
Attribute タイプ Description Examples Presence
network.type 文字列 OSI のネットワーク層または OSI 以外で同等のもの。 ipv4;ipv6 Always
system.network.state 文字列 ネットワーク接続の状態。 close;listen Always

利用開始になる対象: .NET 8.0