La última versión del rastreador Java es compatible con todas las máquinas virtuales Java a partir de la versión 8. Para obtener más información sobre las versiones anteriores a la v8, consulta Tiempos de ejecución de máquinas virtuales Java compatibles.
Para ver la lista completa de versiones y marcos de trabajo Java compatibles con Datadog (incluidas las versiones heredadas y de mantenimiento) consulta los requisitos de compatibilidad.
Después de instalar y configurar tu Datadog Agent, el siguiente paso es añadir la biblioteca de rastreo directamente en la aplicación para instrumentarla. Consulta más bibliografía con información sobre la compatibilidad.
Para empezar a rastrear tus aplicaciones:
Descarga dd-java-agent.jar, que contiene los últimos archivos de clase de rastreo, en una carpeta a la que tengas acceso con tu usuario de Datadog:
Nota: Para descargar la última compilación de una versión mayor específica, utiliza el enlace https://dtdg.co/java-tracer-vX, donde X es la versión mayor deseada.
Por ejemplo, utiliza https://dtdg.co/java-tracer-v1 para la última versión 1 de compilación. No debe incluir los números de las versiones menores. Para obtener cualquier versión específica, también puedes consultar el repositorio Maven de Datadog.
Para ejecutar tu aplicación desde un script de aplicación IDE, Maven o Gradle, o desde un comando java -jar, con el Continuous Profiler, el rastreo de despliegues y la inyección de logs (si envías logs a Datadog), añade el argumento de máquina virtual Java -javaagent y las siguientes opciones de configuración, según corresponda:
Si tienes mucha necesidad de reducir el tamaño de tu imagen y omitir módulos, puedes utilizar el comando jdeps para identificar dependencias. Sin embargo, los módulos necesarios pueden cambiar con el tiempo, así que hazlo bajo tu propia responsabilidad.
Habilitar la creación de perfiles puede afectar a tu factura en función de tu paquete APM. Para obtener más información, consulta la página de tarifas.
Variable de entorno
Propiedad del sistema
Descripción
DD_ENV
dd.env
Tu entorno de aplicación (production, staging, etc.)
DD_LOGS_INJECTION
dd.logs.injection
Habilita la inyección automática de claves MDC para los ID de rastreo y de tramos (spans) de Datadog. Para ver más detalles, consulta Uso avanzado.
Beta: A partir de la versión 1.18.3, si la configuración remota del Agent está habilitada donde se ejecuta este servicio, puedes configurar DD_LOGS_INJECTION en la interfaz de usuario Catálogo de servicios.
Nombre de un conjunto de procesos que llevan a cabo la misma tarea. Se utiliza para agrupar estadísticas de tu aplicación.
DD_TRACE_SAMPLE_RATE
dd.trace.sample.rate
Configura una frecuencia de muestreo en la raíz de la traza para todos los servicios.
Beta: A partir de la versión 1.18.3, si la configuración remota del Agent está habilitada donde se ejecuta este servicio, puedes configurar DD_TRACE_SAMPLE_RATE en la interfaz de usuario Catálogo de servicios.
DD_TRACE_SAMPLING_RULES
dd.trace.sampling.rules
Configura una frecuencia de muestreo en la raíz de la traza para los servicios que coinciden con la regla especificada.
DD_VERSION
dd.version
La versión de tu aplicación (por ejemplo, 2.5, 202003181415 o 1.3-alpha)
Consulta la documentación de tu servidor de aplicaciones para saber cómo pasar -javaagent y otros argumentos de máquinas virtuales Java. Aquí encontrarás las instrucciones para algunos de los marcos de trabajo más frecuentes:
Si utilizas start.ini para iniciar Jetty, añade la siguiente línea (debajo de --exec o añade la línea --exec si no está allí):
-javaagent:/path/to/dd-java-agent.jar
En la consola administrativa:
Selecciona Servers (Servidores). En Server Type (Tipo de Servidor), selecciona WebSphere application servers (Servidores de la aplicación WebSphere) y elige tu servidor.
Selecciona Java and Process Management > Process Definition (Java y Gestión de procesos > Definición de procesos).
En la sección Additional Properties (Propiedades adicionales), haz clic en Java Virtual Machine (Máquina virtual Java).
En el campo Generic JVM arguments (Argumentos de máquinas virtuales Java genéricos), introduce:
Si quieres añadir el argumento -javaagent a tu comando java -jar, tienes que añadirlo antes del argumento -jar como opción de la máquina virtual Java y no como un argumento de aplicación. Por ejemplo:
La instrumentación automática para Java utiliza las capacidades de instrumentación java-agentque proporciona la máquina virtual Java. Cuando se registra un java-agent, puede modificar archivos de clase durante la carga.
Nota: Las clases que se cargan con un ClassLoader remoto no se instrumentan de forma automática.
La instrumentación puede venir de la instrumentación automática, de la API OpenTracing o de una combinación de ambas. La instrumentación suele registrar los siguientes datos:
La duración normalmente se registra con el reloj NanoTime de la máquina virtual Java, salvo si la API OpenTracing proporciona una marca de tiempo
Pares de etiquetas clave/valor
Errores y trazas de stacks tecnológicos que la aplicación no gestiona
Número total de trazas (solicitudes) que circulan por el sistema
Si es necesario, configura la biblioteca de rastreo para que envíe datos de telemetría sobre el rendimiento de la aplicación, según sea necesario, incluida la configuración del etiquetado unificado de servicios. Para ver más detalles, consulta la configuración de bibliotecas.
