.NET 扩展指标

本文介绍了使用 System.Diagnostics.Metrics API 生成的诊断 .NET 扩展库的内置指标。 有关基于旧版 EventCounters API 的指标列表，请参阅可用计数器。

提示

有关如何收集和报告这些指标的详细信息，请参阅 收集指标。

Microsoft.Extensions.Diagnostics.HealthChecks

Microsoft.Extensions.Diagnostics.HealthChecks 指标会报告来自 .NET 运行状况检查的运行状况检查信息：

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

可以通过调用 AddTelemetryHealthCheckPublisher 扩展方法来启用这些指标。 这些指标只能为基于推送的指标启用，并且不适用于基于拉取的指标。

指标：dotnet.health_check.reports

名称	检测类型	单位 (UCUM)	说明
dotnet.health_check.reports	计数器	{report}	运行状况报告报告应用程序的运行状况的次数。

Attribute	类型	说明	示例	状态
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 的次数。

Attribute	类型	说明	示例	状态
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 指标会报告来自资源监视的资源信息：

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

注意

Microsoft.Extensions.Diagnostics.ResourceMonitoring 计量发出的指标处于试验阶段。 这意味着这些指标可能会发生中断性变更。

指标：container.cpu.limit.utilization

检测仅在 Windows 和 Linux 上的容器上运行的系统可用。

名称	检测类型	单位 (UCUM)	说明
container.cpu.limit.utilization	ObservableGauge	1	正在运行的容器化应用程序的 CPU 消耗量相对于范围 [0, 1]中的资源限制。

从 .NET 8.8.0 开始可用。

指标：container.cpu.request.utilization

该仪器仅在 Linux 上的容器上运行的系统上可用。

名称	检测类型	单位 (UCUM)	说明
container.cpu.request.utilization	ObservableGauge	1	正在运行的容器化应用程序的 CPU 消耗量相对于范围内的 [0, 1]资源请求。

从 .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	正在运行的应用程序的 CPU 消耗量，范围为 [0, 1]。

从 .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	Always

从 .NET 8.0 开始可用。