Compatibilidad

La biblioteca Datadog Trace para Java es de código abierto; consulte el repositorio de GitHub para más información.

Entornos de ejecución de Java compatibles

El trazador de Java admite la instrumentación automática para los siguientes entornos de ejecución de Oracle JDK, OpenJDK JVM y GraalVM.

Trazador de Java v1 (última versión)

Datadog no soporta oficialmente ninguna versión de acceso anticipado de Java.

Trazador de Java v0

Niveles de soporte

Integrations

Las Integrations en la vista previa están deshabilitadas por defecto, pero se pueden habilitar individualmente:

• Propiedad del sistema: -Ddd.integration.<INTEGRATION_NAME>.enabled=true
• Variable de entorno: DD_INTEGRATION_<INTEGRATION_NAME>_ENABLED=true

Compatibilidad con marcos web

dd-java-agent incluye soporte para rastrear automáticamente los siguientes marcos web.

El rastreo de marcos web proporciona:

• Medición del tiempo de la solicitud HTTP a la respuesta
• etiquetas para la solicitud HTTP (código de estado, método, etc.)
• captura de errores y stacktrace
• vinculación del trabajo creado dentro de una solicitud web y Distributed Tracing

Nota: Muchos servidores de aplicaciones son compatibles con Servlet y están cubiertos automáticamente por esa instrumentación, como Websphere, Weblogic y JBoss. Además, frameworks como Spring Boot (versión 3) funcionan inherentemente porque generalmente utilizan un servidor de aplicaciones embebido soportado, como Tomcat, Jetty o Netty.

Framework Integrations Desactivadas por Defecto

Las siguientes instrumentaciones están desactivadas por defecto y se pueden habilitar con las siguientes configuraciones:

Nota: La integración JAX-WS instrumenta puntos de conexión anotados con @WebService (JAX-WS 1.x) y @WebServiceProvider (JAX-WS 2.x).

¿No ve los frameworks web que desea? Datadog está continuamente agregando soporte adicional. Contacte a Datadog support si necesita ayuda.

Compatibilidad del networking framework

dd-java-agent incluye soporte para rastrear automáticamente los siguientes marcos de trabajo de red.

El rastreo de red proporciona:

• tiempo entre solicitud y respuesta
• etiquetas para la solicitud (por ejemplo, código de respuesta)
• captura de errores y trazas de pila
• rastreo distribuido

Kafka Note: La integración de Kafka de Datadog funciona con la versión de Kafka 0.11+, que soporta la Header API. Esta API se utiliza para inyectar y extraer el contexto de traza. Si está ejecutando un entorno de versiones mixtas, el broker de Kafka puede informar incorrectamente la versión más nueva de Kafka. Esto causa un problema cuando el SDK intenta inyectar encabezados que no son soportados por el productor local. Además, los consumidores más antiguos no pueden consumir el mensaje debido a la presencia de encabezados. Para prevenir estos problemas, si está ejecutando un entorno de Kafka de versiones mixtas con versiones anteriores a 0.11, desactive la propagación de contexto con la variable de entorno: DD_KAFKA_CLIENT_PROPAGATION_ENABLED=false.

Nota de JMS: La integración de JMS de Datadog agrega y lee automáticamente las propiedades del objeto de mensaje x__dash__datadog__dash__trace__dash__id y x__dash__datadog__dash__parent__dash__id para mantener la propagación del contexto entre los servicios de consumidor y productor.

Camel Note: La propagación del rastreo distribuido a través de rutas de Camel no es compatible.

Nota de SOFA RPC: La integración de SOFA RPC de Datadog admite los protocolos de transporte Bolt, Triple y REST. Triple utiliza transporte gRPC; el rastreo distribuido para las llamadas de Triple requiere que la grpc integración permanezca habilitada.

¿No ve el marco de red que desea? Datadog está continuamente agregando soporte adicional. Contacte a soporte de Datadog si necesita ayuda.

Compatibilidad con Datastore

dd-java-agent incluye soporte para rastrear automáticamente los siguientes marcos/drivers de bases de datos.

El rastreo de Datastore proporciona:

• tiempo entre solicitud y respuesta
• información de consulta (por ejemplo, una cadena de consulta sanitizada)
• captura de errores y trazas de pila

Nota: Redis 6.0+ soporta autenticación en línea en comandos como HELLO, MIGRATE, y ACL SETUSER.

• Datadog Trace Agent: La versión mínima requerida y recomendada es 7.76.1 para asegurar que los parámetros de autenticación se ofusquen automáticamente en los metadatos de trazas.
• Datadog Lambda Extension (Serverless environments): La versión mínima requerida es v28.0.0.

dd-java-agent también es compatible con drivers JDBC comunes, incluyendo:

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

Integraciones de base de datos deshabilitadas por defecto

Las siguientes instrumentaciones están desactivadas por defecto y se pueden habilitar con la siguiente configuración:

¿No ve sus almacenes de datos deseados? Datadog está continuamente agregando soporte adicional. Contacte a soporte de Datadog si necesita ayuda.

Compatibilidad adicional con frameworks

dd-java-agent incluye soporte para rastrear automáticamente los siguientes frameworks.

¿No encuentra los frameworks deseados? Datadog está continuamente agregando soporte adicional. Para solicitar un framework, contacte a nuestro excelente equipo de soporte.

Para mejorar la visibilidad en aplicaciones que utilizan frameworks no soportados, considere:

• Agregar instrumentación personalizada.
• Enviar un pull request con instrumentación para su inclusión en una futura versión.
• Contacte a soporte de Datadog y envíe una solicitud de funcionalidad.

Deshabilitando integraciones

La mayoría de las integraciones están habilitadas por defecto. La siguiente configuración puede cambiar el valor predeterminado a deshabilitado.

• Propiedad del sistema: -Ddd.integrations.enabled=false
• Variable de entorno: DD_INTEGRATIONS_ENABLED=false

Las integraciones pueden ser habilitadas o deshabilitadas individualmente (sobrescribiendo el valor predeterminado anterior).

• Propiedad del sistema: -Ddd.integration.<INTEGRATION_NAME>.enabled=true
• Variable de entorno: DD_INTEGRATION_<INTEGRATION_NAME>_ENABLED=true

(Consulte arriba el nombre de cada una de las integraciones.)

Problemas conocidos

• No se admite la ejecución del rastreador de Java en Bitbucket.
• Cargar múltiples Agentes de Java que realicen funciones de APM/rastreo no es una configuración recomendada ni admitida.
• Al ejecutar el SDK con Java 24+, puede ver advertencias relacionadas con el acceso nativo de JNI. Suprima estas advertencias agregando el --enable-native-access=ALL-UNNAMED indicador. Consulte JEP 472 para más información.

Soporte de carga y enlace de clases anticipadas (AOT)

Para mejorar el tiempo de inicio, la carga y enlace de clases anticipadas (AOT) hace que las clases de la aplicación estén instantáneamente disponibles en un estado cargado y enlazado cuando se inicia la JVM. Consulte JEP 483 y JEP 514 para más información.

Requisitos

Usar:

• Java 25 o posterior
• Datadog Java SDK 1.57.0 o posterior

Configuración

Para configurar la carga y vinculación de clases AOT para APM, agregue el Datadog Java SDK durante la ejecución de entrenamiento:

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

Uso

Durante la producción, agregue el mismo Datadog Java SDK junto con los datos de entrenamiento previamente almacenados en caché:

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

Puede ver trazas utilizando el Trace Explorer.

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

Soporte para GraalVM Native Image

GraalVM Native Image es una tecnología que permite compilar aplicaciones Java en ejecutables nativos. El Datadog Java SDK es compatible con GraalVM Native Image. Esto le permite compilar sus aplicaciones en ejecutables nativos mientras sigue beneficiándose de las capacidades de trazado que ofrece la biblioteca.

Requisitos

Usar:

• GraalVM JDK 21 o JDK 25
• Datadog Java SDK

Configuración

Uso

Después de completar la configuración, el servicio debería enviar trazas a Datadog.

Puede visualizar trazas utilizando el 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

Más información

Más enlaces, artículos y documentación útiles:

Instrumente su aplicaciónDOCUMENTACIÓN