Partager via


System.Diagnostics.Metrics Espace de noms

Les métriques sont des mesures numériques signalées au fil du temps, souvent utilisées pour 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 a fallu pour répondre et le nombre de réponses envoyées à 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 s’intégrer parfaitement à 'écosystème croissant d’outils d’OpenTelemetry. Ils s’intègrent également aux outils du SDK .NET, tels que les dotnet-counters. Une API d’écouteur est disponible pour les développeurs qui souhaitent créer des outils ou des adaptateurs personnalisés sur 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 requêtes. La plupart des visionneuses de métriques affichent des compteurs à l’aide d’un taux (requêtes/s), par défaut, mais peuvent également afficher un total cumulé.

Gauge<T>

La jauge est un instrument utilisé pour enregistrer des valeurs non additives chaque fois que des modifications se produisent. Par exemple, enregistrez la valeur du niveau de bruit d’arrière-plan de la pièce lorsque des modifications se produisent.

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 requête. Appelez CreateHistogram<T>(String, String, String) pour créer un objet Histogramme.

Instrument

Classe de base de toutes les classes d’instrument de métriques

Instrument<T>

Classe de base pour tous les instruments non observables.

InstrumentAdvice<T>

Contient les paramètres de configuration recommandés par les consommateurs de métriques lors de l’enregistrement des mesures pour un Instrument<T>donné.

Meter

Le compteur est la classe responsable de la création et du suivi des instruments.

MeterFactoryExtensions

Méthodes d’extension pour Meter et IMeterFactory.

MeterListener

MeterListener est une classe utilisée pour écouter l’enregistrement des mesures de l’instrument de métriques.

MeterOptions

Options de création d’un Meter.

ObservableCounter<T>

Représente un instrument observable par métriques qui signale une augmentation monotonique des valeurs 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 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 compteur observable.

ObservableInstrument<T>

ObservableInstrument{T} est la classe de base à partir de laquelle tous les instruments observables de métriques hériteront.

ObservableUpDownCounter<T>

Instrument observable par métriques qui signale une augmentation ou une diminution des valeurs 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 méthodes CreateObservableUpDownCounter.

UpDownCounter<T>

Instrument qui prend en charge la création de rapports de valeurs de métrique 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 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 lors de la création de rapports de mesures actuelles.

Interfaces

IMeterFactory

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