次の方法で共有

.NET 拡張機能メトリック

この記事では、System.Diagnostics.Metrics API を使用して生成される診断 .NET 拡張機能ライブラリの組み込みメトリックについて説明します。 以前の EventCounters API に基づくメトリックの一覧については、「 使用可能なカウンター」を参照してください。

Tip

これらのメトリックを収集して報告する方法の詳細については、「メトリック の収集」を参照してください。

Microsoft.Extensions.Diagnostics.HealthChecks

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

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

メトリック: dotnet.health_check.reports
Name インストルメントタイプ ユニット (UCUM) Description
dotnet.health_check.reports Counter<T> {report} 正常性レポートがアプリケーションの正常性状態を報告した回数。
Attribute タイプ Description Examples Presence
dotnet.health_check.status string アプリケーションの正常性状態。 Healthy;Unhealthy Always

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

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

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

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

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

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

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

Microsoft.Extensions.Diagnostics.ResourceMonitoring

Microsoft.Extensions.Diagnostics.ResourceMonitoring メトリックは、リソース監視からのリソース情報を報告します。

Note

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

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

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

Name インストルメントタイプ ユニット (UCUM) Description
container.cpu.limit.utilization ObservableGauge<T> 1 範囲 [0, 1]のリソース制限に対する、実行中のコンテナー化されたアプリケーションの CPU 消費量。

Microsoft.Extensions.Diagnostics.ResourceMonitoring 8.8.0 以降で使用できます。

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

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

Name インストルメントタイプ ユニット (UCUM) Description
container.cpu.request.utilization ObservableGauge<T> 1 範囲内のリソース要求に対する実行中のコンテナー化されたアプリケーションの CPU 消費量 [0, 1]。

Microsoft.Extensions.Diagnostics.ResourceMonitoring 8.8.0 以降で使用できます。

メトリック: container.cpu.time

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

Name インストルメントタイプ ユニット (UCUM) Description
container.cpu.time ObservableCounter<T> s コンテナーによって使用される CPU 時間。

Microsoft.Extensions.Diagnostics.ResourceMonitoring 9.8.0 以降で使用できます。

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

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

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

Microsoft.Extensions.Diagnostics.ResourceMonitoring 8.8.0 以降で使用できます。

メトリック: container.memory.usage

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

Name インストルメントタイプ ユニット (UCUM) Description
container.memory.usage ObservableUpDownCounter<T> By コンテナー内のすべてのプロセスのメモリ使用量 (バイト単位)。

Microsoft.Extensions.Diagnostics.ResourceMonitoring 9.8.0 以降で使用できます。

メトリック: process.cpu.utilization
Name インストルメントタイプ ユニット (UCUM) Description
process.cpu.utilization ObservableGauge<T> 1 実行中のアプリケーションの範囲 [0, 1] における CPU 消費量。

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

メトリック: dotnet.process.memory.virtual.utilization
Name インストルメントタイプ ユニット (UCUM) Description
dotnet.process.memory.virtual.utilization ObservableGauge<T> 1 実行中のアプリケーションの範囲 [0, 1] のメモリ消費量。

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

メトリック: system.network.connections
Name インストルメントタイプ ユニット (UCUM) Description
system.network.connections ObservableUpDownCounter<T> {connection} 状態別のネットワーク接続の数。
Attribute タイプ Description Examples Presence
network.type string OSI のネットワーク層または OSI 以外で同等のもの。 ipv4;ipv6 Always
system.network.state string ネットワーク接続の状態。 close;listen Always

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

  • Last updated on