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 so konzipiert, dass sie gut in OpenTelemetry wachsendes Ökosystem von Tools integriert werden können. 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

Name	Beschreibung
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 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. Aufrufen CreateHistogram<T>(String, String, String) zum Erstellen eines Histogrammobjekts.
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 Methode 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 eines 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 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 dem Melden der Änderung in aktiven Anforderungen oder der Warteschlangengröße verwendet werden.

Strukturen

Name	Beschreibung
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

Name	Beschreibung
IMeterFactory	Eine Factory zum Erstellen von Meter Instanzen.

Delegaten

Name	Beschreibung
MeasurementCallback<T>	Ein Delegat, der die Rückrufe des Meterlisteners darstellt, die beim Aufzeichnen von Messungen verwendet werden.