共用方式為


System.Diagnostics.Metrics 命名空間

計量是一段時間內報告的數值度量,最常用來監視應用程式的健康情況併產生警示。 例如,Web 服務可能會追蹤每秒接收多少要求、回應所花費的毫秒數,以及有多少回應將錯誤傳回給使用者。 這些計量可以經常定期回報給監視系統。 System.Diagnostics.Metrics 命名空間可用來將計量新增至應用程式。 API 適用於 .NET 支援的所有平臺,其設計目的是要與 OpenTelemetry 日益成長的工具生態系統整合。 它們也會與 .NET SDK 工具整合,例如 dotnet-counters。 接聽程式 API 可供想要建立自訂工具或配接器給其他系統的開發人員使用。

類別

Counter<T>

表示支援加入非負值的工具。 例如,每次處理要求以追蹤要求總數時,您可能會呼叫 counter.Add(1)。 根據預設,大部分的計量查看器都會使用速率 (requests/sec) 來顯示計數器,但也可以顯示累計總計。

Gauge<T>

量測計是一種檢測,用於記錄每當發生變更時的非累加值。 例如,在發生變更時記錄會議室背景雜訊等級值。

Histogram<T>

表示計量檢測,可用來報告可能具有統計意義的任意值,例如要求持續時間。 呼叫 CreateHistogram<T>(String, String, String) 以建立直方圖物件。

Instrument

所有計量檢測類別的基類

Instrument<T>

所有不可觀察儀器的基類。

InstrumentAdvice<T>

包含計量取用者在記錄指定 Instrument<T>度量時,建議使用的組態設定。

Meter

計量是負責建立和追蹤 Instruments 的類別。

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 回呼。