System.Diagnostics.Metrics Espace de noms

Les métriques sont des mesures numériques fournies au fil du temps. Elles servent généralement à surveiller l’intégrité d’une application et à générer des alertes. Par exemple, un service web peut suivre le nombre de demandes qu’il reçoit chaque seconde, le nombre de millisecondes qu’il lui faut pour répondre et le nombre de réponses qui renvoient une erreur à l’utilisateur. Ces métriques peuvent être signalées à un système de surveillance à intervalles fréquents et réguliers. L’espace de noms System.Diagnostics.Metrics peut être utilisé pour ajouter des métriques à une application. Les API fonctionnent sur toutes les plateformes prises en charge par .NET et sont conçues pour bien s’intégrer à l’écosystème croissant d’outils d’OpenTelemetry . Ils s’intègrent également aux outils du SDK .NET, tels que dotnet-counters. Une API d’écouteur est disponible pour les développeurs qui souhaitent créer des outils ou des adaptateurs personnalisés pour d’autres systèmes.

Classes

Counter<T>	Représente un instrument qui prend en charge l’ajout de valeurs non négatives. Par exemple, vous pouvez appeler counter.Add(1) chaque fois qu’une demande est traitée pour suivre le nombre total de demandes. La plupart des visionneuses de métriques affichent des compteurs à l’aide d’un taux (demandes/s), par défaut, mais peuvent également afficher un total cumulé.
Histogram<T>	Représente un instrument de métriques qui peut être utilisé pour signaler des valeurs arbitraires susceptibles d’être statistiquement significatives, par exemple, la durée de la demande. Appelez CreateHistogram<T>(String, String, String) pour créer un objet Histogramme.
Instrument	Classe de base de toutes les classes d’instruments de métriques
Instrument<T>	Classe de base pour tous les instruments non observables.
Meter	Meter est la classe responsable de la création et du suivi des instruments.
MeterFactoryExtensions	Méthodes d’extension pour Meter et IMeterFactory.
MeterListener	La classe MeterListener est utilisée pour écouter l’enregistrement des mesures des instruments de métriques.
MeterOptions	Options de création d’un Meter.
ObservableCounter<T>	Représente un instrument observable par les métriques qui signale des valeurs qui augmentent de façon monotone lorsque l’instrument est observé, par exemple, le temps processeur (pour différents processus, threads, mode utilisateur ou mode noyau). Appelez CreateObservableCounter pour créer l’objet de compteur observable.
ObservableGauge<T>	Représente un instrument observable qui signale des valeurs non additives lorsque l’instrument est observé, par exemple, la température ambiante actuelle. Appelez CreateObservableGauge pour créer l’objet de compteur observable.
ObservableInstrument<T>	ObservableInstrument{T} est la classe de base dont héritent tous les instruments observables de métriques.
ObservableUpDownCounter<T>	Instrument observable par les métriques qui signale des valeurs croissantes ou décroissantes lorsque l’instrument est observé. Utilisez cet instrument pour surveiller la taille du tas de processus ou le nombre approximatif d’éléments dans une mémoire tampon circulaire sans verrou, par exemple. Pour créer un objet ObservableUpDownCounter, utilisez les CreateObservableUpDownCounter méthodes .
UpDownCounter<T>	Instrument qui prend en charge le signalement de valeurs de métriques positives ou négatives. UpDownCounter peut être utilisé dans des scénarios tels que la création de rapports sur la modification des demandes actives ou de la taille de la file d’attente.

Structures

Measurement<T>

Stocke une valeur de métrique observée et ses balises associées. Ce type est utilisé par la méthode Observe() d’un instrument Observable pour signaler les mesures actuelles.

Interfaces

IMeterFactory

Fabrique pour la création d’instances Meter .

Délégués

MeasurementCallback<T>

Délégué pour représenter les rappels Meterlistener utilisés lors de l’enregistrement des mesures.