Profiling

Le profileur Datadog nécessite Java Flight Recorder. La bibliothèque de profiling Datadog est prise en charge par OpenJDK 11+ , Oracle Java 11+ et Zulu Java 8+ (version mineure 1.8.0_212+). Tous les langages basés sur JVM, tels que Scala, Groovy, Kotlin, ou encore Clojure sont pris en charge. Pour commencer le profiling d’applications :

1. Téléchargez dd-java-agent.jar, qui contient les fichiers de classe de l’Agent Java, puis ajoutez la version dd-trace-java à votre fichier pom.xml ou à un fichier équivalent :

   wget -O dd-java-agent.jar 'https://repository.sonatype.org/service/local/artifact/maven/redirect?r=central-proxy&g=com.datadoghq&a=dd-java-agent&v=LATEST'

   Remarque : la fonctionnalité de profiling est disponible dans la bibliothèque dd-java-agent.jar dans la version 0.44 et les versions ultérieures.

2. Mettez à jour l’appel de votre service tel que ci-dessous :

   java -javaagent:dd-java-agent.jar -Ddd.profiling.enabled=true -Ddd.profiling.api-key-file=<API_KEY_FILE> -jar <YOUR_SERVICE>.jar <YOUR_SERVICE_FLAGS>

   Remarque : avec la version 0.48 ou une version ultérieure de la bibliothèque dd-java-agent.jar, si votre organisation se trouve sur le site européen de Datadog, ajoutez -Ddd.site=datadoghq.eu ou définissez DD_SITE=datadoghq.eu en tant que variable d’environnement.

3. Au bout d’une ou de deux minutes, visualisez vos profils en accédant à l’APM Datadog puis à la page Profiling.

Remarques :

• Le -javaagent doit être exécuté avant le fichier -jar, en l’ajoutant en tant qu’option JVM et non en tant qu’argument d’application. Pour en savoir plus, consultez la documentation Oracle (en anglais) :

  # Good:
  java -javaagent:dd-java-agent.jar ... -jar my-service.jar -more-flags
  # Bad:
  java -jar my-service.jar -javaagent:dd-java-agent.jar ...

• Étant donné que les profils sont envoyés directement à Datadog sans utiliser l’Agent Datadog, vous devez transmettre une clé d’API Datadog valide.

• En guise d’alternative au transfert d’arguments, vous pouvez utiliser une variable d’environnement afin de définir ces paramètres :

Le profileur Datadog nécessite Python 2.7 ou une version ultérieure. Le profiling de mémoire fonctionne uniquement sur Python 3.5 ou une version ultérieure. Pour commencer le profiling d’applications :

1. Installez ddtrace avec le type profile, qui contient le tracing et le profiling :

   pip install ddtrace[profiling]

   Remarque : la fonctionnalité de profiling est disponible dans la bibliothèque ddtrace dans la version 0.36 et les versions ultérieures.

2. Ajoutez une clé d’API Datadog valide dans votre variable d’environnement : DD_PROFILING_API_KEY.

3. Définissez env, service et version en tant que tags Datadog dans vos variables d’environnement.

   export DD_PROFILING_TAGS=env:<YOUR_ENVIRONMENT>,service:<YOUR_SERVICE>,version:<YOUR_VERSION>

4. Pour effectuer automatiquement le profiling de votre code, importez ddtrace.profile.auto. Une fois l’importation terminée, le profileur démarre :

   import ddtrace.profiling.auto

5. Au bout d’une ou de deux minutes, visualisez vos profils en accédant à l’APM Datadog puis à la page Profiling.

Remarques :

• Vous pouvez également effectuer le profiling de votre service en l’exécutant avec le wrapper pyddprofile :

  $ pyddprofile server.py

• Pour une configuration avancée du profileur ou pour ajouter des tags comme service ou version, utilisez des variables d’environnement pour définir les paramètres :

• Si vous souhaitez contrôler manuellement le cycle de vie du profileur, utilisez l’objet ddtrace.profiling.profiler.Profiler :

  from ddtrace.profiling import Profiler
  
  prof = Profiler()
  prof.start()
  
  # At shutdown
  prof.stop()

Le profileur Datadog nécessite Go 1.12 ou une version ultérieure. Pour commencer le profiling d’applications :

1. Accédez à dd-trace-go en utilisant la commande :

   go get gopkg.in/DataDog/dd-trace-go.v1/profiler

   Remarque : la fonctionnalité de profiling est disponible dans la bibliothèque dd-trace-go dans la version 1.23.0 et les versions ultérieures.

2. Importez le profileur au démarrage de votre application :

   import "gopkg.in/DataDog/dd-trace-go.v1/profiler"

3. Pour effectuer le profiling de votre code, ajoutez une clé d’API Datadog, définissez votre environnement, votre service et votre version, puis démarrez le profileur :

   err := profiler.Start(
       profiler.WithAPIKey("<DATADOG_API_KEY>")
       profiler.WithService("<SERVICE_NAME>"),
       profiler.WithEnv("<ENVIRONMENT>"),
       profiler.WithTags("version:<APPLICATION_VERSION>"),
   )
   if err != nil {
       log.Fatal(err)
   }
   defer profiler.Stop()

4. Au bout d’une ou de deux minutes, visualisez vos profils en accédant à l’APM Datadog puis à la page Profiling.

Configuration du profileur :

Une fois les profils activés, les types suivants sont recueillis :

Une fois les profils activés, les types suivants sont recueillis :

Une fois les profils activés, les types suivants sont recueillis :