Exigences de compatibilité

Le dernier traceur Java prend en charge toutes les versions de JVM à partir de 8. Pour des informations supplémentaires sur les versions de JVM inférieures à 8, lisez Runtimes JVM pris en charge.

Pour obtenir la liste complète des frameworks et versions Java pris en charge (y compris les anciennes versions et les versions de maintenance), consultez la section relative aux exigences de compatibilité.

Démarrage

Avant de commencer, vérifiez que vous avez bien installé et configuré l’Agent.

Instrumentez votre application

Après avoir installé et configuré votre agent Datadog, l’étape suivante consiste à ajouter le SDK directement dans l’application pour l’instrumenter. En savoir plus sur informations de compatibilité.

Pour commencer à tracer vos applications :

1. Téléchargez dd-java-agent.jar qui contient les derniers fichiers de classe du traceur, dans un dossier accessible par votre utilisateur Datadog :

wget -O dd-java-agent.jar 'https://dtdg.co/latest-java-tracer'

curl -Lo dd-java-agent.jar 'https://dtdg.co/latest-java-tracer'

ADD 'https://dtdg.co/latest-java-tracer' dd-java-agent.jar

Remarque : Pour télécharger la dernière version d’une version majeure spécifique, utilisez le https://dtdg.co/java-tracer-vX lien à la place, où X est la version majeure souhaitée. Par exemple, utilisez https://dtdg.co/java-tracer-v1 pour la dernière version 1. Les numéros de version mineure ne doivent pas être inclus. Vous pouvez également récupérer n’importe quelle version spécifique depuis le référentiel Maven de Datadog.

Remarque : Les versions candidates (Release Candidate) sont disponibles sur GitHub DataDog/dd-trace-java releases. Celles-ci contiennent “RC” dans la version et sont recommandées pour des tests en dehors de votre environnement de production. Vous pouvez vous abonner aux notifications de version GitHub pour être informé lorsque de nouveaux Release Candidates sont disponibles pour des tests. Si vous rencontrez des problèmes avec les versions candidates (Release Candidates), contactez le support Datadog.

2. Pour exécuter votre application depuis un IDE, un script d’application Maven ou Gradle, ou java -jar une commande, avec le Continuous Profiler, le suivi des déploiements et l’injection de journaux (si vous envoyez des journaux à Datadog), ajoutez l’argument -javaagent JVM et les options de configuration suivantes, selon le cas :

   java -javaagent:/path/to/dd-java-agent.jar -Ddd.profiling.enabled=true -Ddd.logs.injection=true -Ddd.service=my-app -Ddd.env=staging -Ddd.version=1.0 -jar path/to/your/app.jar
   

   Note: If you have a strong need to reduce the size of your image and omit modules, you can use the jdeps command to identify dependencies. However, required modules can change over time, so do this at your own risk.

   Note: When running the SDK with Java 24+, you may see warnings related to JNI native access. Suppress these warnings by adding the --enable-native-access=ALL-UNNAMED flag. See JEP 472 for more details.

   L'activation du profilage peut avoir un impact sur votre facture en fonction de votre forfait APM. Consultez la page de tarification pour plus d'informations.

Des options de configuration supplémentaires sont décrites ci-dessous.

Ajoutez le SDK Java à la JVM

Utilisez la documentation de votre serveur d’application pour déterminer la bonne façon de passer -javaagent et d’autres arguments JVM. Voici des instructions pour certains frameworks couramment utilisés :

JAVA_OPTS=-javaagent:/path/to/dd-java-agent.jar

-javaagent:C:\path\to\dd-java-agent.jar

JAVA_OPTS="$JAVA_OPTS -javaagent:/path/to/dd-java-agent.jar"

set "JAVA_OPTS=%JAVA_OPTS% -javaagent:X:/path/to/dd-java-agent.jar"

<option value="-javaagent:/path/to/dd-java-agent.jar"/>

JAVA_OPTIONS="${JAVA_OPTIONS} -javaagent:/path/to/dd-java-agent.jar"

-javaagent:/path/to/dd-java-agent.jar

-javaagent:/path/to/dd-java-agent.jar

Remarque

• Si vous ajoutez l’argument -javaagent à votre commande java -jar, il doit être ajouté avant l’argument -jar, en tant qu’option JVM, et non en tant qu’argument d’application. Exemple :

  java -javaagent:/path/to/dd-java-agent.jar -jar my_app.jar
  

  For more information, see the Oracle documentation.

• N’ajoutez jamais dd-java-agent à votre classpath. Cela peut provoquer un comportement inattendu.

Instrumentation automatique

L’instrumentation automatique pour Java utilise les capacités d’instrumentation java-agent fournies par la JVM. Lorsqu’un java-agent est enregistré, il peut modifier les fichiers de classe au moment du chargement.

Remarque : Les classes chargées avec un ClassLoader distant ne sont pas instrumentées automatiquement.

L’instrumentation peut provenir de l’auto-instrumentation, de l’API OpenTracing, ou d’un mélange des deux. L’instrumentation capture généralement les informations suivantes :

• La durée de temporisation est capturée à l’aide de l’horloge NanoTime de la JVM, sauf si un horodatage est fourni par l’API OpenTracing
• Paires de balises clé/valeur
• Erreurs et traces de pile qui ne sont pas gérées par l’application
• Un compte total de traces (requêtes) circulant dans le système

Configuration

Si nécessaire, configurez le SDK pour envoyer les données de télémétrie de performance de l’application selon vos besoins, y compris la configuration du Unified Service Tagging. Lisez Configuration de la bibliothèque pour plus de détails.

Configuration distante

La Configuration distante permet à l’Agent Datadog de configurer dynamiquement les paramètres de traçage sans nécessiter de redémarrages d’application. Par défaut, la Configuration distante est activée. Pour le désactiver, définissez la variable d’environnement :

DD_REMOTE_CONFIG_ENABLED=false

Ou ajoutez la propriété système JVM :

-Ddd.remote_config.enabled=false

Lectures complémentaires

Documentation, liens et articles supplémentaires utiles:

Code source de l'APM Datadog JavaCODE SOURCE Explorer vos services, ressources et tracesDOCUMENTATION Configurez APM pour les applications JavaCENTRE D'APPRENTISSAGE