.NET 延伸模組計量

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

Tip

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

Microsoft.Extensions.Diagnostics.HealthChecks

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

• dotnet.health_check.reports
• dotnet.health_check.unhealthy_checks

您可以呼叫擴充方法來 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 報告 來自資源監視的資源資訊：

• container.cpu.limit.utilization
• container.cpu.request.utilization
• container.cpu.time
• container.memory.limit.utilization
• container.memory.usage
• process.cpu.utilization
• dotnet.process.memory.virtual.utilization
• system.network.connections

Note

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

計量：container.cpu.limit.utilization

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

Name	儀器類型	單位 （UCUM）	Description
container.cpu.limit.utilization	ObservableGauge<T>	1	相對於範圍 [0, 1]中的資源限制，執行中容器化應用程式的CPU耗用量。

從 8.8.0 開始 Microsoft.Extensions.Diagnostics.ResourceMonitoring 提供。

計量：container.cpu.request.utilization

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

Name	儀器類型	單位 （UCUM）	Description
container.cpu.request.utilization	ObservableGauge<T>	1	相對於範圍 [0, 1]中的資源要求，執行中容器化應用程式的CPU耗用量。

從 8.8.0 開始 Microsoft.Extensions.Diagnostics.ResourceMonitoring 提供。

計量：container.cpu.time

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

Name	儀器類型	單位 （UCUM）	Description
container.cpu.time	ObservableCounter<T>	s	容器所使用的CPU時間。

從 9.8.0 開始 Microsoft.Extensions.Diagnostics.ResourceMonitoring 提供。

計量：container.memory.limit.utilization

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

Name	儀器類型	單位 （UCUM）	Description
container.memory.limit.utilization	ObservableGauge<T>	1	相對於範圍 [0, 1]中的資源限制，執行中容器化應用程式的記憶體耗用量。

從 8.8.0 開始 Microsoft.Extensions.Diagnostics.ResourceMonitoring 提供。

計量：container.memory.usage

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

Name	儀器類型	單位 （UCUM）	Description
container.memory.usage	ObservableUpDownCounter<T>	By	以位元組為單位之容器中所有進程的記憶體使用量。

從 9.8.0 開始 Microsoft.Extensions.Diagnostics.ResourceMonitoring 提供。

計量：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。