System.Diagnostics.Metrics 名前空間

メトリックは、時間の経過と同時に報告される数値測定値であり、アプリケーションの正常性を監視し、アラートを生成するために最もよく使用されます。 たとえば、Web サービスは、1 秒ごとに受信した要求の数、応答にかかったミリ秒、およびユーザーにエラーを返した応答の数を追跡できます。 これらのメトリックは、定期的に監視システムに報告できます。 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) を呼び出して Histogram オブジェクトを作成します。

Instrument

すべてのメトリック インストルメント クラスの基本クラス

Instrument<T>

すべての観測不可能な楽器の基底クラス。

InstrumentAdvice<T>

特定の Instrument<T>の測定値を記録するときにメトリック コンシューマーが使用することをお勧めする構成設定が含まれています。

Meter

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>

1 つの観測メトリック値とそれに関連付けられているタグを格納します。 この型は、現在の測定値を報告するときに、Observable Instrument の Observ() メソッドによって使用されます。

インターフェイス

IMeterFactory

Meter インスタンスを作成するためのファクトリ。

代理人

MeasurementCallback<T>

測定を記録するときに使用される Meterlistener コールバックを表すデリゲート。