Partager via


Métriques d’extensions .NET

Cet article décrit les métriques intégrées pour les bibliothèques d’extensions .NET de diagnostic produites à l’aide de l’API System.Diagnostics.Metrics. Pour obtenir la liste des métriques basées sur l’ancienne API EventCounters , consultez Compteurs disponibles.

Tip

Pour plus d’informations sur la collecte et le rapport de ces métriques, consultez Collecte de métriques.

Microsoft.Extensions.Diagnostics.HealthChecks

Les métriques Microsoft.Extensions.Diagnostics.HealthChecks signalent les informations de contrôle d’intégrité des vérifications d’intégrité de .NET :

Vous pouvez activer ces métriques en appelant la méthode d’extension AddTelemetryHealthCheckPublisher . Ces métriques ne peuvent être activées que pour les métriques push et ne sont pas disponibles pour les métriques basées sur extraction.

Métrique : dotnet.health_check.reports
Name Type d’instrument Unité (UCUM) Description
dotnet.health_check.reports Counter<T> {report} Nombre de fois qu’un rapport d’intégrité a signalé l’état d’intégrité d’une application.
Attribute Type Description Examples Presence
dotnet.health_check.status string État d’intégrité d’une application. Healthy; Unhealthy Always

dotnet.health_check.status prend l’une des valeurs suivantes :

Value Description
Degraded Une application était dans un état détérioré.
Healthy Une application était saine.
Unhealthy Une application n’était pas saine.

Disponible à partir de : .NET 8.

Métrique : dotnet.health_check.unhealthy_checks
Name Type d’instrument Unité (UCUM) Description
dotnet.health_check.unhealthy_checks Counter<T> {unhealthy_check} Nombre de fois qu’une vérification d’intégrité a signalé l’état d’intégrité d’une application comme Degraded ou Unhealthy.
Attribute Type Description Examples Presence
dotnet.health_check.name string Nom du contrôle d’intégrité. ApplicationLifecycle Always
dotnet.health_check.status string État d’intégrité d’une application. Healthy; Unhealthy Always

dotnet.health_check.status prend l’une des valeurs suivantes :

Value Description
Degraded Une application était dans un état détérioré.
Healthy Une application était saine.
Unhealthy Une application n’était pas saine.

Disponible à partir de : .NET 8.

Microsoft.Extensions.Diagnostics.ResourceMonitoring

Les métriques signalent les informations sur les Microsoft.Extensions.Diagnostics.ResourceMonitoring ressources à partir de la surveillance des ressources :

Note

Les métriques émises par le compteur Microsoft.Extensions.Diagnostics.ResourceMonitoring sont en phase expérimentale. Cela signifie qu’il pourrait y avoir des changements cassants.

Métrique : container.cpu.limit.utilization

L’instrument est disponible uniquement sur un système s’exécutant sur des conteneurs sur Windows et Linux.

Name Type d’instrument Unité (UCUM) Description
container.cpu.limit.utilization ObservableGauge<T> 1 Consommation du processeur de l’application en cours d’exécution par rapport à la limite de ressources dans la plage [0, 1].

Disponible à partir de Microsoft.Extensions.Diagnostics.ResourceMonitoring la version 8.8.0.

Métrique : container.cpu.request.utilization

L’instrument est disponible uniquement sur un système s’exécutant sur des conteneurs sur Linux.

Name Type d’instrument Unité (UCUM) Description
container.cpu.request.utilization ObservableGauge<T> 1 Consommation du processeur de l’application conteneurisée en cours d’exécution par rapport à la demande de ressource dans la plage [0, 1].

Disponible à partir de Microsoft.Extensions.Diagnostics.ResourceMonitoring la version 8.8.0.

Métrique : container.cpu.time

L’instrument est disponible uniquement sur un système s’exécutant sur un conteneur sur Windows ou Linux.

Name Type d’instrument Unité (UCUM) Description
container.cpu.time ObservableCounter<T> s Temps processeur utilisé par le conteneur.

Disponible à partir de Microsoft.Extensions.Diagnostics.ResourceMonitoring la version 9.8.0.

Métrique : container.memory.limit.utilization

L’instrument est disponible uniquement sur un système s’exécutant sur des conteneurs sur Windows et Linux.

Name Type d’instrument Unité (UCUM) Description
container.memory.limit.utilization ObservableGauge<T> 1 Consommation de mémoire de l’application en cours d’exécution par rapport à la limite de ressources dans la plage [0, 1].

Disponible à partir de Microsoft.Extensions.Diagnostics.ResourceMonitoring la version 8.8.0.

Métrique : container.memory.usage

L’instrument est disponible uniquement sur un système s’exécutant sur des conteneurs sur Windows ou Linux.

Name Type d’instrument Unité (UCUM) Description
container.memory.usage ObservableUpDownCounter<T> By Utilisation de la mémoire de tous les processus dans le conteneur mesuré en octets.

Disponible à partir de Microsoft.Extensions.Diagnostics.ResourceMonitoring la version 9.8.0.

Métrique : process.cpu.utilization
Name Type d’instrument Unité (UCUM) Description
process.cpu.utilization ObservableGauge<T> 1 Consommation du processeur de l’application en cours d’exécution dans la plage [0, 1].

Disponible à partir de : .NET 8.

Métrique : dotnet.process.memory.virtual.utilization
Name Type d’instrument Unité (UCUM) Description
dotnet.process.memory.virtual.utilization ObservableGauge<T> 1 Consommation de mémoire de l’application en cours d’exécution dans la plage [0, 1].

Disponible à partir de : .NET 8.

Métrique : system.network.connections
Name Type d’instrument Unité (UCUM) Description
system.network.connections ObservableUpDownCounter<T> {connection} Nombre de connexions réseau par état.
Attribute Type Description Examples Presence
network.type string Couche réseau OSI ou équivalent non OSI. ipv4; ipv6 Always
system.network.state string État d’une connexion réseau. close; listen Always

Disponible à partir de : .NET 8.