Perfiles faltantes en la página de búsqueda de perfiles

Si has configurado el generador de perfiles y no ves perfiles en la página de búsqueda de perfiles, activa el modo de depuración y abre un ticket de asistencia. En el ticket de asistencia, incluye los archivos de depuración junto con la siguiente información:

  • Tipo y versión del sistema operativo (por ejemplo, Linux Ubuntu 20.04)
  • Tipo de tiempo de ejecución, versión y proveedor (por ejemplo, Java OpenJDK 11 AdoptOpenJDK)

Reducción de la sobrecarga de la configuración por defecto

Si la sobrecarga de configuración por defecto no es aceptable, puedes utilizar el generador de perfiles con parámetros de configuración mínimo. La configuración mínima tiene los siguientes cambios en comparación con la configuración por defecto:

  • Aumenta el umbral de muestreo a 500 ms para eventos ThreadSleep, ThreadPark y JavaMonitorWait en comparación con los 100 ms por defecto.
  • Deshabilita eventos ObjectAllocationInNewTLAB, ObjectAllocationOutsideTLAB, ExceptionSample, ExceptionCount

Para utilizar la configuración mínima, asegúrate de que dispones de dd-java-agent versión0.70.0 y, a continuación, cambia la invocación de servicios por lo siguiente:

java -javaagent:dd-java-agent.jar -Ddd.profiling.enabled=true -Ddd.profiling.jfr-template-override-file=minimal -jar <YOUR_SERVICE>.jar <YOUR_SERVICE_FLAGS>

Modificación de la profundidad máxima del stack tecnológico para trazas (traces) de stack tecnológico recopiladas

Si la profundidad máxima del stack tecnológico por defecto de 512 no es suficiente para tu caso de uso o está causando problemas de rendimiento, puedes aumentarla configurando la propiedad del sistema dd.profiling.stackdepth.

Por ejemplo, para reducir la profundidad máxima del stack tecnológico a 256, inicia tu servicio con la siguiente configuración de máquina virtual Java:

java -javaagent:dd-java-agent.jar -Ddd.profiling.enabled=true -Ddd.profiling.stackdepth=256 -jar <YOUR_SERVICE>.jar <YOUR_SERVICE_FLAGS>

Se utilizará el mismo límite para los datos recopilados por el archivo JFR y el generador de perfiles de Datadog.

