Configuración del registro cronológico

El registro cronológico puede utilizarse para supervisar y depurar CM Server y aplicaciones basadas en la API CM.

El registro cronológico realiza un seguimiento de las operaciones habituales del usuario de la API CM y CM Server así como de los errores que se puedan producir mientras CM Server o la aplicación basada en la API CM están en ejecución. Las entradas de registro se producen en el entorno local predeterminado de la máquina, o en inglés de EE.UU. si no se da soporte al entorno local de la máquina.

De forma predeterminada, el registro cronológico para CM Server se establece en el nivel INFO. Debe habilitar el registro cronológico de la aplicación basada en la API CM en el nivel INFO.

Puede configurar los paquetes de registro cronológico de la API CM, WebSphere Application Server y TSlogger.

Registro cronológico de la API CM

El registro cronológico de la API CM se controla mediante la utilización del archivo logging.properties ubicado en la estructura del directorio del JDK del JRE que se utiliza para ejecutar la aplicación. Mire en el archivo logging.properties del directorio jre\lib del JDK (por ejemplo, C:\Archivos de programa\IBM\WebSphere\AST\eclipse\jre\lib, C:\jdk_5.0\jre\lib o C:\Archivos de programa\Java\jre1.5.0_06\lib).

El registro cronológico está inhabilitado de forma predeterminada; debe habilitarlo en el nivel INFO.

El siguiente archivo logging.properties de ejemplo contienen entradas que muestran cómo configurar los valores de registro y rastreo para las aplicaciones basadas en la API CM:
############################################################
#      Propiedades globales
############################################################
#
# "manejadores" especifica una lista separada por comas de
# clases de manejadores de registro.  Estos manejadores se
# instalarán durante el inicio de la VM.
# Tenga en cuenta que estas clases deben estar en la variable
# classpath del sistema.
De manera predeterminada, sólo
# configuramos un ConsoleHandler, que sólo mostrará
# mensajes en el nivel INFO y niveles superiores.
handlers = java.util.logging.ConsoleHandler

# Para añadir también el FileHandler, utilice en su lugar la línea siguiente.
#handlers= java.util.logging.FileHandler, java.util.logging.ConsoleHandler

# Nivel de registro cronológico global predeterminado.
# Especifica las clases de sucesos que se registran entre
# todos los registradores.  Para un recurso determinado,
# este nivel global puede ser alterado temporalmente por
# un nivel específico del recurso
# Tenga en cuenta que ConsoleHandler también tiene un valor de
# nivel aparte para limitar los mensajes que se imprimen en la consola.
# La línea siguiente habilita el registro cronológico (para todos los
# objetos de registrador) para que se produzca en el nivel INFO
.level=INFO

############################################################
# Propiedades específicas del manejador.
# Describe información de configuración específica para los manejadores.
############################################################

# CMLogger: siempre debe estar habilitado en el nivel INFO. 
#
# No es necesario detener y reiniciar las aplicaciones que utilizan la API CM;
# los cambios en el archivo logging.properties configurado se perciben automáticamente
# y se aplican transcurridos 10 segundos.
#
# Las líneas siguientes indican que el registro cronológico para el objeto CMLogger se
# produzca en el nivel INFO, y que el archivo de salida de registro recibirá el nombre
# CMLogger[#].log, ubicado en el directorio HOME del usuario que ha iniciado la sesión;
# el archivo de salida de registro rotará por 40 archivos y cada archivo estará limitado
# a 40000000 bytes.  Las entradas de registro se añadirán al archivo de salida de
# registro actual en la rotación y se grabarán utilizando un formato simple.
#
com.ibm.rational.stp.common.internal.util.CMLogger.level = INFO
com.ibm.rational.stp.common.internal.util.LogHandler.pattern = %h/CMLogger%g.log
com.ibm.rational.stp.common.internal.util.LogHandler.limit = 40000000
com.ibm.rational.stp.common.internal.util.LogHandler.count = 40
com.ibm.rational.stp.common.internal.util.LogHandler.append = true
com.ibm.rational.stp.common.internal.util.LogHandler.formatter = java.util.logging.SimpleFormatter

