Share via

.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} 상태 보고서에서 애플리케이션의 상태를 보고한 횟수입니다.
Attribute Type 설명 예제 현재 상태
dotnet.health_check.status string 애플리케이션의 상태입니다. Healthy; Unhealthy Always

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 Type 설명 예제 현재 상태
dotnet.health_check.name string 상태 검사의 이름입니다. ApplicationLifecycle Always
dotnet.health_check.status string 애플리케이션의 상태입니다. Healthy; Unhealthy Always

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

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

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

Microsoft.Extensions.Diagnostics.ResourceMonitoring

Microsoft.Extensions.Diagnostics.ResourceMonitoring 메트릭은 리소스 모니터링의 리소스 정보를 보고합니다.

참고 항목

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

메트릭: process.cpu.utilization

이 계측기는 Linux에서만 사용할 수 있습니다.

이름 계측 유형 단위(UCUM) 설명
process.cpu.utilization ObservableGauge 1 범위 [0, 1]에서 실행 중인 애플리케이션의 CPU 사용량입니다.

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

메트릭: dotnet.process.memory.virtual.utilization

이 계측기는 Linux에서만 사용할 수 있습니다.

이름 계측 유형 단위(UCUM) 설명
dotnet.process.memory.virtual.utilization ObservableGauge 1 범위 [0, 1]에서 실행 중인 애플리케이션의 메모리 사용량입니다.

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

메트릭: system.network.connections

이 계측기는 Windows에서만 사용할 수 있습니다.

이름 계측 유형 단위(UCUM) 설명
system.network.connections ObservableUpDownCounter {connection} 상태별 네트워크 연결 수입니다.
Attribute Type 설명 예제 현재 상태
network.type string OSI 네트워크 레이어 또는 비 OSI와 동등한 레이어입니다. ipv4; ipv6 Always
system.network.state string 네트워크 연결의 상태입니다. close; listen Always

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