Compatibilité

La bibliothèque de tracing Datadog Java est open source. Consultez le référentiel GitHub pour en savoir plus.

Java runtimes pris en charge

Le Java Tracer prend en charge l’instrumentation automatique pour les runtimes Oracle JDK, OpenJDK JVM et GraalVM.

Java Tracer v1 (latest)

Datadog ne prend pas officiellement en charge les versions de Java en accès anticipé.

Java Tracer v0

Niveaux de support

Intégrations

Les intégrations en aperçu sont désactivées par défaut mais peuvent être activées individuellement :

• Propriété système : -Ddd.integration.<INTEGRATION_NAME>.enabled=true
• Variable d’environnement : DD_INTEGRATION_<INTEGRATION_NAME>_ENABLED=true

Compatibilité des frameworks web

dd-java-agent inclut le support pour le traçage automatique des frameworks web suivants.

Le traçage des frameworks web fournit :

• le temps de la requête HTTP à la réponse
• les balises pour la requête HTTP (code d’état, méthode, etc.)
• la capture des erreurs et des traces de pile
• le lien entre le travail créé dans une requête web et le traçage distribué

Remarque : De nombreux serveurs d’applications sont compatibles avec Servlet et sont automatiquement couverts par cette instrumentation, tels que Websphere, Weblogic et JBoss. De plus, des frameworks comme Spring Boot (version 3) fonctionnent intrinsèquement car ils utilisent généralement un serveur d’application intégré pris en charge, tel que Tomcat, Jetty ou Netty.

Intégrations de framework désactivées par défaut

Les instrumentations suivantes sont désactivées par défaut et peuvent être activées avec les paramètres suivants :

Remarque : L’instrumentation d’intégration JAX-WS couvre les endpoints annotés avec @WebService (JAX-WS 1.x) et @WebServiceProvider (JAX-WS 2.x).

Vous ne voyez pas vos frameworks web souhaités ? Datadog ajoute continuellement un support supplémentaire. Contactez le support Datadog si vous avez besoin d’aide.

Compatibilité des frameworks de mise en réseau

dd-java-agent inclut le support pour le traçage automatique des frameworks de mise en réseau suivants.

Le traçage réseau fournit :

• le temps de la demande à la réponse
• les tags pour la demande (par exemple, le code de réponse)
• la capture des erreurs et des traces de pile
• le traçage distribué

Note Kafka : L’intégration Kafka de Datadog fonctionne avec la version Kafka 0.11+, qui prend en charge l’API Header. Cette API est utilisée pour injecter et extraire le contexte de trace. Si vous exécutez un environnement avec des versions mixtes, le courtier Kafka peut signaler incorrectement la version plus récente de Kafka. Cela pose un problème lorsque le SDK essaie d’injecter des en-têtes qui ne sont pas pris en charge par le producteur local. De plus, les consommateurs plus anciens ne peuvent pas consommer le message en raison de la présence d’en-têtes. Pour éviter ces problèmes, si vous exécutez un environnement Kafka avec des versions mixtes antérieures à 0.11, désactivez la propagation du contexte avec la variable d’environnement : DD_KAFKA_CLIENT_PROPAGATION_ENABLED=false.

Note JMS : L’intégration JMS de Datadog ajoute et lit automatiquement les propriétés des objets de message x__dash__datadog__dash__trace__dash__id et x__dash__datadog__dash__parent__dash__id pour maintenir la propagation du contexte entre les services consommateurs et producteurs.

Note Camel : La propagation de trace distribuée sur les routes Camel n’est pas prise en charge.

Note SOFA RPC : L’intégration SOFA RPC de Datadog prend en charge les protocoles de transport Bolt, Triple et REST. Triple utilise le transport gRPC ; le traçage distribué pour les appels Triple nécessite que l’intégration grpc reste activée.

Vous ne voyez pas le framework réseau souhaité ? Datadog ajoute continuellement un support supplémentaire. Contactez le support Datadog si vous avez besoin d’aide.

Compatibilité des magasins de données

dd-java-agent inclut le support pour le traçage automatique des frameworks/drivers de base de données suivants.

Le traçage des magasins de données fournit :

• temps de la requête à la réponse
• informations de requête (par exemple, une chaîne de requête assainie)
• capture d’erreur et de stacktrace

Remarque : Redis 6.0+ prend en charge l’authentification en ligne dans des commandes telles que HELLO, MIGRATE et ACL SETUSER.

• Agent de trace Datadog : La version minimale requise et recommandée est 7.76.1 pour garantir que les paramètres d’authentification sont automatiquement obfusqués dans les métadonnées de trace.
• Extension Lambda Datadog (environnements sans serveur) : La version minimale requise est v28.0.0.

dd-java-agent est également compatible avec les pilotes JDBC courants, y compris :

• Apache Derby
• Firebird SQL
• H2 Database Engine
• HSQLDB
• IBM DB2
• MariaDB
• MSSQL (Microsoft SQL Server)
• MySQL
• Oracle
• Postgres SQL
• ScalikeJDBC

Intégrations de base de données désactivées par défaut

Les instrumentations suivantes sont désactivées par défaut et peuvent être activées avec les paramètres suivants :

