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.

Hay tres archivos de registro primarios para un servidor:
  1. 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.
  2. 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.
  3. 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

El componente de registro puede controlarse mediante la configuración de servidor. La ubicación primaria de la configuración de registro se halla en el archivo server.xml. Ocasionalmente, puede que tenga que configurar el rastreo para diagnosticar un problema que se produce antes de que se procese el archivo server.xml. En tal caso, se pueden especificar las propiedades de configuración equivalentes en el archivo bootstrap.properties. Si se especifica una propiedad de configuración en el archivo bootstrap.properties y en el archivo server.xml, se utilizará el valor de bootstrap.properties hasta que se procese el archivo server.xml. A continuación, se utilizará valor del archivo server.xml. Evite especificar valores distintos para la misma propiedad de configuración en los archivos bootstrap.properties y server.xml.
Tabla 1. Propiedades de registro para Liberty. La columna 1 contiene atributos que se pueden establecer en el archivo server.xml. La columna 2 contiene propiedades equivalentes que se pueden utilizar en el archivo bootstrap.properties. La columna 3 proporciona una descripción de cada propiedad de registro.
Atributo Propiedad equivalente Descripción
logDirectory
com.ibm.ws.logging
.log.directory
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
com.ibm.ws.logging
.max.file.size
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
com.ibm.ws.logging
.max.files
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
com.ibm.ws.logging
.console.log.level
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.
For distributed platformsNota: Antes de cambiar este valor, tenga en cuenta la información de la sección "No se puede interactuar con el servidor Liberty tras modificar los valores del nivel de registro de consola" en el tema Liberty: Restricciones conocidas de las herramientas de desarrollador.
copySystemStreams
com.ibm.ws.logging.
copy.system.streams
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
com.ibm.ws.logging
.message.file.name
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
com.ibm.ws.logging
.trace.file.name
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
com.ibm.ws.logging
.trace.specification
La serie de rastreo se utiliza para habilitar el rastreo de forma selectiva. El valor predeterminado es *=info.
traceFormat
com.ibm.ws.logging
.trace.format
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
com.ibm.ws.logging.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.
Puede establecer propiedades de registro en el archivo de configuración de servidor seleccionando Registro y rastreo en la vista Configuración de servidor en las herramientas de desarrollador. O bien añadiendo un elemento de registro en el archivo de configuración del servidor del modo siguiente:
<logging traceSpecification="*=audit:com.myco.mypackage.*=finest"/>
El formato de la especificación del nivel de detalle de registro:
<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 (:).

Atención: Para un registrador determinado, el nivel está determinado por la especificación de rastreo más específica que se aplica a ese registrador.
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 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.
Tabla 2. Niveles válidos de registro. La siguiente tabla enumera los niveles válidos para servidores de aplicaciones en WebSphere Application Server Versión 6 y superiores.
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.
El archivo console.log no tiene el mismo nivel de gestión que otros archivos de registro. La única propiedad que puede cambiar es consoleLogLevel. Si le preocupa el creciente tamaño del archivo console.log, puede inhabilitar el archivo console.log y utilizar el archivo de registro de mensajes en su lugar. En el archivo de registro de mensajes se escriben los mismos datos, en formato diferente, y puede controlar el tamaño y el número de archivos del registro de mensajes mediante los atributos maxFileSize y maxFiles. Por ejemplo, el archivo bootstrap.properties siguiente genera un archivo console.log vacío y un máximo de tres archivos loggingMessages.log de 1 MB. Sin embargo, los mensajes de la JVM subyacente se seguirán grabando en console.log. Los valores del archivo bootstrap.properties tienen efecto antes de crear el archivo de registro de mensajes, de forma que este archivo de registro de mensajes se crea inicialmente como loggingMessages.log y no como messages.log predeterminado.
   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.
Nota: En todas las plataformas, los registros cronológicos se graban en la codificación predeterminada del sistema.
  • For Windows platformsEn 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.
  • For distributed platformsEn todas las demás plataformas, todos los archivos de registro cronológico utilizan la codificación predeterminada.

Icono que indica el tipo de tema Tema de referencia



Icono de indicación de fecha y hora Última actualización: Tuesday, 6 December 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rwlp_logging
Nombre de archivo:rwlp_logging.html