Habilitación del rastreo ampliado para JPA

En algunas situaciones, es posible que la información de rastreo generada por los proveedores JPA (Java™ Persistence API) proporcionados con WebSphere Application Server no sea la adecuada para diagnosticar un problema. En estas situaciones, se puede habilitar un mecanismo de rastreo ampliado para generar información adicional del archivo de rastreo. El rastreo ampliado puede funcionar solamente con los proveedores de persistencia enviados por IBM. No funciona con los proveedores de otras empresas, incluidas versiones alternativas de OpenJPA empaquetadas dentro de una aplicación o configuradas como una biblioteca compartida.

Acerca de esta tarea

Nota: En este tema se hace referencia a uno o más de los archivos de registro del servidor de aplicaciones. Como alternativa recomendada, puede configurar el servidor para utilizar la infraestructura de registro y rastreo HPEL en lugar de utilizar los archivos SystemOut.log , SystemErr.log, trace.log y activity.log en sistemas distribuidos y de IBM® i. Puede también utilizar HPEL junto con sus recursos de registro nativos de z/OS. Si utiliza HPEL, puede acceder a toda la información de registro y rastreo utilizando la herramienta de línea de mandatos LogViewer desde el directorio bin de perfil de servidor. Consulte la información sobre la utilización de HPEL para resolver problemas de aplicaciones para obtener más información sobre la utilización de HPEL.

El rastreo ampliado JPA para una aplicación que se ejecuta en WebSphere Application Server se puede habilitar realizando unos pasos sencillos con scripts wsadmin o con la consola administrativa. Los pasos de este tema describen cómo configurar el rastreo ampliado utilizando la consola administrativa. Este proceso cambia los valores del servidor, por lo que se recomienda realizar una copia de seguridad de la configuración del servidor antes de continuar.

Procedimiento

  1. Habilite el agente de rastreo. Se debe habilitar un agente de rastreo por servidor de aplicaciones pasando un argumento a la JVM (Java Virtual Machine) del servidor. El agente de rastreo se puede habilitar utilizando la consola administrativa siguiendo estos pasos:
    1. En el panel de navegación, seleccione Servidores. Seleccione Servidores de aplicaciones.
    2. En el panel de la lista de servidores, seleccione el servidor que necesite el rastreo JPA mejorado. Si varios servidores proporcionan funciones JPA a la aplicación, cada servidor debe seguir estos pasos.
    3. En la cabecera Infraestructura del servidor, seleccione Java y gestión de procesos. Seleccione Definición de proceso.
    4. En la cabecera Propiedades adicionales, seleccione Java Virtual Machine.
    5. Añada el argumento siguiente al campo de argumentos JVM genéricos, donde <raíz_servidor_aplicaciones> es la vía de acceso totalmente calificada del directorio de instalación de servidor de aplicaciones. Asegúrese de que utiliza el carácter separador de vía de acceso adecuado para el sistema operativo.
      -javaagent:<raíz_servidor_aplicaciones>/optionalLibraries/IBM/wsjpa/wsjpatrace.jar
      Importante: El uso de argumentos JVM genéricos en la consola administrativa no soporta actualmente espacios en los argumentos. Si se especifican espacios en este campo, el servidor puede no iniciarse. Es más posible que esto ocurra en un entorno Windows porque la vía de acceso de instalación predeterminada es C:\Archivos de programa\IBM\WebSphere\AppServer, que contiene un espacio en la vía de acceso. Para solucionar este problema en un entorno Windows, utilice un nombre de vía de acceso abreviado para <raíz_servidor_aplicaciones>. Por ejemplo, C:\Progra~1\IBM\WebSphere|AppServer. En los sistemas de tipo UNIX se puede utilizar un enlace simbólico para eliminar los espacios en <raíz_servidor_aplicaciones>. Por ejemplo, si la vía de acceso de instalación de WebSphere Application Server es /opt/raíz_servidor_aplic/AppServer, se puede crear un enlace simbólico en /opt desde <raíz_servidor_aplic> a AppServerRoot, eliminando el espacio. A continuación, especifique /opt/AppServerRoot/AppServer como la <raíz_servidor_aplicaciones> en el argumento JVM genérico.
  2. Habilite los componentes de rastreo adicionales y ajuste las opciones del archivo de rastreo. Puede realizar esta operación con el script wsadmin o con la consola administrativa. Estos pasos describen cómo se ajustan los valores del archivo de rastreo y se habilitan los componentes con la consola administrativa:
    1. En el panel de navegación, seleccione Resolución de problemas. Pulse Rastreo y registros.
    2. Seleccione el nombre del servidor que se va a rastrear.
    3. En la Propiedades generales, seleccione Rastreo de diagnóstico.
    4. Asegúrese de que esté seleccionada la opción Habilitar rastreo y, si lo desea, aumente el valor de Tamaño máximo de archivo y Número máximo de archivos históricos. Dependiendo del número de categorías de rastreo adicionales y de los niveles de rastreo elegidos, el archivo de rastreo puede hacerse grande.
    5. En la cabecera Propiedades adicionales, seleccione Cambiar los niveles de detalle de los registros cronológicos.
    6. Habilite varias categorías de rastreo ampliadas especificando una o más categorías de rastreo desde la tabla siguiente. Una serie de rastreo de ejemplo es: *=info:JPA=all:openjpa.*=finer:openjpa.kernel=finest. Los rastreos ampliados realizan el rastreo en los niveles FINER o FINEST. El nivel FINEST incluye más detalles que el nivel FINER. Cuando se especifica ALL, el rastreo ampliado realiza el rastreo al nivel FINEST.
      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.
      openjpa.xtrace.ApiSpi OFF, ALL, FINER, FINEST Rastreo ampliado para interfaces API/SPI públicas definidas para WsJPA, OpenJPA y JPA cuando el rastreo ampliado está habilitado.
  3. Guarde la configuración del servidor de aplicaciones y reinicie el servidor de aplicaciones.

Resultados

Después de reiniciar el servidor de aplicaciones, se utilizan los valores de rastreo nuevos.

Qué hacer a continuación

Avoid trouble Avoid trouble: El rastreo pueden disminuir de forma importante el rendimiento y debe inhabilitarse cuando no se utiliza. Para inhabilitar el rastreo, suprima el argumento de JVM genérico y cualquier nivel de detalle del rastreo que se haya añadido para el rastreo ampliado.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_jpatracejee
File name: tejb_jpatracejee.html