Vous ne voyez pas vos magasins de données souhaités ? Datadog ajoute continuellement un support supplémentaire. Contactez le support Datadog si vous avez besoin d’aide.

Compatibilité supplémentaire avec les frameworks

dd-java-agent inclut le support pour le traçage automatique des frameworks suivants.

Vous ne voyez pas les frameworks souhaités ? Datadog ajoute continuellement un support supplémentaire. Pour demander un framework, contactez notre équipe de support.

Pour améliorer la visibilité des applications utilisant des frameworks non pris en charge, considérez l’une des solutions suivantes :

• Ajout d’instrumentation personnalisée.
• Soumettre un pull request avec instrumentation pour inclusion dans une future version.
• Contacter le support Datadog et soumettre une demande de fonctionnalité.

Désactiver les intégrations

La plupart des intégrations sont activées par défaut. Le paramètre suivant peut modifier la configuration par défaut afin de la désactiver.

• Propriété système : -Ddd.integrations.enabled=false
• Variable d’environnement : DD_INTEGRATIONS_ENABLED=false

Les intégrations peuvent être activées ou désactivées individuellement (ce qui remplace la valeur par défaut ci-dessus).

• Propriété système : -Ddd.integration.<INTEGRATION_NAME>.enabled=true
• Variable d’environnement : DD_INTEGRATION_<INTEGRATION_NAME>_ENABLED=true

(Le nom de chaque intégration est affiché ci-dessus.)

Problèmes connus

• L’exécution du traceur Java dans Bitbucket n’est pas prise en charge.
• Charger plusieurs agents Java qui effectuent des fonctions APM/tracing n’est pas une configuration recommandée ou prise en charge.
• Lors de l’exécution du SDK avec Java 24+, vous pouvez voir des avertissements liés à l’accès natif JNI. Supprimez ces avertissements en ajoutant l’option --enable-native-access=ALL-UNNAMED. Voir JEP 472 pour plus d’informations.

Support de chargement et de liaison de classes à l’avance (AOT)

Pour améliorer le temps de démarrage, le chargement et la liaison de classes à l’avance (AOT) rendent les classes d’application instantanément disponibles dans un état chargé et lié lorsque la JVM démarre. Voir JEP 483 et JEP 514 pour plus d’informations.

Exigences

Utiliser :

• Java 25 ou version ultérieure
• Datadog Java SDK 1.57.0 ou version ultérieure

Configuration

Pour configurer le chargement et la liaison de classes AOT pour APM, ajoutez le Datadog Java SDK lors de l’exécution de la formation :

java -javaagent:/path/to/dd-java-agent.jar -XX:AOTCacheOutput=app.aot -jar App.jar

Utilisation

Pendant la production, ajoutez le même Datadog Java SDK avec les données de formation mises en cache précédemment :

java -javaagent:/path/to/dd-java-agent.jar -XX:AOTCache=app.aot -jar App.jar

Vous pouvez visualiser les traces en utilisant le Trace Explorer.

Mismatched values for property jdk.module.addmods: java.instrument specified during runtime but not during dump time

Support de l’image native GraalVM

L’image native GraalVM est une technologie qui vous permet de compiler des applications Java en exécutables natifs. Le Datadog Java SDK prend en charge l’image native GraalVM. Cela vous permet de compiler vos applications en exécutables natifs tout en bénéficiant des capacités de traçage offertes par la bibliothèque.

Exigences

Utiliser :

• GraalVM JDK 21 ou JDK 25
• Datadog Java SDK

Configuration

Utilisation

Après avoir terminé la configuration, le service doit envoyer des traces à Datadog.

Vous pouvez visualiser les traces en utilisant le Trace Explorer.

Caused by: org.graalvm.compiler.java.BytecodeParser$BytecodeParserError:
com.oracle.graal.pointsto.constraints.UnsupportedFeatureException:
No instances of datadog.trace.bootstrap.DatadogClassLoader are allowed in the image heap
as this class should be initialized at image runtime. To see how this object got
instantiated use --trace-object-instantiation=datadog.trace.bootstrap.DatadogClassLoader.

disabling Datadog at launch time is unsupported for Node
ERROR: failed to launch: exec.d: failed to execute exec.d file at path '/layers
paketo-buildpacks_datadog/helper/exec.d/toggle': exit status 1

disabling Datadog at launch time is unsupported for Node
ERROR: failed to launch: exec.d: failed to execute exec.d file at path '/layers
paketo-buildpacks_datadog/helper/exec.d/toggle': exit status 1

<build>
  <plugins>
    <plugin>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-maven-plugin</artifactId>
      <configuration>
        <image>
          ...
          <env>
            ...
            <BP_NATIVE_IMAGE>true</BP_NATIVE_IMAGE>
            ...
          </env>
        </image>
      </configuration>
    </plugin>
  </plugins>
</build>

dd.trace 2024-12-30 08:34:43:306 +0000] [main] WARN datadog.trace.agent.tooling.nativeimage.TracerActivation - Problem activating datadog tracer
java.lang.NoClassDefFoundError: Could not initialize class jnr.unixsocket.UnixSocketChannel

Lectures complémentaires

Documentation, liens et articles supplémentaires utiles:

Instrumenter votre applicationDOCUMENTATION