# CMTracer: habilite (descomente) las entradas siguientes sólo para uso temporal, ya que el
# rastreo puede consumir muchos recursos.  
#
# No es necesario detener y reiniciar las aplicaciones que utilizan la API CM;
# los cambios en el archivo logging.properties configurado se perciben automáticamente
# y se aplican transcurridos 10 segundos.
#
# Las líneas siguientes indican que el rastreo para el objeto CMTracer se produzca en el nivel FINER y que el
# el archivo de salida de rastreo recibirá el nombre CMTracer[#].log, ubicado en el directorio HOME del usuario
# que ha iniciado la sesión; el archivo de salida de rastreo rotará por 40 archivos y cada archivo estará limitado
# a 40000000 bytes.  # Las entradas de rastreo se añadirá al archivos de salida de rastreo actual en la
# rotación y se grabarán utilizando un formato simple.
#
#com.ibm.rational.stp.common.internal.util.CMTracer.level = FINER
#com.ibm.rational.stp.common.internal.util.TraceHandler.pattern = %h/CMTracer%g.log
#com.ibm.rational.stp.common.internal.util.TraceHandler.limit = 40000000
#com.ibm.rational.stp.common.internal.util.TraceHandler.count = 40
#com.ibm.rational.stp.common.internal.util.TraceHandler.append = true
#com.ibm.rational.stp.common.internal.util.TraceHandler.formatter = java.util.logging.SimpleFormatter