Nota: Si se proporciona el argumento JVM -XX:FlightRecorderOptions=stackdepth=<stack-depth>, la profundidad máxima del stack tecnológico definida a través de la propiedad del sistema dd.profiling.stackdepth` será ignorada en los datos recopilados por el JFR, por razones técnicas.

Aumento de la especificidad de la información del generador de perfiles

Si quieres obtener una mayor especificidad en tus datos de generación de perfiles, puedes especificar la configuración comprehensive. Ten en cuenta que para ofrecerte una mayor especificidad, esta estrategia aumentará la sobrecarga de tu generador de perfiles. Una configuración completa muestra los siguientes cambios con respecto a la configuración por defecto:

  • Reduce el umbral de muestreo a 10 ms para eventos ThreadSleep, ThreadPark y JavaMonitorWait en comparación con los 100 ms por defecto
  • Habilita eventos ObjectAllocationInNewTLAB, ObjectAllocationOutsideTLAB, ExceptionSample, ExceptionCount

Para utilizar la configuración completa, asegúrate de que dispones de dd-java-agent versión0.70.0 y, a continuación, cambia la invocación de servicios por lo siguiente:

java -javaagent:dd-java-agent.jar -Ddd.profiling.enabled=true -Ddd.profiling.jfr-template-override-file=comprehensive -jar <YOUR_SERVICE>.jar <YOUR_SERVICE_FLAGS>

Habilitación del generador de perfiles de asignaciones

En Java 15 y versiones anteriores, el generador de perfiles de asignaciones está deshabilitado por defecto, ya que puede saturar el generador de perfiles en aplicaciones con muchas asignaciones.

Para habilitar el generador de perfiles de asignaciones, inicia tu aplicación con el parámetro de máquina virtual Java -Ddd.profiling.allocation.enabled=true o la variable de entorno DD_PROFILING_ALLOCATION_ENABLED=true.

También puedes habilitar los siguientes eventos en tu archivo de plantillas de anulación de jfp:

jdk.ObjectAllocationInNewTLAB#enabled=true
jdk.ObjectAllocationOutsideTLAB#enabled=true

Aprende a utilizar las plantillas de anulación..

Habilitación del generador de perfiles de heap

La función del generador de perfiles de heap Java está en fase beta.
Esta función requiere al menos Java 11.0.12, 15.0.4, 16.0.2, 17.0.3 o 18 y posteriores.
Para habilitar el generador de perfiles de heap, inicia tu aplicación con el parámetro de máquina virtual Java `-Ddd.profiling.heap.enabled=true` o la variable de entorno `DD_PROFILING_HEAP_ENABLED=true`.

También puedes habilitar los siguientes eventos en tu archivo de plantillas de anulación de jfp:

jdk.OldObjectSample#enabled=true

Aprende a utilizar las plantillas de anulación..

Eliminación de información confidencial de los perfiles

Si las propiedades del sistema contienen información confidencial, como nombres de usuario o contraseñas, desactiva el evento de propiedad del sistema creando un archivo de plantillas de anulación de jfp con jdk.InitialSystemProperty deshabilitado:

jdk.InitialSystemProperty#enabled=false

Aprende a utilizar las plantillas de anulación..

Eventos con grandes asignaciones que saturan el generador de perfiles

Para desactivar la generación de perfiles de asignaciones, deshabilita los siguientes eventos en tu archivo de plantillas de anulación de jfp:

jdk.ObjectAllocationInNewTLAB#enabled=false
jdk.ObjectAllocationOutsideTLAB#enabled=false

Aprende a utilizar las plantillas de anulación..

La detección de fugas de memoria ralentiza el recopilador de basura

Para desactivar la detección de fugas de memoria, deshabilita el siguiente evento en tu archivo de plantillas de anulación de jfp:

jdk.OldObjectSample#enabled=false

Aprende a utilizar las plantillas de anulación..

Excepciones que saturan el generador de perfiles

En condiciones normales, el generador de perfiles de excepciones de Datadog ocupa poco espacio y tiene poca sobrecarga. Si se crean y lanzan muchas excepciones, se puede causar una sobrecarga significativa para el generador de perfiles. Esto puede ocurrir cuando se utilizan excepciones para el flujo (flow) de control. Si tienes una tasa de excepciones inusualmente alta, desactive temporalmente la generación de perfiles de excepciones hasta que soluciones la causa.

Para deshabilitar la generación de perfiles de excepciones, inicia el rastreador con la configuración de máquina virtual Java -Ddd.integration.throwables.enabled=false.

Recuerda volver a activar este ajuste cuando hayas recuperado una tasa de excepciones más habitual.

Compatibilidad con Java 8

Los siguientes proveedores de OpenJDK 8 son compatibles con la generación de perfiles continua, ya que incluyen JDK Flight Recorder en sus últimas versiones:

ProveedorVersión del JDK que incluye Flight Recorder
Azulu212 (se recomienda u262)
AdoptOpenJDKu262
RedHatu262
Amazon (Corretto)u262
Bell-Soft (Liberica)u262
Versiones posteriores de todos los proveedoresu272

Si tu proveedor no está en lista, abre un ticket de asistencia, ya que puede haber otros proveedores en desarrollo o disponibles para la compatibilidad beta.

Creación y uso de un archivo de anulación de plantillas JFR

Las plantillas de anulación te permiten especificar las propiedades de la generación de perfiles que quieres anular. Sin embargo, los parámetros predeterminados están equilibrados para lograr un buen balance entre la sobrecarga y la densidad de datos, presentes en la mayoría de los casos de uso. Para utilizar un archivo de anulación, sigue estos pasos:

  1. Crea un archivo de anulación en un directorio accesible por dd-java-agent durante la invocación del servicio:

    touch dd-profiler-overrides.jfp
    
  2. Añade las anulaciones deseadas al archivo jfp. Por ejemplo, para deshabilitar la generación de perfiles de asignaciones y las propiedades del sistema de la máquina virtual Java, el archivo dd-profiler-overrides.jfp tendría el siguiente aspecto:

    jdk.ObjectAllocationInNewTLAB#enabled=false
    jdk.ObjectAllocationOutsideTLAB#enabled=false
    jdk.InitialSystemProperty#enabled=false
    
  3. Cuando ejecutes tu aplicación con dd-java-agent, la invocación a tu servicio debe apuntar al archivo de anulación con -Ddd.profiling.jfr-template-override-file=</path/to/override.jfp>, por ejemplo:

    java -javaagent:/path/to/dd-java-agent.jar -Ddd.profiling.enabled=true -Ddd.logs.injection=true -Ddd.profiling.jfr-template-override-file=</path/to/override.jfp> -jar path/to/your/app.jar
    

Referencias adicionales

Additional helpful documentation, links, and articles: