El generador de perfiles se incluye en las bibliotecas de rastreo de Datadog. Si ya estás utilizando APM para recopilar trazas (traces) para tu aplicación, puedes omitir la instalación de biblioteca e ir directamente a habilitar el generador de perfiles.

Requisitos

Para obtener un resumen de las versiones mínimas y recomendadas del tiempo de ejecución y del rastreador en todos los lenguajes, consulta Versiones de lenguaje y rastreadores compatibles.

A partir de dd-trace-java 1.0.0, tienes dos opciones para el motor que genera datos de perfil para las aplicaciones de Java: Java Flight Recorder (JFR) o el Datadog Profiler. A partir de dd-trace-java 1.7.0, Datadog Profiler es el predeterminado. Cada motor de perfil tiene diferentes efectos secundarios, requisitos, configuraciones disponibles y limitaciones, y esta página describe cada uno. Puedes activar uno o ambos motores. Activando ambos se capturan los dos tipos de perfil al mismo tiempo.

Todos los lenguajes basados en JVM, como Java, Scala, Groovy, Kotlin y Clojure son compatibles.

Continuous Profiler no es compatible con las plataformas serverless, como AWS Lambda.

Instalación

Para empezar a crear perfiles de aplicaciones:

1. Asegúrate de que Datadog Agent v6+ está instalado y en ejecución. Datadog recomienda utilizar Datadog Agent v7+. Si no tienes APM habilitado para configurar tu aplicación para enviar datos a Datadog, en tu Agent, configura la variable de entorno DD_APM_ENABLED en true y escuchando en el puerto 8126/TCP.

2. Descarga dd-java-agent.jar, que contiene los archivos de clase de Java Agent:

   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: El generador de perfiles está disponible en la biblioteca dd-java-agent.jar para las versiones 0.55+.

3. Habilita el generador de perfiles configurando el indicador -Ddd.profiling.enabled o la variable de entorno DD_PROFILING_ENABLED en true. Especifica dd.service, dd.env y dd.version para poder filtrar y agrupar tus perfiles a través de estas dimensiones:

   Invoca tu servicio:

   java \
       -javaagent:dd-java-agent.jar \
       -Ddd.service=<YOUR_SERVICE> \
       -Ddd.env=<YOUR_ENVIRONMENT> \
       -Ddd.version=<YOUR_VERSION> \
       -Ddd.profiling.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_PROFILING_ENABLED=true
   java \
       -javaagent:dd-java-agent.jar \
       -jar <YOUR_SERVICE>.jar <YOUR_SERVICE_FLAGS>
   

DD_PROFILING_ENABLED=true DD_PROFILING_DIRECTALLOCATION_ENABLED=true ./my_service

Nota: El argumento -javaagent debe estar antes de -jar. Esto lo añade como una opción de JVM en lugar de como un argumento de aplicación. Por ejemplo, java -javaagent:dd-Java-Agent.jar ... -jar my-servicio.jar -more-flags. Para más información, consulta la documentación de Oracle.

4. Opcional: configura la integración de código fuente para conectar tus datos de perfiles con tus repositorios Git.

5. Después de uno o dos minutos, visualizarás tus perfiles en la página Datadog APM > Perfiles.

Activación de las opciones de motor del generador de perfiles de CPU

Desde la versión 1.5.0 de dd-trace-java, tienes dos opciones para el generador de perfiles de CPU utilizado, Datadog o Java Flight Recorder (JFR). Desde la versión 1.7.0, Datadog es el predeterminado, pero también puedes habilitar opcionalmente JFR para los perfiles de CPU. Puedes activar uno o ambos motores. Activando ambos se capturan los dos tipos de perfiles al mismo tiempo.

El Datadog Profiler registra el tramo activo en cada muestra, lo que mejora la fidelidad de las funciones de perfil de Hotspots de código y Endpoint. La activación de este motor permite mejorar mucho la integración con el rastreo de APM.

El Datadog Profiler consta de varios motores de perfiles, incluidos los generadores de perfiles de CPU, tiempo real, asignación y fugas de memoria.

export DD_PROFILING_DDPROF_ENABLED=true # predeterminado en v1.7.0+
export DD_PROFILING_DDPROF_CPU_ENABLED=true

-Ddd.profiling.ddprof.enabled=true # predeterminado en v1.7.0+
-Ddd.profiling.ddprof.cpu.enabled=true

