다음을 통해 공유

.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 미터에서 내보내는 메트릭은 실험 단계에 있습니다. 즉, 호환성이 손상되는 변경이 있을 수 있습니다.

메트릭: 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 범위 [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} 상태별 네트워크 연결 수입니다.
Attribute Type 설명 예제 현재 상태
network.type string OSI 네트워크 레이어 또는 비 OSI와 동등한 레이어입니다. ipv4; ipv6 Always
system.network.state string 네트워크 연결의 상태입니다. close; listen Always

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