Métriques runtime Python
Cette fonctionnalité est actuellement en version bêta privée.
Contactez l'assistance afin de demander son activation pour votre compte.
Configuration automatique
Il est possible d’activer la collecte de métriques runtime avec le paramètre d’environnement DD_RUNTIME_METRICS_ENABLED=true
pour une exécution avec ddtrace-run
.
Si vous n’utilisez pas ddtrace-run
, vous pouvez activer la collecte de métriques runtime dans votre code :
from ddtrace.runtime import RuntimeMetrics
RuntimeMetrics.enable()
Les métriques runtime peuvent être visualisées conjointement à vos services Python. Consultez la page Service dans Datadog.
Remarque : pour l’IU de runtime, ddtrace
>= 0.24.0
est pris en charge.
Par défaut, les métriques runtime de votre application sont envoyées à l’Agent Datadog par le biais de DogStatsD sur le port 8125
. Veillez à ce que DogStatsD soit activé pour l’Agent.
Si vous exécutez l’Agent en tant que conteneur, assurez-vous que DD_DOGSTATSD_NON_LOCAL_TRAFFIC
est défini sur true et que le port 8125
est ouvert sur l’Agent.
Dans Kubernetes, liez le port DogstatsD au port d’un host ; dans ECS, indiquez les flags pertinents dans la définition de votre tâche.
Données collectées
Les métriques suivantes sont recueillies par défaut après l’activation des métriques runtime :
runtime.python.cpu.time.sys (gauge) | Number of seconds executing in the kernel Shown as second |
runtime.python.cpu.time.user (gauge) | Number of seconds executing outside the kernel Shown as second |
runtime.python.cpu.percent (gauge) | CPU utilization percentage Shown as percent |
runtime.python.cpu.ctx_switch.voluntary (gauge) | Number of voluntary context switches Shown as invocation |
runtime.python.cpu.ctx_switch.involuntary (gauge) | Number of involuntary context switches Shown as invocation |
runtime.python.gc.count.gen0 (gauge) | Number of generation 0 objects Shown as resource |
runtime.python.gc.count.gen1 (gauge) | Number of generation 1 objects Shown as resource |
runtime.python.gc.count.gen2 (gauge) | Number of generation 2 objects Shown as resource |
runtime.python.mem.rss (gauge) | Resident set memory Shown as byte |
runtime.python.thread_count (gauge) | Number of threads Shown as thread |
Datadog fournit non seulement ces métriques sur votre page Service de l’APM, mais également un dashboard de métriqu de runtime Python par défaut comportant les tags service
et runtime-id
appliqués à ces métriques.
Pour aller plus loin
Documentation, liens et articles supplémentaires utiles: