Aperçu

Les métriques d’exécution surveillent l’utilisation de la mémoire de votre application, le ramasse-miettes et la parallélisation. Les SDK 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 goulets d’étranglement, à résoudre les problèmes de performance et à optimiser l’utilisation des ressources. En visualisant les métriques d’exécution aux côtés des traces et des journaux, vous obtenez une visibilité complète sur la santé et la performance de votre application.

Si vous instrumentez votre application avec OpenTelemetry au lieu des bibliothèques de traçage Datadog, consultez Métriques d’exécution OpenTelemetry pour les instructions d’installation.

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 d’installation

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

1. Configurer l’Agent Datadog

Activer DogStatsD pour l’Agent. Par défaut, l’Agent Datadog est configuré pour ingérer des 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. Vérifiez que le trafic non local de DogStatsD est activé. Ce paramètre est activé par défaut. Si vous l’avez désactivé précédemment, définissez dogstatsd_non_local_traffic: true dans votre fichier de configuration principal datadog.yaml, ou définissez la variable d’environnement DD_DOGSTATSD_NON_LOCAL_TRAFFIC=true.
2. Suivez ces instructions de configuration spécifiques au conteneur :

3. Définissez DD_SITE dans l’Agent Datadog pour pour garantir que l’Agent envoie les données vers l’emplacement Datadog approprié.

2. Configurez votre application

Configurez les métriques d’exécution dans votre application en utilisant des variables d’environnement. Certaines langues prennent également en charge la configuration des métriques d’exécution 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 et .NET 6+ (v3.40.0+), false pour tous les autres langages et environnements d’exécution.
Description: Active la collecte de métriques d’exécution. Les métriques sont envoyées à l’agent Datadog, comme configuré pour 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 signalé.
Description : Active des métriques d’exécution améliorées, fournissant un runtime_id tag avec chaque métrique. Le runtime_id représente l’identifiant de processus de l’application et vous permet de corréler directement les métriques d’exécution avec les applications en cours d’exécution individuelles.

DD_AGENT_HOST

Par défaut : localhost
Description : Définit l’adresse hôte pour la soumission des métriques du SDK. Peut être un nom d’hôte ou une adresse IP.

DD_DOGSTATSD_PORT

Par défaut : 8125
Description : Définit le port pour la soumission des métriques du SDK.

DD_RUNTIME_METRICS_DIAGNOSTICS_METRICS_API_ENABLED

Par défaut: true démarrage du traceur v3.40.0+ sur .NET 8+ et (.NET 6/7 lorsque DD_RUNTIME_METRICS_ENABLED n’est pas explicitement défini), sinon false.
Description: Disponible à partir de .NET 6. Cela contrôle si le traceur .NET utilise la nouvelle System.Diagnostics.Metrics API pour collecter les métriques au lieu du collecteur basé sur EventListener.

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' # Use 'ddtrace' if you're using v1.x

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

  # Optionally, you can configure the DogStatsD instance used for sending runtime metrics.
  # DogStatsD is automatically configured with default settings if `dogstatsd-ruby` is available.
  # You can configure with host and port of Datadog agent; defaults to 'localhost:8125'.
  c.runtime_metrics.statsd = Datadog::Statsd.new
end

// Basic configuration
tracer.Start(tracer.WithRuntimeMetrics())

// With custom DogStatsD address
tracer.Start(
  tracer.WithRuntimeMetrics(),
  tracer.WithDogstatsdAddr("custom-host:8125")
)

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

Tableaux de bord

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

• La page de détails du service instrumenté
• L’onglet du graphique de flamme Métriques
• Tableaux de bord d’exécution par défaut

Dépannage

• Pour associer les métriques d’exécution dans les graphiques de flamme, assurez-vous que le tag env (sensible à la casse) est défini et correspond à travers votre environnement.
• Pour que les métriques d’exécution apparaissent sur la page du service lors de l’utilisation de Fargate, assurez-vous que DD_DOGSTATSD_TAGS est défini sur votre tâche Agent, et que le tag env configuré correspond à env 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.

jvm.gc.cms.count   => jvm.gc.minor_collection_count
                      jvm.gc.major_collection_count
jvm.gc.parnew.time => jvm.gc.minor_collection_time
                      jvm.gc.major_collection_time

Lectures complémentaires

Documentation, liens et articles supplémentaires utiles:

Métriques de runtime OpenTelemetryDOCUMENTATION Corréler vos logs et vos tracesDOCUMENTATION Gérer vos applications manuellement pour créer des traces.DOCUMENTATION Explorer vos services, ressources et tracesDOCUMENTATION