System.Diagnostics.Metrics 命名空間
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
計量是一段時間內報告的數值度量,最常用來監視應用程式的健康情況併產生警示。 例如,Web 服務可能會追蹤每秒接收多少要求、回應所花費的毫秒數,以及有多少回應將錯誤傳回給使用者。 這些計量可以經常定期回報給監視系統。 System.Diagnostics.Metrics 命名空間可用來將計量新增至應用程式。 API 適用於 .NET 支援的所有平臺,其設計目的是要與 OpenTelemetry 日益成長的工具生態系統整合。 它們也會與 .NET SDK 工具整合,例如 dotnet-counters。 接聽程式 API 可供想要建立自訂工具或配接器給其他系統的開發人員使用。
類別
Counter<T> |
表示支援加入非負值的工具。 例如,每次處理要求以追蹤要求總數時,您可能會呼叫 |
Gauge<T> |
量測計是一種檢測,用於記錄每當發生變更時的非累加值。 例如,在發生變更時記錄會議室背景雜訊等級值。 |
Histogram<T> |
表示計量檢測,可用來報告可能具有統計意義的任意值,例如要求持續時間。 呼叫 CreateHistogram<T>(String, String, String) 以建立直方圖物件。 |
Instrument |
所有計量檢測類別的基類 |
Instrument<T> |
所有不可觀察儀器的基類。 |
InstrumentAdvice<T> |
包含計量取用者在記錄指定 Instrument<T>度量時,建議使用的組態設定。 |
Meter |
計量是負責建立和追蹤 Instruments 的類別。 |
MeterFactoryExtensions |
Meter 和 IMeterFactory的擴充方法。 |
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 回呼。 |