System.Diagnostics.Metrics 名前空間

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

メトリックは、時間の経過と同時に報告される数値測定値であり、アプリケーションの正常性を監視し、アラートを生成するために最もよく使用されます。たとえば、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	Meter と IMeterFactoryの拡張メソッド。
MeterListener	MeterListener は、メトリックストルメント測定の記録をリッスンするために使用されるクラスです。
MeterOptions	Meterを作成するためのオプション。
ObservableCounter<T>	CPU 時間 (プロセス、スレッド、ユーザーモード、カーネルモードが異なる場合) など、測定時に単調に増加する値を報告するメトリック監視可能なインストルメントを表します。 CreateObservableCounter を呼び出して、監視可能なカウンターオブジェクトを作成します。
ObservableGauge<T>	観測可能な装置を表します。この装置は、現在の室温など、観測中の非加法値を報告します。 CreateObservableGauge を呼び出して、監視可能なカウンターオブジェクトを作成します。
ObservableInstrument<T>	ObservableInstrument{T} は、監視可能なすべてのメトリックが継承する基底クラスです。
ObservableUpDownCounter<T>	測定が行われているときに増加または減少する値を報告するメトリック監視可能なインストルメント。このインストルメントを使用して、プロセスヒープサイズや、ロックなしの循環バッファー内の項目の概数などを監視します。 ObservableUpDownCounter オブジェクトを作成するには、CreateObservableUpDownCounter メソッドを使用します。
UpDownCounter<T>	正または負のメトリック値のレポートをサポートするインストルメント。 UpDownCounter は、アクティブな要求やキューサイズの変化を報告するシナリオで使用できます。