共用方式為

.NET 延伸模組計量

  • 發行項

本文說明使用 System.Diagnostics.Metrics API 所產生的診斷 .NET 擴充程式庫內建計量。 如需以舊版 EventCounters API 為基礎的計量清單，請參閱可用的計數器。

提示

如需如何收集和報告這些計量的詳細資訊，請參閱 收集計量。

Microsoft.Extensions.Diagnostics.HealthChecks

Microsoft.Extensions.Diagnostics.HealthChecks 計量會報告來自 .NET 健康狀態檢查的健康狀態檢查資訊：

您可以呼叫擴充方法來 AddTelemetryHealthCheckPublisher 啟用這些計量。 這些計量只能針對推送式計量啟用，而且不適用於提取型計量。

計量：dotnet.health_check.reports
名稱 金融工具類型 單位 (UCUM) 描述
dotnet.health_check.reports 計數器 {report} 健康情況報告回報應用程式健全狀態的次數。
屬性 類型 描述 範例 目前狀態
dotnet.health_check.status string 應用程式的健全狀態。 Healthy; Unhealthy 永遠

dotnet.health_check.status 是下列其中一項：

值 Description
Degraded 應用程式處於降級狀態。
Healthy 應用程式狀況良好。
Unhealthy 應用程式狀況不良。

從此版本開始提供：.NET 8.0。

計量：dotnet.health_check.unhealthy_checks
名稱 金融工具類型 單位 (UCUM) 描述
dotnet.health_check.unhealthy_checks 計數器 {unhealthy_check} 健康狀態檢查回報應用程式健全狀態為 Degraded 或 Unhealthy 的次數。
屬性 類型 描述 範例 目前狀態
dotnet.health_check.name string 健康狀態檢查的名稱。 ApplicationLifecycle 永遠
dotnet.health_check.status string 應用程式的健全狀態。 Healthy; Unhealthy 永遠

dotnet.health_check.status 是下列其中一項：

值 Description
Degraded 應用程式處於降級狀態。
Healthy 應用程式狀況良好。
Unhealthy 應用程式狀況不良。

從此版本開始提供：.NET 8.0。

Microsoft.Extensions.Diagnostics.ResourceMonitoring

計量 Microsoft.Extensions.Diagnostics.ResourceMonitoring 會報告來自資源監視的資源資訊：

注意

Microsoft.Extensions.Diagnostics.ResourceMonitoring 計量發出的計量處於實驗性階段。 這表示可能會有中斷性變更。

計量：container.cpu.limit.utilization

檢測僅適用於在 Windows 和 Linux 上容器上執行的系統上。

名稱 金融工具類型 單位 (UCUM) 描述
container.cpu.limit.utilization ObservableGauge 1 相對於範圍 [0, 1]中的資源限制，執行中容器化應用程式的CPU耗用量。

從 開始提供：.NET 8.8.0。

計量：container.cpu.request.utilization

檢測僅適用於在Linux上容器上執行的系統上。

名稱 金融工具類型 單位 (UCUM) 描述
container.cpu.request.utilization ObservableGauge 1 相對於範圍 [0, 1]中的資源要求，執行中容器化應用程式的CPU耗用量。

從 開始提供：.NET 8.8.0。

計量：container.memory.limit.utilization

檢測僅適用於在 Windows 和 Linux 上容器上執行的系統上。

名稱 金融工具類型 單位 (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} 依狀態的網路連線數目。
屬性 類型 描述 範例 目前狀態
network.type string OSI 網路層或非 OSI 對等項。 ipv4; ipv6 永遠
system.network.state string 網路連線的狀態。 close; listen 永遠

從此版本開始提供：.NET 8.0。