sudo sh -c 'echo 2 >/proc/sys/kernel/perf_event_paranoid'

export DD_PROFILING_DDPROF_CPU_ENABLED=false

-Ddd.profiling.ddprof.cpu.enabled=false

Motor de tiempo real del Datadog Profiler

El motor de perfil de tiempo real es útil para perfilar la latencia y se integra estrechamente con el rastreo de APM. El motor muestrea todos los subprocesos, dentro o fuera de la CPU, con actividad de rastreo activa y puede utilizarse para diagnosticar la latencia de traza o tramo. El motor está activado por defecto desde la versión 1.7.0.

-Ddd.profiling.ddprof.enabled=true # predeterminado en v1.7.0+
-Ddd.profiling.ddprof.wall.enabled=true

Para la versión 1.7.0+, para desactivar el perfil de tiempo real:

export DD_PROFILING_DDPROF_WALL_ENABLED=false

o:

-Ddd.profiling.ddprof.wall.enabled=false

Para los usuarios de JMC, el evento datadog.MethodSample se emite para las muestras de tiempo real.

El motor de tiempo real no depende de la configuración de /proc/sys/kernel/perf_event_paranoid.

Motor de asignación de perfiles

export DD_PROFILING_ENABLED_EVENTS=jdk.ObjectAllocationInNewTLAB,jdk.ObjectAllocationOutsideTLAB

-Ddd.profiling.enabled.events=jdk.ObjectAllocationInNewTLAB,jdk.ObjectAllocationOutsideTLAB

export DD_PROFILING_DDPROF_ENABLED=true # predeterminado en v1.7.0+
export DD_PROFILING_DDPROF_ALLOC_ENABLED=true # predeterminado en v1.28.0+ en OpenJDK 21.0.3+

-Ddd.profiling.ddprof.enabled=true # predeterminado en v1.7.0+
-Ddd.profiling.ddprof.alloc.enabled=true # predeterminado en v1.17.0+

Motor de perfiles de heap en directo (alfa)

Desde: v1.17.0. Requiere JDK 11+.

El motor de perfiles de heap en directo es útil para investigar el uso general de memoria de tu servicio e identificar posibles fugas de memoria. El motor muestrea las asignaciones y mantiene un registro de si esas muestras sobrevivieron al ciclo de recopilación de elementos no usados más reciente. El número de muestras que sobreviven se utiliza para estimar el número de objetos activos en el stack. El número de muestras rastreadas está limitado para evitar un crecimiento ilimitado del uso de memoria del generador de perfiles.

El motor está desactivado por defecto, pero puedes activarlo con:

export DD_PROFILING_DDPROF_LIVEHEAP_ENABLED=true

o:

-Ddd.profiling.ddprof.liveheap.enabled=true

Para los usuarios de JMC, el evento de heap en directo de Datadog es datadog.HeapLiveObject.

El motor de asignación no depende de la configuración de /proc/sys/kernel/perf_event_paranoid.

Recopilación de stack traces nativas

Si los motores de CPU o tiempo real de Datadog Profiler están activados, puedes recopilar stack traces nativas. Estas incluyen cosas como las internas de la JVM, las bibliotecas nativas utilizadas por tu aplicación o la JVM, y syscalls.

Para habilitar la recopilación de stack traces nativas, entendiendo que puede desestabilizar tu aplicación, establece:

export DD_PROFILING_DDPROF_ENABLED=true # predeterminado en v1.7.0+
export DD_PROFILING_DDPROF_CSTACK=dwarf

o:

-Ddd.profiling.ddprof.enabled=true # predeterminado en v1.7.0+
-Ddd.profiling.ddprof.cstack=dwarf

Configuración

Puedes configurar el generador de perfiles utilizando las siguientes variables de entorno:

¿No sabes qué hacer a continuación?

La guía Empezando con el generador de perfiles toma un ejemplo de servicio con un problema de rendimiento y te muestra cómo utilizar Continuous Profiler para comprender y solucionar el problema.

Referencias adicionales

Additional helpful documentation, links, and articles:

Empezando con el generador de perfilesDOCUMENTACIÓN Más información sobre las visualizaciones de perfiles disponiblesDOCUMENTACIÓN Solucionar los problemas que surjan al utilizar el generador de perfilesDOCUMENTACIÓN