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.
|
|
|
La indicación de fecha y hora utilizando el formato del entorno local o el formato ISO-8601. Puede especificar true o false como valor del atributo o el valor de la propiedad equivalente. El valor predeterminado es false. Si especifica un valor true, se utiliza el formato ISO-8601 en el archivo messages.log, el archivo trace.log y los registros FFDC. El formato es aaaa-MM-dd'T'HH:mm:ss.SSSZ. Si especifica un valor false, el formato de fecha y hora será el establecido en el entorno local predeterminado del sistema. Si no se encuentra el entorno local predeterminado, el formato es dd/MMM/aaaa HH:mm:ss:SSS z. |
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 la granularidad de los mensajes que van a la consola. Los valores válidos son INFO, AUDIT, WARNING, ERROR y OFF. De forma predeterminada, consoleLogLevel se establece en la variable de entorno WLP_LOGGING_CONSOLE_LOGLEVEL (si se ha establecido) o 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. |
![]() |
![]()
|
![]() |
![]() |
![]()
|
![]() |
![]() |
![]()
|
![]() |
![]() |
![]()
|
![]() |
<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 z/OS, el archivo console.log utiliza la página de códigos predeterminada y todos los demás archivos de registro cronológico utilizan la codificación ISO8859-1 y se etiquetan como archivos de texto con esa codificación. Si se activa la característica de conversión automática de página de códigos USS (UNIX System Services) de z/OS, puede utilizar los editores estándar y los programas de utilidad de texto para ver y gestionar los archivos de configuración. los archivos de anotaciones codificados con ISO8859-1.
![[18.0.0.1 and later]](../ng_v18001plus.gif)
- Para establecer messages.log en el formato JSON en el
server.xml.
<logging messageFormat="json" messageSource="message,trace,accessLog,ffdc" />
- Para establecer la consola en el formato JSON en el archivo
server.env.
WLP_LOGGING_CONSOLE_FORMAT=json WLP_LOGGING_CONSOLE_LOGLEVEL=info WLP_LOGGING_CONSOLE_SOURCE=message,trace,accessLog,ffdc
- Para establecer la consola en el formato JSON en el archivo
bootstrap.properties.
com.ibm.ws.logging.console.format=json com.ibm.ws.logging.console.log.level=info com.ibm.ws.logging.console.source=message,trace,accessLog,ffdc