Configuración del registro cronológico de API CM

Puede configurar el registro cronológico de la API del Servidor de gestión de cambios (CM)

Acerca de esta tarea

El registro cronológico de la API CM se controla mediante la utilización del archivo logging.properties asociado con el JRE que está ejecutando en la aplicación. El archivo logging.properties está ubicado en el directorio jre\lib del JDK; por ejemplo, C:\Program Files\IBM\WebSphere\AST\eclipse\jre\lib, C:\jdk_5.0\jre\lib, o C:\Program Files\Java\jre1.5.0_06\lib).

El registro cronológico está inhabilitado de forma predeterminada. Debe habilitar el registro cronológico en el nivel INFO.

El siguiente archivo de muestra logging.properties ilustra cómo configurar los valores del registro para aplicaciones basada en API CM:
############################################################
#      Propiedades globales
############################################################
#
# "manejadores" especifica una lista separada por comas de manejadores de registro. 
# clases.  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. 
#
# 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 20 archivos y cada archivo estará limitado
# a 20000000 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 = 20000000
com.ibm.rational.stp.common.internal.util.LogHandler.count = 20
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.  
#
# 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 20 archivos y cada archivo estará limitado
# a 20000000 bytes.  Las entradas de rastreo se añadirán al archivo 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 = 20000000
#com.ibm.rational.stp.common.internal.util.TraceHandler.count = 20
#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, donde [#] designa el número de rotación del archivo. Cada archivo está ubicado en el directorio HOME del usuario que ha iniciado la sesión; la salida se reinicia de un archivo a otro conforme cada archivo se llena.

La utilización de las entradas de logging.properties en el ejemplo anterior indica que los registros de registro cronológico se añaden al final del archivo aplicable y que cada entrada se almacena en formato simple. Debe detener y reiniciar la aplicación para que se reconozcan los cambios en el archivo.

Cuando un archivo de salida de registro pasa a estar lleno, 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 20 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 20, la rotación a un nuevo archivo hace que el archivo más antiguo se suprima.

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

Si crea un archivo de propiedades de registro personalizado, debe especificar la ubicación del archivo con el argumento -D. Por ejemplo:

java -Djava.util.logging.config.file=C:\myLogPropsFile.properties el_programa_java_cliente_que_utiliza_API-CM

Feedback