System.Diagnostics.Metrics 命名空間
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
指標是隨時間報告的數值測量，最常用來監控應用程式健康狀況並產生警示。 例如，一個網路服務可能會追蹤每秒收到多少請求、回應所需毫秒，以及有多少回應將錯誤訊息傳回給使用者。 這些指標可以定期且頻繁地回報給監控系統。 System.Diagnostics.Metrics 命名空間可用於為應用程式新增指標。 這些 API 適用於 .NET 支援的所有平台，並設計成能與 OpenTelemetry 不斷成長的工具生態系統良好整合。 它們也整合.NET SDK 工具，例如
類別
| 名稱 | Description |
|---|---|
| Counter<T> |
代表一種支援加非負值的工具。 例如，你可能會在每次處理請求時打電話追蹤 |
| Gauge<T> |
計量器是一種用於在變動發生時記錄非加性值的儀器。 例如，當房間發生變化時，記錄房間背景噪音的值。 |
| Histogram<T> |
代表一種可用於報告可能具有統計意義的任意值的指標工具，例如請求時間。 呼叫 CreateHistogram<T>(String, String, String) 建立直方圖物件。 |
| Instrument |
所有度量儀器類別的基底類別 |
| Instrument<T> |
所有非可觀測儀器的基底類別。 |
| InstrumentAdvice<T> |
包含指標消費者在記錄特定 Instrument<T>測量時建議使用的設定。 |
| Meter |
計量是負責建立和追蹤 Instruments 的類別。 |
| MeterFactoryExtensions |
與 IMeterFactory的Meter延伸方法 。 |
| MeterListener |
MeterListener 是用來接聽計量儀器測量記錄的類別。 |
| MeterOptions |
建立 Meter. 的選項 |
| ObservableCounter<T> |
代表一種可觀察指標的儀器，當觀察該儀器時，會報告單調遞增的數值，例如不同程序、執行緒、使用者模式或核心模式的 CPU 時間。 呼叫 CreateObservableCounter 建立可觀察的計數器物件。 |
| ObservableGauge<T> |
代表一個可觀察儀器，當儀器被觀測時會報告非加性值，例如當前室溫。 呼叫 CreateObservableGauge 建立可觀察的計數器物件。 |
| ObservableInstrument<T> |
ObservableInstrument{T} 是所有可觀察儀器繼承的基底類別。 |
| ObservableUpDownCounter<T> |
一種可測量指標的儀器，當儀器被觀測時會報告數值的增加或下降。 例如，使用此儀器監控程序堆大小或無鎖圓形緩衝區中項目的大致數量。 要建立 ObservableUpDownCounter 物件，請使用以下 CreateObservableUpDownCounter 方法。 |
| UpDownCounter<T> |
一種支援報告正負指標值的工具。 UpDownCounter 可用於報告活躍請求變動或佇列大小等情境。 |
結構
| 名稱 | Description |
|---|---|
| Measurement<T> |
儲存一個觀察到的計量值及其相關聯的標記。 當報告目前的測量時，這個類型是由 Observable 儀器的 Observ（） 方法使用。 |
介面
| 名稱 | Description |
|---|---|
| IMeterFactory |
一個用來建立 Meter 實例的工廠。 |
委派
| 名稱 | Description |
|---|---|
| MeasurementCallback<T> |
一位代表代表在記錄測量時使用的 Meterlistener 回撥。 |
