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.