System.Diagnostics.Metrics Namespace

Metriken sind numerische Messungen, die im Laufe der Zeit gemeldet werden, am häufigsten verwendet, um den Status einer Anwendung zu überwachen und Warnungen zu generieren. Beispielsweise kann ein Webdienst nachverfolgen, wie viele Anforderungen er jede Sekunde empfängt, wie viele Millisekunden er benötigt hat, um zu antworten, und wie viele der Antworten einen Fehler an den Benutzer zurückgesendet haben. Diese Metriken können in regelmäßigen, regelmäßigen Intervallen an ein Überwachungssystem gemeldet werden. Der Namespace "System.Diagnostics.Metrics" kann verwendet werden, um einer Anwendung Metriken hinzuzufügen. Die APIs arbeiten auf allen Plattformen, die von .NET unterstützt werden, und sind darauf ausgelegt, sich gut in OpenTelemetrys wachsendes Ökosystem von Tools zu integrieren. Sie können auch in .NET SDK-Tools integriert werden, z. B. dotnet-counters. Eine Listener-API ist für Entwickler verfügbar, die benutzerdefinierte Tools oder Adapter für andere Systeme erstellen möchten.

Klassen

Counter<T>

Stellt ein Instrument dar, das das Hinzufügen nicht negativer Werte unterstützt. Beispielsweise können Sie counter.Add(1) jedes Mal aufrufen, wenn eine Anforderung verarbeitet wird, um die Gesamtanzahl der Anforderungen nachzuverfolgen. Die meisten Metrikanzeiger zeigen Zähler mit einer Rate (Anforderungen/Sek.) standardmäßig an, können aber auch eine kumulative Summe anzeigen.

Gauge<T>

The Gauge ist ein Instrument, das verwendet wird, um nicht-additive Werte aufzuzeichnen, wenn Änderungen auftreten. Notieren Sie z. B. den Wert des Raumgeräuschpegels, wenn Änderungen vorgenommen werden.

Histogram<T>

Stellt ein Metrikinstrument dar, das verwendet werden kann, um beliebige Werte zu melden, die wahrscheinlich statistisch sinnvoll sind, z. B. die Anforderungsdauer. Rufen Sie CreateHistogram<T>(String, String, String) auf, um ein Histogrammobjekt zu erstellen.

Instrument

Basisklasse aller Metrikinstrumentklassen

Instrument<T>

Die Basisklasse für alle nicht feststellbaren Instrumente.

InstrumentAdvice<T>

Enthält Konfigurationseinstellungen, die von Metrik-Verbrauchern beim Aufzeichnen von Messungen für eine bestimmte Instrument<T>verwendet werden sollen.

Meter

Meter ist die Klasse, die für die Erstellung und Nachverfolgung der Instrumente verantwortlich ist.

MeterFactoryExtensions

Erweiterungsmethoden für Meter und IMeterFactory.

MeterListener

Der MeterListener ist eine Klasse, die verwendet wird, um die Aufzeichnung der Metrikinstrumente zu überwachen.

MeterOptions

Die Optionen zum Erstellen einer Meter.

ObservableCounter<T>

Stellt ein messbares Instrument dar, das monoton steigende Werte meldet, wenn das Instrument beobachtet wird, z. B. CPU-Zeit (für verschiedene Prozesse, Threads, Benutzermodus oder Kernelmodus). Rufen Sie CreateObservableCounter auf, um das observable Counter-Objekt zu erstellen.

ObservableGauge<T>

Stellt ein feststellbares Instrument dar, das nicht additive Werte meldet, wenn das Instrument beobachtet wird, z. B. die aktuelle Raumtemperatur. Rufen Sie CreateObservableGauge auf, um das observable Counter-Objekt zu erstellen.

ObservableInstrument<T>

ObservableInstrument{T} ist die Basisklasse, von der alle Metriken feststellbare Instrumente erben.

ObservableUpDownCounter<T>

Ein metrikbeobachtbares Instrument, das beim Beobachten des Instruments steigende oder abnehmende Werte meldet. Verwenden Sie dieses Instrument, um die Prozesshapgröße oder die ungefähre Anzahl von Elementen in einem sperrfreien Kreispuffer zu überwachen, z. B. Verwenden Sie zum Erstellen eines ObservableUpDownCounter-Objekts die CreateObservableUpDownCounter Methoden.

UpDownCounter<T>

Ein Instrument, das das Melden positiver oder negativer Metrikwerte unterstützt. UpDownCounter kann in Szenarien wie dem Melden der Änderung in aktiven Anforderungen oder der Warteschlangengröße verwendet werden.

Strukturen

Measurement<T>

Speichert einen beobachteten Metrikwert und die zugehörigen Tags. Dieser Typ wird von der Observe()-Methode eines Observable-Instruments verwendet, wenn aktuelle Messungen gemeldet werden.

Schnittstellen

IMeterFactory

Eine Factory zum Erstellen Meter Instanzen.

Delegaten

MeasurementCallback<T>

Ein Delegat, der die Rückrufe des Meterlisteners darstellt, die beim Aufzeichnen von Messungen verwendet werden.