Valores de nivel de registro

Utilice este tema para configurar y gestionar los valores de nivel de registro.

Para ver esta página de la consola de administración, pulse Resolución de problemas > Registros y rastreo > nombre_servidor > Cambiar niveles de detalle de registro

Utilizando los niveles de registro, puede controlar qué sucesos procesa el registro cronológico Java. Cuando se cambia el nivel de un registrador, el cambio se propaga a los hijos del registrador.

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 que utilice la función de registro HPEL (High Performance Extensible Logging) y la infraestructura de rastreo, en lugar de utilizar los archivos SystemOut.log, SystemErr.log, trace.log y activity.log en sistemas distribuidos y sistemas 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 de rastreo utilizando la herramienta de línea de mandatos LogViewer desde el directorio bin del perfil de servidor. Consulte la información sobre la utilización de HPEL para solucionar problemas de aplicaciones, para obtener más información sobre la utilización de HPEL.

Inhabilitar el registro y rastreo de datos potencialmente sensibles

El servidor de aplicaciones tiene una lista de registradores que se sabe que pueden escribir información confidencial en el registro y rastreo cuando están habilitados. Por ejemplo, si se habilitan ciertos registradores HTTP relacionados a nivel FINEST puede hacer que se almacene información confidencial especificada por el usuario de solicitudes HTTP en los archivos de rastreo. Si desea que el servidor impida que se habiliten estos registradores a los niveles que se sabe que se utilizan para la información potencialmente sensible, marque el recuadro de selección Inhabilitar el registro y rastreo de datos potencialmente sensibles. Cuando se inicia el servidor, o cuando se modifica la especificación de nivel de detalle del registro durante la ejecución, el servidor compara la lista de registradores y los niveles especificados en la especificación de nivel de detalle del registro con la lista de registradores y los niveles de la lista de registradores sensibles, y actualiza la especificación de nivel de detalle del registro según sea necesario.

Cambiar los niveles de detalle del registro

Especifique un nivel de detalle del registro que especifique los componentes, paquetes o grupos que se han de rastrear. La serie de nivel de detalle del registro debe ajustarse a la sintaxis específica que se describe a continuación. La serie de nivel de detalle de los registros cronológicos se puede especificar directamente o se puede generar utilizando la interfaz gráfica de rastreo.

Si selecciona la pestaña Configuración y expande Componentes y grupos, se visualizará una lista de los grupos, paquetes y componentes más conocidos. Es posible que esta lista no sea completa.

Si selecciona la pestaña Tiempo de ejecución y expande Componentes y grupos, se visualiza la lista de componentes, paquetes y grupos con todos los componentes que hay registrados en el servidor de aplicaciones en ejecución y en la lista estática.

El formato de la especificación de nivel de detalle del registro es:

<componente> = <nivel>

donde <componente> es el componente para el cual se establece un nivel de detalles de registro y <nivel> es uno de los niveles válidos del registrador (off, fatal, severe, warning, audit, info, config, detail, fine, finer, finest, all). Separe las distintas especificaciones de nivel de detalle del registro con dos puntos (:).

Evite problemas: [Updated in June 2013]

Las cláusulas incluidas en una especificación de rastreo se leen en el orden en que aparecen en la serie. Por lo tanto, si varias variaciones de la cláusula *=info se incluyen en una especificación de rastreo, el último valor especificado es el valor que determina el nivel de rastreo que el sistema registra. Si especifica *=info como última cláusula, el rastreo se realiza a nivel de información, sin importar las demás cláusulas de la especificación de rastreo. Por ejemplo, la especificación de rastreo:

*=info:PMGR=all:*=info:com.ibm.ws.sm.*=all

es equivalente a especificar simplemente:

*=all

Porque la última cláusula prevalece sobre todas las cláusulas que se han especificado antes en la serie. [Updated in June 2013]

gotcha

Los componentes se corresponden con clases y paquetes de Java o para las recopilaciones de paquetes Java. Utilice * como comodín para indicar componentes que incluyan todas las clases en todos los paquetes contenidos en el componente especificado. Por ejemplo:

*: Especifica todo el código rastreable que está ejecutándose en el servidor de aplicaciones, incluido el código de cliente y el código del sistema del producto.
com.ibm.ws.*: Especifica todas las clases cuyo nombre de paquete empieza por com.ibm.ws.
com.ibm.ws.classloader.JarClassLoader: Especifica sólo la clase JarClassLoader.

Se puede producir un error al establecer una especificación de nivel de rastreo de detalle de registro desde la consola de administración si se realizan selecciones en las listas de Grupos y Componentes. En algunos casos, la selección realizada en una lista se pierde cuando se añade una selección de la otra lista. Para solucionar este problema, entre directamente la especificación de nivel de detalle del registro que desee en el campo de entrada de nivel de detalle del registro.

Seleccione un componente o grupo para establece un nivel de detalle del registro. La tabla siguiente lista los niveles válidos para los servidores de aplicaciones en WebSphere Application Server versión 6 y posterior.

