System.Diagnostics.Metrics Namespace
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 einer Anwendung Metriken hinzuzufügen. Die APIs funktionieren auf allen Plattformen, die von .NET unterstützt werden, und sind so konzipiert, dass sie gut in das wachsende Ökosystem an Tools von OpenTelemetry integriert werden. Sie können auch in .NET SDK-Tools wie dotnet-counters integriert werden. 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 |
Histogram<T> |
Stellt ein Metrikinstrument dar, das verwendet werden kann, um beliebige Werte zu melden, die wahrscheinlich statistisch sinnvoll sind, z. B. die Dauer der Anforderung. 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 überwachen. |
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 auf CreateObservableCounter , 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 auf CreateObservableGauge , 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 Prozessheapgröße 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 dem Melden 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. |
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Tickets als Feedbackmechanismus für Inhalte auslaufen lassen und es durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter:Einreichen und Feedback anzeigen für