Activar Dynamic Instrumentation para Java

Documentos > APM > Instrumentación dinámica > Activar Dynamic Instrumentation > Activar Dynamic Instrumentation para Java

Dynamic Instrumentation es una característica de apoyo para las bibliotecas de rastreo de Datadog. Si ya estás utilizando APM para recopilar trazas (traces) para tu aplicación, asegúrate de que tu Agent y biblioteca de rastreo están en la versión requerida. A continuación, ve directamente a la activación de Dynamic Instrumentation en el paso 4.

Requisitos

La biblioteca de Datadog Dynamic Instrumentation es compatible en JDK versión 8 y posteriores.
Para una mejor experiencia, Datadog recomienda activar autocompletar y búsqueda (en Vista previa).

Instalación

Instala o actualiza tu Agent a la versión 7.45.0 o posterior.
Si aún no tienes APM habilitado, en tu configuración del Agent, establece la variable de entorno DD_APM_ENABLED en true y escuchando en el puerto 8126/TCP.

Descarga dd-java-agent.jar:

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

Nota: Dynamic Instrumentation está disponible en la biblioteca dd-java-agent.jar en las versiones 1.34.0 y posteriores.

Ejecuta tu servicio con Dynamic Instrumentation habilitado configurando el indicador -Ddd.dynamic.instrumentation.enabled o la variable de entorno DD_DYNAMIC_INSTRUMENTATION_ENABLED en true. Especifica las etiquetas de servicio unificado dd.service, dd.env y dd.version para que puedas filtrar y agrupar tus instrumentaciones y apuntar a clientes activos a través de estas dimensiones.

Ejemplo del comando de inicio del servicio:

java \
    -javaagent:dd-java-agent.jar \
    -Ddd.service=<YOUR_SERVICE> \
    -Ddd.env=<YOUR_ENVIRONMENT> \
    -Ddd.version=<YOUR_VERSION> \
    -Ddd.dynamic.instrumentation.enabled=true \
    -jar <YOUR_SERVICE>.jar <YOUR_SERVICE_FLAGS>

export DD_SERVICE=<YOUR_SERVICE>
export DD_ENV=<YOUR_ENV>
export DD_VERSION=<YOUR_VERSION>
export DD_DYNAMIC_INSTRUMENTATION_ENABLED=true
java \
    -javaagent:dd-java-agent.jar \
    -jar <YOUR_SERVICE>.jar <YOUR_SERVICE_FLAGS>

Nota: El argumento -javaagent debe estar antes de -jar, añadiéndolo como una opción de JVM en lugar de un argumento de aplicación. Para más información, consulta la documentación de Oracle:

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

Después de iniciar tu servicio con la Dynamic Instrumentation activada, puedes empezar a utilizar Dynamic Instrumentation en la página APM > Dynamic Instrumentation.

Configuración

Configurar Dynamic Instrumentation utilizando las siguientes variables de entorno:

Variable de entorno	Tipo	Descripción
`DD_DYNAMIC_INSTRUMENTATION_ENABLED`	Booleano	Alternativa para el argumento `-Ddd.dynamic.instrumentation.enabled`. Establecido en `true` para activar Dynamic Instrumentation.
`DD_SERVICE`	Cadena	El nombre de servicio, por ejemplo, `web-backend`.
`DD_ENV`	Cadena	El nombre de entorno, por ejemplo, `production`.
`DD_VERSION`	Cadena	La versión de tu servicio.
`DD_TAGS`	Cadena	Etiquetas para aplicar a los datos producidos. Debe ser una lista de `<key>:<value>` separada por comas como: `layer:api,team:intake`.