Présentation

Les métriques runtime surveillent l’utilisation de la mémoire, la collecte des déchets et la parallélisation de votre application. Les bibliothèques de tracing Datadog collectent automatiquement ces métriques pour les environnements pris en charge et les envoient à l’Agent Datadog.

Ces métriques vous aident à identifier les goulots d’étranglement, à résoudre les problèmes de performance et à optimiser l’utilisation des ressources. En visualisant les métriques runtime conjointement avec les traces et les logs, vous obtenez une visibilité complète sur la santé et les performances de votre application.

Compatibilité

Les métriques runtime sont disponibles pour plusieurs langages de programmation et environnements d’exécution, avec des niveaux de support et des options de configuration variables.

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

Instructions de configuration

Pour configurer les métriques runtime, vous devez configurer à la fois l’Agent Datadog et votre application.

1. Configurer l’Agent Datadog

Activez DogStatsD pour l’Agent. Par défaut, l’Agent Datadog est configuré pour ingérer les métriques via UDP sur le port 8125.

Configuration spécifique au conteneur

Lors de l’exécution de l’Agent dans des environnements conteneurisés, une configuration supplémentaire est nécessaire :

1. Définissez dogstatsd_non_local_traffic: true dans votre fichier principal de configuration datadog.yaml, ou définissez la variable d’environnement DD_DOGSTATSD_NON_LOCAL_TRAFFIC=true.
2. Suivez ces instructions de configuration spécifiques aux conteneurs :

3. Définissez DD_SITE dans l’Agent Datadog sur pour vous assurer que l’Agent envoie les données au bon site Datadog.

2. Configurer votre application

Configurez les métriques runtime dans votre application a l’aide de variables d’environnement. Certains langages prennent également en charge la configuration des métriques runtime directement dans le code.

Variables d’environnement

Utilisez les variables d’environnement suivantes pour configurer les métriques runtime dans votre application :

DD_RUNTIME_METRICS_ENABLED

Par défaut : true pour Java, false pour les autres langages<br> Description : Active la collecte des métriques runtime. Les métriques sont envoyées à l’Agent Datadog, selon la configuration de l’application instrumentée.

DD_RUNTIME_METRICS_RUNTIME_ID_ENABLED

Par défaut : true pour Java, false pour Node.js, Ruby et Python. N’existe pas pour .NET et Go ; le runtime_id est toujours rapporté.<br> Description : Active les métriques runtime améliorées, en ajoutant un tag runtime_id à chaque métrique. Le runtime_id représente l’identifiant du processus de l’application et permet de corréler directement les métriques runtime avec chaque application en cours d’exécution.

DD_AGENT_HOST

Par défaut : localhost <br> Description : Définit l’adresse du host pour la soumission des métriques par la bibliothèque de tracing. Il peut s’agir d’un nom de host ou d’une adresse IP.

DD_DOGSTATSD_PORT

Par défaut : 8125
Description : Définit le port pour l’envoi des métriques par la bibliothèque de tracing.

Configuration basée sur le code

En plus des variables d’environnement, certains langages permettent de configurer les métriques runtime directement dans le code.

from ddtrace.runtime import RuntimeMetrics
RuntimeMetrics.enable()

# config/initializers/datadog.rb
require 'datadog/statsd'
require 'datadog' # Utilisez 'ddtrace' si vous utilisez v1.x

Datadog.configure do |c|
  c.runtime_metrics.enabled = true

  # Vous pouvez, si vous le souhaitez, configurer l'instance DogStatsD utilisée pour l'envoi des métriques runtime.
  # DogStatsD est automatiquement configuré avec les paramètres par défaut si `dogstatsd-ruby` est disponible.   
  # Vous pouvez la configurer avec le host et le port de l'Agent Datadog ; la valeur par défaut est 'localhost:8125'.
  c.runtime_metrics.statsd = Datadog::Statsd.new
end

// Configuration basique
tracer.Start(tracer.WithRuntimeMetrics())

// Avec une adresse DogStatsD personnalisée
tracer.Start(
  tracer.WithRuntimeMetrics(),
  tracer.WithDogstatsdAddr("custom-host:8125")
)

const tracer = require('dd-trace').init({
  // Autres options du tracer...
  runtimeMetrics: true
})

Dashboards

Une fois la configuration terminée, vous pouvez afficher les métriques runtime dans :

• La page des détails du service instrumenté
• L’onglet Metrics du flame graph
• Dashboards runtime par défaut

Dépannage

• Pour associer les métriques runtime aux flame graphs, assurez-vous que le tag env (sensible à la casse) est défini et identique dans tout votre environnement.
• Pour que les métriques runtime s’affichent sur la page du service lorsque vous utilisez Fargate, assurez-vous que DD_DOGSTATSD_TAGS est défini sur la tâche de votre Agent, et que le tag env configuré correspond à celui du service instrumenté.

Données collectées

Chaque langage pris en charge collecte un ensemble de métriques runtime fournissant des informations sur l’utilisation de la mémoire, la collecte des déchets, l’utilisation du CPU et d’autres indicateurs de performance.

Pour aller plus loin

Documentation, liens et articles supplémentaires utiles:

Corréler vos logs et vos tracesDOCUMENTATION Instrumenter vos applications manuellement pour créer des tracesDOCUMENTATION Explorer vos services, ressources et tracesDOCUMENTATION