System.Diagnostics.Metrics 命名空間

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

類別

Counter<T>

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

Histogram<T>

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

Instrument

所有計量檢測類別的基類

Instrument<T>

所有不可觀察之檢測的基類。

Meter

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

MeterFactoryExtensions

IMeterFactoryMeter 擴充方法。

MeterListener

MeterListener 是用來接聽計量檢測測量錄製的類別。

MeterOptions

建立 Meter 的選項。

ObservableCounter<T>

表示計量可觀察的檢測,在觀察檢測時報告單調增加值,例如,不同進程、執行緒、使用者模式或核心模式的 CPU 時間 () 。 呼叫 CreateObservableCounter 以建立可觀察的計數器物件。

ObservableGauge<T>

表示可觀察的檢測,在觀察檢測時報告非加法值,例如目前的室內溫度。 呼叫 CreateObservableGauge 以建立可觀察的計數器物件。

ObservableInstrument<T>

ObservableInstrument{T} 是所有計量可觀察檢測所繼承的基類。

ObservableUpDownCounter<T>

計量可觀察的檢測,會在觀察到檢測時報告增加或減少的值。 例如,使用此檢測來監視進程堆積大小或無鎖定迴圈緩衝區中的大約專案數目。 若要建立 ObservableUpDownCounter 物件,請使用 CreateObservableUpDownCounter 方法。

UpDownCounter<T>

支援報告正或負數計量值的檢測。 UpDownCounter 可用於報告作用中要求變更或佇列大小的案例。

結構

Measurement<T>

儲存一個觀察到的計量值及其相關聯的標記。 當報告目前的度量時,這個類型是由可觀察檢測的 Observ () 方法使用。

介面

IMeterFactory

用於建立 Meter 實例的處理站。

委派

MeasurementCallback<T>

委派,表示錄製度量時所使用的 Meterlistener 回呼。