Estos valores dan como resultado un archivo de registro denominado CMLogger[#].log (y un archivo de salida de rastreo denominado CMTracer[#].log cuando se elimina el signo de comentario de las entradas de CMTracer). Cada archivo está ubicado en el directorio HOME del usuario que ha iniciado la sesión (donde [#] indica el número de rotación de archivo); la salida se reinicia de un archivo a otro conforme cada archivo se llena.

La utilización de las entradas de logging.properties anteriores indica que se deben añadir los registros de registro cronológico al final del archivo aplicable y que cada entrada se almacena en formato simple. La aplicación basada en la API CM percibe automáticamente los cambios en el archivo logging.properties y los cumple transcurridos aproximadamente 10 segundos; no es necesario detener y reiniciar la aplicación.

Cuando un archivo de salida de registro pasa a estar lleno (cuando alcanza los 40 MBytes), se crea un nuevo archivo y el archivo anterior se renombra para que contenga la fecha y la indicación de fecha y hora en la que se produjo la rotación de archivo. Cada archivo mantiene 40 MB de datos y se añaden nuevas entradas a las entradas existentes, incluyendo entre reinicios de la aplicación. Cuando el número de archivos de registro llegue a 40, la rotación a un nuevo archivo hace que el archivo más antiguo se suprima automáticamente.

Para obtener más información sobre cómo configurar el registro cronológico de Java, consulte los Javadoc java.util.logging.Logger y java.util.logging.FileHandler de JDK.

Si crea un archivo de propiedades de registro cronológico personalizado, debe especificar dónde encontrarlo para la JVM especificando el argumento -D. Por ejemplo:
java -Djava.util.logging.config.file=C:\myLogPropsFile.properties el_programa_java_cliente_que_utiliza_API-CM

Configuración del registro cronológico y del rastreo de WebSphere Application Server

Establezca y configure el registro cronológico y el rastreo de WebSphere Application Server mediante la consola administrativa de WebSphere Application Server. Puede utilizar este URL para acceder a la consola administrativa de WebSphere Application Server:
http://<nombre-servidor>:<número-puerto-consola-admin>/ibm/console
donde <nombre-servidor> es el nombre del sistema de CM Server y <puerto-consola-admin> es el número de puerto de la consola administrativa (12060 de forma predeterminada con CM Server o 9060 para las otras versiones de WebSphere Application Server).
Nota: El rastreo en cualquier nivel (FINE, FINER o FINEST) para cualquier componente que se ejecuta en WebSphere Application Server (incluidos los componentes de CM Server) afectarán negativamente al rendimiento.

En función del tipo de Websphere Application Server que se utilice en el sistema de CM Server, es posible que pueda realizar cambios en tiempo real sin tener que detener o reiniciar CM Server. En las páginas de configuración del registro cronológico de la consola administrativa, existen dos pestañas: una pestaña Configuración y una pestaña Tiempo de ejecución.

En la consola administrativa, pulse Resolución de problemas->Registro cronológico y rastreo y seleccione el servidor que desea configurar en la lista de servidores. Seleccione Cambiar nivel de detalle de registro cronológico y pulse la pestaña Tiempo de ejecución. Los cambios realizados en la pestaña Tiempo de ejecución se aplicarán tan pronto como guarde los cambios; los cambios realizados en la pestaña Configuración no se aplicarán hasta que reinicie el servidor. Si desea que los cambios permanezcan, marque el recuadro de selección Guardar cambios de tiempo de ejecución también en la configuración. Seleccione el enlace Componentes. Tenga en cuenta que *=info aparece en el recuadro. Abra la opción com.ibm.rational.* y seleccione com.ibm.rational.stp.*. Seleccione el nivel pulsando la opción Niveles de mensaje y rastreo. Pulse Aceptar y, a continuación, pulse el enlace Guardar del área Mensajes en la parte superior de la página que se abre. Los cambios realizados se aplicarán sin reiniciar el servidor.

Si la versión o clase de Websphere Application Server del sistema de CM Server no proporciona una pestaña Tiempo de ejecución que permita cambios a la configuración en tiempo real, utilice la pestaña Configuración y luego reinicie el servidor para que se apliquen los cambios guardados.

Muy probablemente será necesario aumentar los valores listos para usar predeterminados para el tamaño de archivo de registro y el número de archivos de registro. Debe establecer el número de archivos de registro a través de los que rotar como mínimo en 40 y establecer el tamaño de archivo de registro en como mínimo 40 MB. En la consola administrativa de Websphere Application Server, realice estos pasos para cambiar los valores de tamaño de archivo de registro y rotación de archivos de JVM:
  1. Seleccione Resolución de problemas->Registro cronológico y rastreo.
  2. Seleccione el servidor relevante que desea configurar en la lista de servidores.
  3. Seleccione Registro cronológico de JVM y, a continuación, pulse la pestaña Configuración (la pestaña Tiempo de ejecución se puede utilizar para visualizar el contenido actual de SystemOut.log y SystemErr.log).
  4. Realice los cambios en las ubicaciones de SystemOut y SystemErr, los tamaños de archivo (como mínimo, 40 MB) y cuántos archivos históricos deben mantenerse (como mínimo, 40 MB).
  5. Pulse Aceptar y, a continuación, pulse el enlace Guardar del área Mensajes en la parte superior de la página que se abre.
Los archivos de registro de WebSphere Application Server se encuentran en las ubicaciones siguientes:
  • UNIX : /opt/IBM/RationalSDLC/common/CM/profiles/cmprofile/logs/server1/
  • Linux: /opt/ibm/RationalSDLC/common/CM/profiles/cmprofile/logs/server1/
  • Windows: \Archivos de programa\IBM\RationalSDLC\common\CM\profiles\cmprofile\logs\server1\

TSlogger

TSLogger permite registrar los procesos del servidor ONCRPC de fondo. Este programa de utilidad se configura editando el archivo tslogger.properties, que se encuentra en:
  • Windows: \Archivos de programa\IBM\RationalSDLC\common\CM\bin\tslogger.properties
  • UNIX: /opt/IBM/RationalSDLC/common/CM/bin/tslogger.properties
  • Linux: /opt/ibm/RationalSDLC/common/CM/bin/tslogger.properties
Los archivos de registro y de rastreo se encuentran en las ubicaciones siguientes:
  • Windows: \Archivos de programa\IBM\RationalSDLC\common\CM\logs\server1\ccrpc [y \cqrpc]
  • UNIX: /opt/IBM/RationalSDLC/common/CM/logs/server1/ccrpc [y /cqrpc]
  • Linux: /opt/ibm/RationalSDLC/common/CM/logs/server1/ccrpc [y /cqrpc]
Los archivos de registro y rastreo incluyen los siguientes:
  • SystemOut.log: salida de registro cronológico General; está habilitado para registrar en el nivel INFO de forma predeterminada.
  • SystemErr.log: salida de errores/excepciones; está habilitado de forma predeterminada.
  • trace.log: salida de rastreo; está inhabilitado de forma predeterminada.

El archivo tslogger.properties tiene áreas con etiquetas donde se pueden realizar cambios y cuál puede ser el rango de valores aceptables. El registro cronológico está habilitado de forma predeterminada en el nivel INFO. Todos los mensajes INFO, WARNING y SEVERE se registran en el archivo de registro. Los archivos de registro se configuran editando el archivo tslogger.properties; sin embargo, el archivo se configura adecuadamente durante la instalación y no es necesario realizar ningún cambio.

Los valores predeterminados en el archivo tslogger.properties se establecen en valores que no deben necesitar modificaciones. Conforme se llenan los archivos de salida, la salida rota al archivo siguiente. Una vez que se ha alcanzado el número máximo de archivos en la rotación, el archivo más antiguo se elimina para dejar espacio para el siguiente archivo en la rotación.

Resumen de los niveles de registro cronológico desde el máximo al mínimo:
  • OFF: Inhabilitar todo el registro cronológico y el rastreo.
  • ERROR: Se corresponde con SEVERE en JSR47.
  • WARNING: Se corresponde con WARNING en JSR47.
  • INFO: Se corresponde con INFO en JSR47.
  • DEBUG_MIN: Se corresponde con FINE en JSR47.
  • DEBUG_MID: Se corresponde con FINER en JSR47.
  • DEBUG_MAX: Se corresponde con FINEST en JSR47.
  • ALL: Habilitar todos los niveles de registro cronológico y rastreo.
Conceptos relacionados
Los archivos de registro de ClearQuest y los archivos de propiedades de registro

Comentarios