Habilitación del rastreo ampliado para JPA en un entorno Java SE

En algunos casos, es posible que sea necesario ejecutar un rastreo JPA (Java™ Persistence API) desde un entorno Java SE.

Acerca de esta tarea

El rastreo ampliado se puede utilizar también para recopilar información del rastreo JPA en un entorno Java SE. En el entorno de WebSphere Application Server, el servidor de aplicaciones se ocupa del acoplamiento del rastreo OpenJPA estándar con una función de rastreo ampliada para mejorar la salida de un rastreo individual. Este proceso se debe llevar a cabo manualmente en un entorno de Java SE. Los siguientes son los pasos que se han de realizar para utilizar el rastreo ampliado en un entorno Java SE:

Procedimiento

  1. Cree un archivo de propiedades de configuración de registro cronológico. El archivo de propiedades de configuración debe utilizar el formato de archivo de configuración java.util.logging estándar. El código siguiente es un archivo de configuración de ejemplo. Las categorías de rastreo definidas en la tabla también se pueden utilizar en el archivo de configuración. De forma estándar para los archivos de configuración java.util.logging, las categorías de rastreo deben tener el sufijo .level.
    # Archivo logger.properties de ejemplo
    
    # Habilitar un manejador de archivos
    handlers = java.util.logging.FileHandler
    
    # Establecer un patrón de archivo de rastreo: este ejemplo escribirá un archivo
    # jpa_jse.log en el directorio actual
    java.util.logging.FileHandler.pattern = jpa_jse.log
    
    # Configurar el nivel de registro cronológico básico para el manejador de archivos
    java.util.logging.FileHandler.level = ALL
    
    # Establecer la categoría de rastreo openjp.jdbc.SQL en ALL
    openjpa.jdbc.SQL.level = ALL
    
    # Establecer la categoría general de rastreo ampliada en FINEST
    openjpa.xtrace.General.level = FINEST 
    
    # Establecer la categoría de kernel ampliada del rastreo en FINER
    openjpa.xtrace.Kernel.level = FINER 
    Tabla 1. Categorías de rastreo. Realice una copia de seguridad de la configuración del servidor antes de habilitar el rastreo ampliado.
    Categoría Niveles de rastreo relevantes Descripción
    JPA OFF, ALL, FINER, FINEST Añade el rastreo ampliado al grupo de rastreos JPA.
    openjpa.* OFF, ALL, FINER, FINEST Rastreo OpenJPA normal, además del rastreo ampliado para todas las categorías en OpenJPA cuando se habilita el rastreo ampliado.
    openjpa.xtrace.* OFF, ALL, FINER, FINEST El rastreo ampliado para todas las categorías en OpenJPA cuando se habilita el rastreo ampliado.
    openjpa.xtrace.Jdbc OFF, ALL, FINER, FINEST El rastreo ampliado para las clases JDBC de OpenJPA cuando se ha habilitado el rastreo ampliado.
    openjpa.xtrace.Lib OFF, ALL, FINER, FINEST El rastreo ampliado para las clases de bibliotecas OpenJPA cuando se ha habilitado el rastreo ampliado.
    openjpa.xtrace.Persist OFF, ALL, FINER, FINEST El rastreo ampliado para las clases de persistencia de OpenJPA cuando se ha habilitado el rastreo ampliado.
    openjpa.xtrace.Kernel OFF, ALL, FINER, FINEST El rastreo ampliado para las clases de kernel de OpenJPA cuando se ha habilitado el rastreo ampliado.
    openjpa.xtrace.General OFF, ALL, FINER, FINEST El rastreo ampliado para las clases OpenJPA no se incluye en las categorías JDBC, Lib, Persist o Kernel cuando se ha habilitado el rastreo ampliado.
  2. Modifique el archivo persistence.xml para utilizar el registro cronológico commons de Apache en lugar del registrador predeterminado de OpenJPA. Añada esta propiedad a la unidad de persistencia:
    <property name="openjpa.Log" value="commons"/>
  3. Añada el archivo JAR (Java Archive) del registro commons de Apache a la vía de acceso de clases. Puede descargar el archivo JAR del sitio web de Apache.
  4. Añada el argumento siguiente a la JVM (Java virtual machine), donde <vía_acceso_instalación_WAS> es la vía de acceso completa del directorio de instalación del servidor de aplicaciones. Asegúrese de que utiliza el carácter separador de vía de acceso adecuado para el sistema operativo. Este parámetro se debe especificar antes del nombre de la clase o archivo JAR que se debe utilizar.
    -javaagent:<vía_acceso_instalación_WAS>/optionalLibraries/IBM/wsjpa/wsjpatrace.jar
  5. Añada este argumento adicional a la JVM que especifica la vía de acceso al archivo de configuración del registro cronológico. Esta opción también se debe especificar antes del nombre de la clase o JAR que se debe ejecutar.
    -Djava.util.Logging.config.file=Logger.properties
  6. Ejecute la aplicación Java SE. La siguiente es una invocación de la aplicación Java SE de ejemplo con el rastreo ampliado habilitado:
    java 
    -javaagent:"<vía_acceso_instalación_WAS>/optionalLibraries/IBM/wsjpa/wsjpatrace.jar"
    -Djava.util.logging.config.file=Logger.properties 
     my.JPAApplication

Resultados

Ahora el rastreo ampliado funciona en el entorno Java SE.

Qué hacer a continuación

Avoid trouble Avoid trouble: No utilice el agente de rastreo ampliado junto con el agente PCEnhancer de OpenJPA en un entorno Java SE. Si se utiliza el rastreo ampliado, se debe utilizar PCEnhancer de OpenJPA durante la compilación. Si se utilizan conjuntamente el agente PCEnhancer y el agente de rastreo ampliado, los resultados son imprevisibles. gotcha

Icon that indicates the type of topic Task topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tejb_jpatracejse
File name: tejb_jpatracejse.html