次の方法で共有

.NET 拡張機能メトリック

  • [アーティクル]

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

ヒント

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

Microsoft.Extensions.Diagnostics.HealthChecks

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

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

メトリック: dotnet.health_check.reports
名前 インストルメントの種類 単位 (UCUM) 説明
dotnet.health_check.reports カウンタ {report} 正常性レポートがアプリケーションの正常性状態を報告した回数。
属性 Type 説明 例 プレゼンス
dotnet.health_check.status string アプリケーションの正常性状態。 Healthy; Unhealthy 常時

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

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

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

メトリック: dotnet.health_check.unhealthy_checks
名前 インストルメントの種類 単位 (UCUM) 説明
dotnet.health_check.unhealthy_checks カウンタ {unhealthy_check} 正常性チェックが、アプリケーションの正常性状態を Degraded または Unhealthy と報告した回数。
属性 Type 説明 例 プレゼンス
dotnet.health_check.name string 正常性チェックの名前。 ApplicationLifecycle Always (常に)
dotnet.health_check.status string アプリケーションの正常性状態。 Healthy; Unhealthy 常時

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

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

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

Microsoft.Extensions.Diagnostics.ResourceMonitoring

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

Note

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

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

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

Name インストルメントの種類 単位 (UCUM) 説明
container.cpu.limit.utilization ObservableGauge 1 範囲 [0, 1]のリソース制限に対する、実行中のコンテナー化されたアプリケーションの CPU 消費量。

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

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

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

Name インストルメントの種類 単位 (UCUM) 説明
container.cpu.request.utilization ObservableGauge 1 範囲内のリソース要求に対する実行中のコンテナー化されたアプリケーションの CPU 消費量 [0, 1]。

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

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

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

Name インストルメントの種類 単位 (UCUM) 説明
container.memory.limit.utilization ObservableGauge 1 範囲 [0, 1]のリソース制限に対する、実行中のコンテナー化されたアプリケーションのメモリ消費量。

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

メトリック: process.cpu.utilization
名前 インストルメントの種類 単位 (UCUM) 説明
process.cpu.utilization ObservableGauge 1 実行中のアプリケーションの範囲 [0, 1] における CPU 消費量。

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

メトリック: dotnet.process.memory.virtual.utilization
名前 インストルメントの種類 単位 (UCUM) 説明
dotnet.process.memory.virtual.utilization ObservableGauge 1 実行中のアプリケーションの範囲 [0, 1] のメモリ消費量。

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

メトリック: system.network.connections
名前 インストルメントの種類 単位 (UCUM) 説明
system.network.connections ObservableUpDownCounter {connection} 状態別のネットワーク接続の数。
属性 Type 説明 例 プレゼンス
network.type string OSI のネットワーク層または OSI 以外で同等のもの。 ipv4; ipv6 常時
system.network.state string ネットワーク接続の状態。 close; listen Always (常に)

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