Inicio de sesión y rastreo
El producto tiene un componente de registro unificado que gestiona los mensajes generados por el producto y proporciona servicios FFDC (First Failure Data Capture - captura de datos en primer error).
Adicionalmente, el componente de registro captura mensajes que se graban en el registro System.out, System.err, java.util.logging y OSGi. El componente de registro unifica la gestión de estos mensajes con otros mensajes escritos por el mensaje. El componente de registro no es capaz de capturar mensajes que escribe directamente el proceso de la JVM como, por ejemplo, la salida -verbose:gc.
- console.log - que contiene la salida estándar redirigida y los errores estándar del proceso de la JVM. Esta salida de la consola está destinada al consumo humano directo. La salida de la consola contiene sucesos principales y errores si utiliza la configuración predeterminada de consoleLogLevel. La salida de la consola también contiene los mensajes que se escriben en las corrientes de System.out y System.err si utiliza la configuración predeterminada de copySystemStreams. La salida de la consola siempre contiene mensajes que graba directamente el proceso de la JVM como, por ejemplo, la salida -verbose:gc. Este archivo se crea solamente si se utiliza el mandato server start, y su ubicación sólo puede alterarse mediante la variable de entorno LOG_DIR. Para obtener más información, consulte Administración del perfil Liberty desde la línea de mandatos.
- messages.log - que contiene todos los mensajes excepto los mensajes de rastreo que graba o captura el componente de registro. Todos los mensajes que se graban en este archivo contienen información adicional como, por ejemplo, la indicación de fecha y hora del mensaje y el ID de la hebra que ha grabado el mensaje. Este archivo no contiene mensajes que graba directamente el proceso de la JVM.
- trace.log - que contiene todos los mensajes que graba o captura el producto. Este archivo se crea solamente si habilita el rastreo adicional. Este archivo no contiene mensajes que graba directamente el proceso de la JVM.
Configuración del registro
Atributo | Propiedad equivalente | Descripción |
---|---|---|
logDirectory |
|
Este atributo establece el directorio para todos los archivos de registro, excluyendo el archivo
console.log, pero incluyendo FFDC. De forma predeterminada, logDirectory se
establece en la variable de entorno LOG_DIR. La vía de acceso predeterminada de la variable de entorno LOG_DIR es
WLP_OUTPUT_DIR/serverName/logs. Evite problemas: Utilice la variable de entorno
LOG_DIR o la propiedad com.ibm.ws.logging.log.directory en lugar del atributo logDirectory para
configurar
el directorio en el que desea que se graben todos los mensajes. De lo contrario, algunos mensaje se grabarán inicialmente en el directorio
logs de forma predeterminada y, a continuación, los mensajes restantes se escribirán en el directorio especificado en la
configuración. El atributo logDirectory puede utilizarse para actualizar dinámicamente los registros del directorio especificado
mientras el servidor está en ejecución.
|
maxFileSize |
|
El tamaño máximo (en MB) que un archivo de registro puede alcanzar antes de que se reinicie. El entorno de ejecución
del
perfil Liberty solo realiza reinicios de registro basados en el tamaño. Para inhabilitar este atributo, establezca el valor en 0. El tamaño máximo de archivo es aproximado. De forma predeterminada, el valor es 20. Nota: maxFileSize no se aplica al archivo console.log.
|
maxFiles |
|
Si existe un tamaño máximo de archivo en vigor, este valor se utiliza para determinar qué cantidad de cada uno
de los
archivos de registro se conserva. Este valor también se aplica al número de registros de excepción que resumen las excepciones que se han producido en un día en particular. Por lo tanto, si este número es 10, puede tener 10 registros de mensajes, 10 registros de rastreo y 10 resúmenes de excepciones en el directorio ffdc/. De forma predeterminada, el valor es 2. Nota: maxFiles no se aplica al archivo console.log.
|
consoleLogLevel |
|
Este filtro controla el detalle de los mensajes que se guardan en el archivo console.log. Los valores válidos son INFO, AUDIT, WARNING, ERROR y OFF. De forma predeterminada, el nivel es AUDIT. ![]() |
copySystemStreams |
|
Si el valor es true, los mensajes grabados en las corrientes de System.out y System.err se copiarán en console.log. Si es false, estos mensajes se grabarán en los registros configurados como, por ejemplo, messages.log o trace.log pero no se copiarán en console.log. El valor predeterminado es true. |
messageFileName |
|
El registro de mensajes tiene como nombre predeterminado messages.log. Este archivo siempre existe y contiene los mensajes INFO y otros mensajes (AUDIT, WARNING, ERROR, FAILURE) además de System.out y System.err. Este registro también contiene las indicaciones de fecha y hora, y el ID de la hebra de emisión. Si el archivo de registro se retrotrae, los nombres de los archivos de registro anterior tienen el formato messages_indicación_fecha_hora.log |
suppressSensitiveTrace | El rastreo del servidor puede exponer datos sensibles al rastrear los datos sin tipo, como los bytes recibidos en una conexión de red. Este atributo, si está establecido en true, impide que la información confidencial potencialmente se exponga en los archivos de anotaciones cronológicas y rastreo. El valor predeterminado es false. | |
traceFileName |
|
El archivo trace.log sólo se crea si se ha habilitado el rastreo adicional o detallado. stdout se reconoce como un valor especial y hace que el rastreo se dirija a la corriente de salida estándar original. |
traceSpecification |
|
La serie de rastreo se utiliza para habilitar el rastreo de forma selectiva. El valor predeterminado es *=info. |
traceFormat |
|
Este atributo controla el formato del registro de rastreo. El formato predeterminado para el perfil Liberty es ENHANCED. También puede utilizar los formatos BASIC y ADVANCED como en el perfil completo. |
![]() |
|
Puede utilizar el atributo hideMessage para configurar los mensajes que desea ocultar de los
archivos console.log y message.log. Si los mensajes se han configurado para ocultarse, se redireccionan al
archivo trace.log.
![]() |
<logging traceSpecification="*=audit:com.myco.mypackage.*=finest"/>
<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 de las anotaciones cronológicas con dos puntos (:).
- *
- Especifica todo el código rastreable que se está ejecutando en el servidor de aplicaciones, incluido el código del sistema del producto y el código de cliente.
- com.ibm.ws.*
- Especifica todas las clases con el nombre de paquete que comienza por com.ibm.ws.
- com.ibm.ws.classloader.JarClassLoader
- Especifica sólo la clase JarClassLoader.
Nivel de registro cronológico Versión 6 y posteriores | Contenido / Importancia |
---|---|
off | El registro cronológico está desactivado. |
fatal | La tarea no puede continuar y el componente, la aplicación y el servidor dejan de funcionar. |
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 | Posible error o error latente. Este nivel también puede indicar una anomalía progresiva (por ejemplo, la posible falta 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 tareas |
config | Estado o cambio de configuración |
detail | Información general que detalla 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 |
all | Todos los sucesos se anotan cronológicamente. Si crea niveles personalizados, all incluirá esos niveles y puede suministrar un rastreo más detallado que el valor finest. |
com.ibm.ws.logging.max.file.size=1
com.ibm.ws.logging.max.files=3
com.ibm.ws.logging.console.log.level=OFF
com.ibm.ws.logging.message.file.name=loggingMessages.log
El archivo
console.log se restablece al reiniciar el servidor. En los sistemas Windows, hay dos tipos de codificación: la página de códigos OEM, que se utiliza para la salida de la consola, y la página de códigos ANSI, que se utiliza para leer y escribir archivos. El archivo console.log utiliza la página de códigos OEM, y todos los demás registros utilizan la página de códigos ANSI.
En todas las demás plataformas, todos los archivos de anotaciones cronológicas utilizan la codificación predeterminada.