Evite problemas: Los valores de nivel de los registros cronológicos son sensibles a las mayúsculas y minúsculas y empiezan por una letra en minúsculas.gotcha

Tabla 1. Niveles de registro válidos. La tabla siguiente lista los niveles válidos para los servidores de aplicaciones WebSphere Application Server versión 6 y posteriores.
Nivel de rastreo de la versión 6 y posterior	Contenido / Significado
off	El registro cronológico esta desactivado.
fatal	La tarea no puede continuar y el componente, aplicación, servidor no funcionan.
severe	La tarea no puede continuar pero el componente, aplicación, servidor pueden funcionar todavía. Este nivel también puede indicar un error irrecuperable inminente.
warning	Error potencial o error inminente. Este nivel también puede indicar una anomalía progresiva (por ejemplo, la pérdida potencial de recursos).
audit	Suceso significativo que afecta al estado de servidor o a los recursos
info	Información general que describe el progreso general de las tareas
config	Cambio de configuración o estado
detail	Información general que describe en detalle el progreso de las subtareas
fine	Información de rastreo: rastreo general + entrada de método , salida , valores de retorno
finer	Información de rastreo: rastreo detallado
finest	Información de rastreo: rastreo más detallado que incluye todos los detalles necesarios para depurar problemas
todos	Todos los sucesos se registran cronológicamente. Si se crean niveles personalizados, "Todo" incluiría estos niveles y podría proporcionar un rastreo más detallado que "finest".

Cuando habilite un nivel de registro en la versión 6.0 y posteriores, también está habilitando todos los niveles con mayor gravedad. Por ejemplo, si establece el nivel de registro en aviso en el servidor de aplicaciones de la versión 6.x, se procesarán los sucesos de aviso, grave y muy grave.

[Registro de modalidad básica] La información de rastreo, que son los sucesos con los niveles Fine, Finer y Finest, sólo se pueden escribir en el registro de rastreo. Por lo tanto, si no habilita el rastreo de diagnóstico, aunque establezca el nivel de detalle del registro como Fine, Finer o Finest, no tendrá ningún efecto en los datos anotados.

Correlación: Especifica los valores de correlación que desearía habilitar. Marque el recuadro de selección Habilitar correlación de rastreo y registro para habilitar la correlación para la aplicación de servidor. Desmarque el recuadro de selección Habilitar correlación de rastreo y registro para inhabilitar la correlación para la aplicación de servidor. Seleccione Incluir ID de petición en registros de rastreo y anotaciones cronológicas, Incluir ID de petición en registros de rastreo y anotaciones cronológicas y crear registros de anotaciones de correlación o Incluir ID de petición en registros de rastreo y anotaciones cronológicas, crear registros de anotaciones de correlación y capturar instantáneas de datos, según corresponda.
Procedimientos recomendados: Habilite XCT para incluir los ID de solicitud en los archivos de registro y rastreo cuando desee ver qué entradas de registro y rastreo, en todas las hebras y los procesos de servidor de aplicaciones, están relacionadas con la misma solicitud. Los ID de solicitud sólo se registran cuando se utiliza la modalidad de registro y rastreo HPEL y se pueden ver o utilizar para el filtrado utilizando el mandato logViewer. bprac

Procedimientos recomendados: Habilite XCT para crear registros de anotaciones de correlación cuando desee registrar cómo se ramifican las solicitudes entre las hebras y los procesos y ver información adicional sobre cada solicitud. La habilitación de XCT para crear registros de anotaciones de correlación podría tener un impacto significativo en el rendimiento en el sistema, por lo que se adapta mejor en los entornos de prueba y desarrollo. bprac

Procedimientos recomendados: Habilite XCT para capturar instantáneas de datos cuando desee almacenar todos los cuerpos de solicitud y respuesta en el sistema de archivos. La habilitación de XCT para capturar instantáneas de datos podría tener un impacto significativo de rendimiento en el sistema, así que se adapta mejor para los entornos de prueba y desarrollo. XCT captura las instantáneas de datos para las solicitudes de mensajes y las respuestas manejadas por el SIBus. bprac

Evite problemas: Las instantáneas de datos se capturan y graban en el directorio $SERVER_LOG_ROOT/snapdata. El servidor de aplicaciones no borra automáticamente los archivos de este directorio. Tendrá que suprimir los archivos de este directorio periódicamente cuando está habilitada la captura de instantáneas de datos. Las instantáneas de datos almacenan todo el contenido de solicitudes y respuestas y podrían incluir información confidencial. Es posible que el uso de esta opción no sea apropiado en entornos de producción. gotcha

Guardar cambios de tiempo de ejecución en la configuración: Especifica que se han realizado cambios tanto en el estado dinámico del servidor en ejecución como en la configuración del servidor, que entran en vigor en el siguiente reinicio. Si no se selecciona este recuadro de selección, el servidor no copia los valores en la configuración del servidor.

Nombre de archivo: utrb_loglevel.html