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
- 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:
- En el panel de navegación, seleccione Servidores.
Seleccione Servidores de aplicaciones.
- 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.
- En la cabecera Infraestructura del servidor, seleccione Java y gestión de procesos. Seleccione Definición de proceso.
- En la cabecera Propiedades adicionales, seleccione Java Virtual Machine.
- 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.
- 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:
- En el panel de navegación, seleccione Resolución de problemas.
Pulse Rastreo y registros.
- Seleccione el nombre del servidor que se va a rastrear.
- En la Propiedades generales, seleccione
Rastreo de diagnóstico.
- 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.
- En la cabecera Propiedades adicionales, seleccione Cambiar los niveles de detalle de los registros cronológicos.
- 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. |
- 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: 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