Registro 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: Este archivo contiene las corrientes de salida estándar y de error estándar redireccionadas del proceso de JVM. Esta salida de la consola está destinada al consumo humano directo. El componente de registro escribe los sucesos principales en la corriente de salida estándar y los errores en la corriente de error estándar si utiliza la configuración consoleLogLevel predeterminada. El componente de registro también copia los mensajes que se escriben en la corriente System.out en la corriente de salida estándar y los mensajes que se graban en la corriente System.err en la corriente de error estándar, si utiliza la configuración copySystemStreams predeterminada. Las corrientes de salida estándar y de error estándar siempre contienen mensajes que se escriben directamente por parte del proceso de JVM como, por ejemplo, la salida -verbose:gc. Este archivo solo se crea si se utiliza el mandato start del servidor, y su ubicación solo se puede alterar utilizando la variable de entorno LOG_DIR. Para obtener más información, consulte Administración de Liberty desde la línea de mandatos.
- messages.log: Este archivo contiene todos los mensajes que se escriben o son capturados por 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: Este archivo contiene todos los mensajes que se escriben o son capturados por el componente de registro y cualquier rastreo adicional. 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 |
|
Puede utilizar este atributo para
establecer un 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
de 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 de archivo
máximo aplicado, este valor se utiliza para determinar cuántos de los
archivos de registro se conservan. 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 registro cronológico 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 Liberty es ENHANCED. También puede utilizar los formatos BASIC y ADVANCED como en el WebSphere Application Server tradicional. |
hideMessage |
|
Puede utilizar este atributo 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. Nota: Antes de utilizar
este atributo, tenga en cuenta la información que se proporciona
en la sección No se puede reconocer el inicio del servidor
cuando se utiliza el atributo hideMessage para suprimir el
mensaje en el tema Liberty: Restricciones conocidas de las herramientas de desarrollador.
|
<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 los registros cronológicos 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 registro cronológico utilizan la codificación predeterminada.