System.Diagnostics.Metrics 名前空間

メトリックは、経時的に報告される数値の測定値で、多くの場合、アプリケーションの正常性を監視し、アラートを生成するために使用されます。 たとえば、ある Web サービスでは、1 秒あたりに受信する要求数、応答にかかった時間 (ミリ秒)、ユーザーにエラーを返した応答の数を追跡します。 これらのメトリックは、定期的な間隔で監視システムに報告できます。 System.Diagnostics.Metrics 名前空間を使用して、アプリケーションにメトリックを追加できます。 API は.NET でサポートされているすべてのプラットフォームで動作し、 OpenTelemetry の成長するツール エコシステムとうまく統合するように設計されています。 また、 dotnet-counters などの .NET SDK ツールとも統合されます。 リスナー API は、他のシステムに対してカスタム ツールまたはアダプターを作成する開発者が利用できます。

クラス

Counter<T>	負でない値の追加をサポートするインストルメントを表します。 たとえば、要求が処理されるたびに を呼び出 counter.Add(1) して、要求の合計数を追跡できます。 ほとんどのメトリック ビューアーは、既定ではレート (要求/秒) を使用してカウンターを表示しますが、累積合計を表示することもできます。
Histogram<T>	統計的に意味のある可能性が高い任意の値 (要求期間など) を報告するために使用できるメトリック ストルメントを表します。 を呼び出 CreateHistogram<T>(String, String, String) して Histogram オブジェクトを作成します。
Instrument	すべてのメトリック インストルメント クラスの基底クラス
Instrument<T>	観測不可能なすべてのインストルメントの基底クラス。
Meter	メーターは、インストルメントの作成と追跡を担当するクラスです。
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 は、アクティブな要求やキュー サイズの変更を報告するシナリオで使用できます。

構造体

Measurement<T>

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

インターフェイス

IMeterFactory

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

代理人

MeasurementCallback<T>

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