Configuración del nivel de un registro cronológico
Utilice este tema para configurar y gestionar los valores de nivel de un registro cronológico.
Para ver esta página de la consola de administración, pulse
Con los niveles de registro se puede controlar qué sucesos procesa el registro cronológico Java™. Cuando se cambia el nivel de un registrador, dicho cambio se propaga a los hijos del registrador.
- Inhabilite el registro y el rastreo de los datos potencialmente confidenciales
- El servidor de aplicaciones tiene una lista de registradores de los que se sabe que podrían escribir información potencialmente confidencial en el registro y rastreo cuando está habilitado. Por ejemplo, si se habilitan determinados registradores relacionados con HTTP al nivel FINEST, se puede dar lugar a que se almacene en los archivos de rastreo información confidencial especificada por el usuario en las peticiones HTTP. Si desea evitar que el servidor habilite estos registradores de los que se sabe que utilizan información potencialmente confidencial, marque el recuadro de selección Inhabilitar el registro y el rastreo de datos potencialmente confidenciales. 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 del nivel de detalle del registro con la lista de registradores y los niveles de la lista de registradores confidenciales, y actualiza la especificación del nivel de detalle del registro según sea necesario.
- Cambio del nivel de detalle de un registrador cronológico
Especifique un nivel de detalle de las anotaciones cronológicas que especifique los componentes, paquetes o grupos que se han de rastrear. La cadena de nivel de detalle de los registros debe atenerse a la sintaxis específica que se describe a continuación. La cadena de nivel de detalle de las anotaciones cronológicas 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 estática de componentes, paquetes y grupos muy conocidos. Puede que esta lista no sea completa.
Si selecciona la pestaña Tiempo de ejecución y expande Componentes y grupos, se visualizará 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.
La especificación del nivel de detalle de las anotaciones cronológicas tiene este formato:<componente> = <nivel>
donde <componente> es el componente para el cual se establece un nivel de detalle de registro cronológico 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 de las anotaciones cronológicas con dos puntos (:).
Avoid trouble: Las cláusulas incluidas en una especificación de rastreo se leen en el orden en que aparecen en la serie. Por tanto, si se incluyen varias variaciones de la cláusula *=info en una especificación de rastreo, el último valor especificado será el valor que determine el nivel de rastreo que el sistema registrará. Si se especifica *=info como la última cláusula, el rastreo se producirá en el nivel de información, independientemente de otras cláusulas que se hayan especificado en la serie de rastreo. Por ejemplo, si ha especificado la serie de rastreo siguiente:
es equivalente a especificar simplemente:*=info:PMGR=all:*=info:com.ibm.ws.sm.*=all
Puesto que la final cláusula altera temporalmente todas las cláusulas que se hayan especificado delante de la serie. gotcha*=all
Los componentes se corresponden con clases y paquetes de Java o con las colecciones de paquetes Java. Utilice un asterisco (*) como comodín para indicar componentes que incluyan todas las clases en todos los paquetes contenidos en dicho componente especificado. Por ejemplo:- *
- Especifica todo el código rastreable que ejecuta en el servidor de aplicaciones, incluido el código de cliente y el código de sistema del producto.
- com.ibm.ws.*
- Especifica todas las clases cuyo nombre de paquete empieza por com.ibm.ws.
- com.ibm.ws.classloader.JarClassLoader
- Solo especifica 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. Como solución temporal de este problema, entre directamente la especificación de nivel de detalle de los registros cronológicos que desee en el campo de entrada de nivel de detalle de los registros cronológicos.

Nivel de rastreo de la versión 6 y posteriores | Contenido / Significado |
---|---|
off | El registro cronológico está desactivado. |
fatal | La tarea no puede continuar y el componente, la aplicación o el servidor no funcionan. |
severe | La tarea no puede continuar pero el componente, la aplicación o el servidor aún pueden funcionar. Este nivel también puede indicar un error irrecuperable inminente. |
warning | Error potencial o inminente. Este nivel también puede indicar un error progresivo (por ejemplo, la pérdida potencial de recursos). |
audit | Suceso significativo que afecta al estado del servidor o a los recursos |
info | Información general que describe el progreso global de la tarea |
config | Estado de la configuración o cambio en la misma |
detail | Información general que describe en detalle el progreso de las subtareas |
fine | Información de rastreo: Rastreo general + entrada, salida de método y 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 |
all | Se registran todos los sucesos. Si se crean niveles personalizados, "All" incluiría dichos niveles y podría proporcionar un rastreo más detallado que "finest". |
[Registro en modo básico] La información de rastreo, que son sucesos en los niveles Fine, Finer y Finest, solo se puede escribir en el registro cronológico de rastreo. Por lo tanto, si no se habilita el rastreo de diagnóstico, aunque se establezca el nivel de detalle del registro a Fine, Finer o Finest, no tendrá ningún efecto en los datos registrados.
- Correlación
- Especifique los valores de correlación que desee habilitar. Marque el recuadro de selección Habilitar correlación de rastreo y registro para habilitar la correlación en el servidor de aplicaciones. Desmarque el recuadro de selección Habilitar correlación de rastreo y registro para inhabilitar la correlación en el servidor de aplicaciones. 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 en 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.
Best practice: Habilite XCT para incluir los ID de petición en los archivos de registro y rastreo cuando desee ver qué entradas de registro y rastreo, en todos los hilos y procesos del servidor de aplicaciones, están relacionadas con la misma petición. Los ID de solicitud solo se registran cuando se utiliza el modo de registro y rastreo HPEL, y se pueden ver o utilizar en el filtrado mediante el comando logViewer. bprac
Best practice: Habilite XCT para crear registros de anotaciones de correlación si desea registrar cómo se bifurcan las peticiones entre hilos y 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 del sistema, por lo que se adapta mejor a los entornos de pruebas y desarrollo.bprac
Best practice: Habilite XCT para capturar instantáneas de datos cuando desee almacenar todos los cuerpos de petición 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 a los entornos de prueba y desarrollo. XCT captura instantáneas de datos de las respuestas y peticiones de mensajes manejadas por SIBus.bprac
Avoid trouble: Las instantáneas de datos se capturan y escriben 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 peticiones y respuestas, y podrían incluir información confidencial. El uso de esta opción podría no ser apropiado en entornos de producción.gotcha
- Guarde también los cambios al entorno 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 copiará los valores en la configuración del servidor.