다음을 통해 공유


System.Diagnostics.Metrics 네임스페이스

메트릭은 시간에 따라 보고된 숫자 측정값으로, 애플리케이션의 상태를 모니터링하고 경고를 생성하는 데 가장 자주 사용됩니다. 예를 들어 웹 서비스는 초당 수신하는 요청 수, 응답하는 데 걸린 시간(밀리초) 및 사용자에게 오류를 다시 보낸 응답 수를 추적할 수 있습니다. 이러한 메트릭은 자주 정기적으로 모니터링 시스템에 보고할 수 있습니다. System.Diagnostics.Metrics 네임스페이스를 사용하여 애플리케이션에 메트릭을 추가할 수 있습니다. API는 .NET에서 지원하는 모든 플랫폼에서 작동하며 OpenTelemetry의 증가하는 도구 에코시스템과 잘 통합되도록 설계되었습니다. 또한 dotnet-counters같은 .NET SDK 도구와 통합됩니다. 다른 시스템에 사용자 지정 도구 또는 어댑터를 만들려는 개발자는 수신기 API를 사용할 수 있습니다.

클래스

Counter<T>

음수가 아닌 값 추가를 지원하는 계측을 나타냅니다. 예를 들어 요청이 처리될 때마다 counter.Add(1) 호출하여 총 요청 수를 추적할 수 있습니다. 대부분의 메트릭 뷰어는 기본적으로 속도(요청/초)를 사용하여 카운터를 표시하지만 누적 합계를 표시할 수도 있습니다.

Gauge<T>

계기는 변경이 발생할 때마다 비가산적 값을 기록하는 데 사용되는 계측기입니다. 예를 들어 변경이 발생할 때 방 배경 노이즈 수준 값을 기록합니다.

Histogram<T>

통계적으로 의미 있는 임의 값(예: 요청 기간)을 보고하는 데 사용할 수 있는 메트릭 계측을 나타냅니다. CreateHistogram<T>(String, String, String) 호출하여 히스토그램 개체를 만듭니다.

Instrument

모든 메트릭 계측 클래스의 기본 클래스

Instrument<T>

관찰할 수 없는 모든 계측에 대한 기본 클래스입니다.

InstrumentAdvice<T>

지정된 Instrument<T>대한 측정값을 기록할 때 메트릭 소비자가 사용하는 것이 좋습니다.

Meter

미터는 계측기를 만들고 추적하는 클래스입니다.

MeterFactoryExtensions

MeterIMeterFactory대한 확장 메서드입니다.

MeterListener

MeterListener는 메트릭 계측 측정 기록을 수신 대기하는 데 사용되는 클래스입니다.

MeterOptions

Meter만들기 위한 옵션입니다.

ObservableCounter<T>

계측이 관찰될 때(예: CPU 시간(다른 프로세스, 스레드, 사용자 모드 또는 커널 모드의 경우) 단조적으로 증가하는 값을 보고하는 메트릭 관찰 가능한 계측을 나타냅니다. CreateObservableCounter 호출하여 관찰 가능한 카운터 개체를 만듭니다.

ObservableGauge<T>

계측이 관찰될 때 비가산성 값을 보고하는 관찰 가능한 계측(예: 현재 실온)을 나타냅니다. CreateObservableGauge 호출하여 관찰 가능한 카운터 개체를 만듭니다.

ObservableInstrument<T>

ObservableInstrument{T}는 모든 메트릭 관찰 가능한 계측이 상속하는 기본 클래스입니다.

ObservableUpDownCounter<T>

계측이 관찰될 때 증가하거나 감소하는 값을 보고하는 메트릭 관찰 가능한 계측입니다. 예를 들어 이 계측기를 사용하여 프로세스 힙 크기 또는 잠금 없는 순환 버퍼의 대략적인 항목 수를 모니터링할 수 있습니다. ObservableUpDownCounter 개체를 만들려면 CreateObservableUpDownCounter 메서드를 사용합니다.

UpDownCounter<T>

양수 또는 음수 메트릭 값 보고를 지원하는 계측입니다. UpDownCounter는 활성 요청 또는 큐 크기의 변경 내용 보고와 같은 시나리오에서 사용할 수 있습니다.

구조체

Measurement<T>

관찰된 메트릭 값 하나와 관련 태그를 저장합니다. 이 형식은 현재 측정값을 보고할 때 Observable 계측의 Observ() 메서드에서 사용됩니다.

인터페이스

IMeterFactory

Meter 인스턴스를 만들기 위한 팩터리입니다.

대리자

MeasurementCallback<T>

측정값을 기록할 때 사용되는 Meterlistener 콜백을 나타내는 대리자입니다.