System.Diagnostics.Metrics Namespace

Metriken sind im Laufe der Zeit gemeldete numerische Messungen, die am häufigsten verwendet werden, um die Integrität einer Anwendung zu überwachen und Warnungen zu generieren. Ein Webdienst kann z. B. nachverfolgen, wie viele Anforderungen er pro Sekunde empfängt, wie viele Millisekunden es bis zur Antwort gedauert hat und wie viele Antworten einen Fehler an den Benutzer zurücksandten. Diese Metriken können in regelmäßigen Abständen an ein Überwachungssystem gemeldet werden. Der System.Diagnostics.Metrics-Namespace kann verwendet werden, um Metriken zu einer Anwendung hinzuzufügen. Die APIs funktionieren auf allen Plattformen, die von .NET unterstützt werden, und sind so konzipiert, dass sie sich gut in das wachsende Ökosystem der Tools von OpenTelemetry integrieren lassen. Sie sind auch in .NET SDK-Tools wie dotnet-counters integriert. 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. Sie können beispielsweise jedes Mal aufrufen counter.Add(1) , wenn eine Anforderung verarbeitet wird, um die Gesamtanzahl der Anforderungen nachzuverfolgen. Die meisten Metrik-Viewer zeigen Leistungsindikatoren standardmäßig mit einer Rate (Anforderungen/Sek.) an, können aber auch eine kumulative Summe anzeigen.
Histogram<T>	Stellt ein Metrikinstrument dar, mit dem beliebige Werte gemeldet werden können, die wahrscheinlich statistisch aussagekräftig 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 beobachtbaren Instrumente.
Meter	Meter ist die Klasse, die für das Erstellen und Nachverfolgen der Instrumente verantwortlich ist.
MeterFactoryExtensions	Erweiterungsmethoden für Meter und IMeterFactory.
MeterListener	Die MeterListener-Klasse wird verwendet, um die Aufzeichnung der Metrikinstrumentmessungen zu lauschen.
MeterOptions	Die Optionen zum Erstellen eines Meter.
ObservableCounter<T>	Stellt ein metrikbeobachtbares 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 beobachtbare Zählerobjekt zu erstellen.
ObservableGauge<T>	Stellt ein beobachtbares Instrument dar, das nicht additive Werte meldet, wenn das Instrument beobachtet wird, z. B. die aktuelle Raumtemperatur. Rufen Sie CreateObservableGauge auf, um das beobachtbare Zählerobjekt zu erstellen.
ObservableInstrument<T>	ObservableInstrument{T} ist die Basisklasse, von der alle beobachtbaren Metrikinstrumente erben.
ObservableUpDownCounter<T>	Ein metrikbeobachtbares Instrument, das steigende oder abnehmende Werte meldet, wenn das Instrument beobachtet wird. Verwenden Sie dieses Instrument, um z. B. die Größe des Prozessheaps oder die ungefähre Anzahl von Elementen in einem sperrfreien Kreispuffer zu überwachen. Verwenden Sie die CreateObservableUpDownCounter Methoden, um ein ObservableUpDownCounter-Objekt zu erstellen.
UpDownCounter<T>	Ein Instrument, das das Melden positiver oder negativer Metrikwerte unterstützt. UpDownCounter kann in Szenarien wie der Meldung der Änderung aktiver Anforderungen oder der Warteschlangengröße verwendet werden.

Strukturen

Measurement<T>

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

Schnittstellen

IMeterFactory

Eine Factory zum Erstellen von Meter Instanzen.

Delegaten

MeasurementCallback<T>

Ein Delegat zur Darstellung der Meterlistener-Rückrufe, die beim Aufzeichnen von Messungen verwendet werden.