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 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 |
| 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. |
