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 une liste des métriques basées sur l’ancienne API EventCounters, consultez Compteurs disponibles.
Conseil
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
| Nom | Type d’instrument | Unité (UCUM) | Description |
|---|---|---|---|
dotnet.health_check.reports |
Compteur | {report} |
Nombre de fois qu’un rapport d’intégrité a signalé l’état d’intégrité d’une application. |
| Attribut | Type | Description | Exemples | Présence |
|---|---|---|---|---|
dotnet.health_check.status |
string | État d’intégrité d’une application. | Healthy; Unhealthy |
Toujours |
dotnet.health_check.status prend l’une des valeurs suivantes :
| Valeur | 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.0.
Métrique : dotnet.health_check.unhealthy_checks
| Nom | Type d’instrument | Unité (UCUM) | Description |
|---|---|---|---|
dotnet.health_check.unhealthy_checks |
Compteur | {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. |
| Attribut | Type | Description | Exemples | Présence |
|---|---|---|---|---|
dotnet.health_check.name |
string | Nom du contrôle d’intégrité. | ApplicationLifecycle |
Toujours |
dotnet.health_check.status |
string | État d’intégrité d’une application. | Healthy; Unhealthy |
Toujours |
dotnet.health_check.status prend l’une des valeurs suivantes :
| Valeur | 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.0.
Microsoft.Extensions.Diagnostics.ResourceMonitoring
Les métriques Microsoft.Extensions.Diagnostics.ResourceMonitoring signalent les informations sur les ressources à partir de la surveillance des ressources :
container.cpu.limit.utilizationcontainer.cpu.request.utilizationcontainer.memory.limit.utilizationprocess.cpu.utilizationdotnet.process.memory.virtual.utilizationsystem.network.connections
Remarque
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.
| Nom | Type d’instrument | Unité (UCUM) | Description |
|---|---|---|---|
container.cpu.limit.utilization |
ObservableGauge | 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 : .NET 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.
| Nom | Type d’instrument | Unité (UCUM) | Description |
|---|---|---|---|
container.cpu.request.utilization |
ObservableGauge | 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 : .NET 8.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.
| Nom | Type d’instrument | Unité (UCUM) | Description |
|---|---|---|---|
container.memory.limit.utilization |
ObservableGauge | 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 : .NET 8.8.0.
Métrique : process.cpu.utilization
| Nom | Type d’instrument | Unité (UCUM) | Description |
|---|---|---|---|
process.cpu.utilization |
ObservableGauge | 1 |
Consommation du processeur de l’application en cours d’exécution dans la plage [0, 1]. |
Disponible à partir de : .NET 8.0.
Métrique : dotnet.process.memory.virtual.utilization
| Nom | Type d’instrument | Unité (UCUM) | Description |
|---|---|---|---|
dotnet.process.memory.virtual.utilization |
ObservableGauge | 1 |
Consommation de mémoire de l’application en cours d’exécution dans la plage [0, 1]. |
Disponible à partir de : .NET 8.0.
Métrique : system.network.connections
| Nom | Type d’instrument | Unité (UCUM) | Description |
|---|---|---|---|
system.network.connections |
ObservableUpDownCounter | {connection} |
Nombre de connexions réseau par état. |
| Attribut | Type | Description | Exemples | Présence |
|---|---|---|---|---|
network.type |
string | Couche réseau OSI ou équivalent non OSI. | ipv4; ipv6 |
Toujours |
system.network.state |
string | État d’une connexion réseau. | close; listen |
Toujours |
Disponible à partir de : .NET 8.0.
