Métriques runtime .NET

Métriques runtime .NET

Métriques runtime compatibles

  • .NET Framework 4.5+
  • .NET Core 3.1
  • .NET 5

Configuration automatique

Activez la collecte de métriques runtime dans le traceur .NET 1.23.0+ avec la variable d’environnement DD_RUNTIME_METRICS_ENABLED=true.

Visualisez vos métriques runtime en corrélation avec vos services .NET. Consultez la page Service dans Datadog.

Par défaut, les métriques runtime de votre application sont envoyées à l’Agent Datadog via DogStatsD sur le port 8125. Vérifiez que DogStatsD est activé pour l’Agent.

Si vous exécutez l’Agent en tant que conteneur, vérifiez que DD_DOGSTATSD_NON_LOCAL_TRAFFIC est définie sur true et que le port 8125 est ouvert sur l’Agent. En outre, pour :

Données collectées

Les métriques suivantes sont recueillies par défaut après l’activation des métriques .NET.

runtime.dotnet.cpu.system
(gauge)
The number of seconds executing in the kernel
Shown as second
runtime.dotnet.cpu.user
(gauge)
The number of seconds executing outside the kernel
Shown as second
runtime.dotnet.cpu.percent
(gauge)
The percentage of total CPU used by the application
Shown as percent
runtime.dotnet.mem.committed
(gauge)
Memory usage
Shown as byte
runtime.dotnet.threads.count
(gauge)
The number of threads
Shown as thread
runtime.dotnet.threads.workers_count
(gauge)
The number of workers in the threadpool (.NET Core only)
Shown as thread
runtime.dotnet.threads.contention_time
(gauge)
The cumulated time spent by threads waiting on a lock (.NET Core only)
Shown as millisecond
runtime.dotnet.threads.contention_count
(count)
The number of times a thread stopped to wait on a lock
runtime.dotnet.exceptions.count
(count)
The number of first-chance exceptions
Shown as exception
runtime.dotnet.gc.size.gen0
(gauge)
The size of the gen 0 heap
Shown as byte
runtime.dotnet.gc.size.gen1
(gauge)
The size of the gen 1 heap
Shown as byte
runtime.dotnet.gc.size.gen2
(gauge)
The size of the gen 2 heap
Shown as byte
runtime.dotnet.gc.size.loh
(gauge)
The size of the large object heap
Shown as byte
runtime.dotnet.gc.memory_load
(gauge)
The percentage of the total memory used by the process. The GC changes its behavior when this value gets above 85. (.NET Core only)
Shown as percent
runtime.dotnet.gc.pause_time
(gauge)
The amount of time the GC paused the application threads (.NET Core only)
Shown as millisecond
runtime.dotnet.gc.count.gen0
(count)
The number of gen 0 garbage collections
Shown as garbage collection
runtime.dotnet.gc.count.gen1
(count)
The number of gen 1 garbage collections
Shown as garbage collection
runtime.dotnet.gc.count.gen2
(count)
The number of gen 2 garbage collections
Shown as garbage collection
runtime.dotnet.aspnetcore.requests.total
(gauge)
The total number of HTTP requests received by the server (.NET Core only)
Shown as request
runtime.dotnet.aspnetcore.requests.failed
(gauge)
The number of failed HTTP requests received by the server (.NET Core only)
Shown as request
runtime.dotnet.aspnetcore.requests.current
(gauge)
The total number of HTTP requests that have started but not yet stopped (.NET Core only)
Shown as request
runtime.dotnet.aspnetcore.requests.queue_length
(gauge)
The current length of the server HTTP request queue (.NET Core only)
Shown as request
runtime.dotnet.aspnetcore.connections.total
(gauge)
The total number of HTTP connections established to the server (.NET Core only)
Shown as connection
runtime.dotnet.aspnetcore.connections.current
(gauge)
The current number of active HTTP connections to the server (.NET Core only)
Shown as connection
runtime.dotnet.aspnetcore.connections.queue_length
(gauge)
The current length of the HTTP server connection queue (.NET Core only)
Shown as connection

Datadog fournit non seulement ces métriques sur votre page Service de l’APM, mais également un dashboard de runtime .NET par défaut comportant les tags service et runtime-id appliqués à ces métriques.

Autorisations supplémentaires pour IIS

Sur .NET Framework, les métriques peuvent être recueillies à l’aide de compteurs de performances. Les utilisateurs avec une session ouverte non interactive (notamment ceux avec des comptes de pool d’applications IIS et certains comptes de service) doivent être ajoutés au groupe Performance Monitoring Users pour accéder aux données des compteurs.

Les pools d’applications IIS utilisent des comptes spéciaux qui n’apparaissent pas dans la liste des utilisateurs. Pour les ajouter au groupe Performance Monitoring Users, recherchez IIS APPPOOL\<nom du pool>. Par exemple, l’utilisateur pour DefaultAppPool est IIS APPPOOL\DefaultAppPool.

Vous pouvez effectuer cette opération depuis l’interface Computer Management, ou depuis l’invite de commandes administrateur :

net localgroup "Performance Monitor Users" "IIS APPPOOL\DefaultAppPool" /add

Pour aller plus loin