다음을 통해 공유

.NET 확장 메트릭

이 문서에서는 System.Diagnostics.Metrics API를 사용하여 생성된 진단 .NET 확장 라이브러리에 대한 기본 제공 메트릭을 설명합니다. For a listing of metrics based on the older EventCounters API, see Available counters.

Tip

For more information about how to collect and report these metrics, see Collecting Metrics.

Microsoft.Extensions.Diagnostics.HealthChecks

Microsoft.Extensions.Diagnostics.HealthChecks 메트릭은 .NET 상태 검사의 상태 검사 정보를 보고합니다.

확장 메서드를 호출하여 이러한 메트릭을 AddTelemetryHealthCheckPublisher 사용하도록 설정할 수 있습니다. 이러한 메트릭은 푸시 기반 메트릭에 대해서만 사용하도록 설정할 수 있으며 끌어오기 기반 메트릭에는 사용할 수 없습니다.

메트릭: dotnet.health_check.reports
Name Instrument Type Unit (UCUM) Description
dotnet.health_check.reports Counter {report} 상태 보고서에서 애플리케이션의 상태를 보고한 횟수입니다.
Attribute Type Description Examples Presence
dotnet.health_check.status string 애플리케이션의 상태입니다. Healthy: Unhealthy Always

dotnet.health_check.status는 다음 중 하나입니다.

Value Description
Degraded 애플리케이션이 저하된 상태였습니다.
Healthy 애플리케이션이 정상이었습니다.
Unhealthy 애플리케이션이 비정상이었습니다.

.NET 8.0부터 사용이 가능합니다.

메트릭: dotnet.health_check.unhealthy_checks
Name Instrument Type Unit (UCUM) Description
dotnet.health_check.unhealthy_checks Counter {unhealthy_check} 상태 검사에서 애플리케이션의 상태를 Degraded 또는 Unhealthy(으)로 보고한 횟수입니다.
Attribute Type 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.0부터 사용이 가능합니다.

Microsoft.Extensions.Diagnostics.ResourceMonitoring

The Microsoft.Extensions.Diagnostics.ResourceMonitoring metrics report resource information from resource monitoring:

Note

Microsoft.Extensions.Diagnostics.ResourceMonitoring 미터에서 내보내는 메트릭은 실험 단계에 있습니다. 즉, 호환성이 손상되는 변경이 있을 수 있습니다.

메트릭: container.cpu.limit.utilization

이 계측기는 Windows 및 Linux의 컨테이너에서 실행되는 시스템에서만 사용할 수 있습니다.

Name Instrument Type Unit (UCUM) Description
container.cpu.limit.utilization ObservableGauge 1 범위 내 리소스 제한을 기준으로 실행 중인 컨테이너화된 애플리케이션의 CPU 사용량 [0, 1]입니다.

.NET 8.8.0부터 사용할 수 있습니다.

메트릭: container.cpu.request.utilization

이 계측기는 Linux의 컨테이너에서 실행되는 시스템에서만 사용할 수 있습니다.

Name Instrument Type Unit (UCUM) Description
container.cpu.request.utilization ObservableGauge 1 범위 내 리소스 요청을 기준으로 실행 중인 컨테이너화된 애플리케이션의 CPU 사용량 [0, 1]입니다.

.NET 8.8.0부터 사용할 수 있습니다.

메트릭: container.cpu.time

이 계측기는 Windows 또는 Linux의 컨테이너에서 실행되는 시스템에서만 사용할 수 있습니다.

Name Instrument Type Unit (UCUM) Description
container.cpu.time ObservableCounter s 컨테이너에서 사용하는 CPU 시간입니다.

.NET 9.8.0부터 사용할 수 있습니다.

메트릭: container.memory.limit.utilization

이 계측기는 Windows 및 Linux의 컨테이너에서 실행되는 시스템에서만 사용할 수 있습니다.

Name Instrument Type Unit (UCUM) Description
container.memory.limit.utilization ObservableGauge 1 범위 내 리소스 제한을 기준으로 실행 중인 컨테이너화된 애플리케이션의 메모리 사용량입니다 [0, 1].

.NET 8.8.0부터 사용할 수 있습니다.

메트릭: container.memory.usage

이 계측기는 Windows 또는 Linux의 컨테이너에서 실행되는 시스템에서만 사용할 수 있습니다.

Name Instrument Type Unit (UCUM) Description
container.memory.usage ObservableUpDownCounter By 컨테이너에서 측정된 모든 프로세스의 메모리 사용량(바이트)입니다.

.NET 9.8.0부터 사용할 수 있습니다.

메트릭: process.cpu.utilization
Name Instrument Type Unit (UCUM) Description
process.cpu.utilization ObservableGauge 1 범위 [0, 1]에서 실행 중인 애플리케이션의 CPU 사용량입니다.

.NET 8.0부터 사용이 가능합니다.

메트릭: dotnet.process.memory.virtual.utilization
Name Instrument Type Unit (UCUM) Description
dotnet.process.memory.virtual.utilization ObservableGauge 1 범위 [0, 1]에서 실행 중인 애플리케이션의 메모리 사용량입니다.

.NET 8.0부터 사용이 가능합니다.

메트릭: system.network.connections
Name Instrument Type Unit (UCUM) Description
system.network.connections ObservableUpDownCounter {connection} 상태별 네트워크 연결 수입니다.
Attribute Type Description Examples Presence
network.type string OSI 네트워크 레이어 또는 비 OSI와 동등한 레이어입니다. ipv4: ipv6 Always
system.network.state string 네트워크 연결의 상태입니다. close: listen Always

.NET 8.0부터 사용이 가능합니다.