Configurando a Criação de Log do ClearQuest CM API

É possível configurar a criação de log do ClearQuest CM API.

Sobre Esta Tarefa

A criação de log do ClearQuest CM API é controlada usando o arquivo logging.properties associado ao JRE que é executado no seu aplicativo. O arquivo logging.properties é localizado no diretório jre\lib do seu JDK.

A criação de log é desativada, por padrão. Você deve ativar a criação de log no nível INFO.

O arquivo de amostra logging.properties a seguir, ilustra como definir as configurações de log para os aplicativos que usam os ClearQuest CM APIs.
############################################################
#      Propriedades globais
############################################################
#
# "manipuladores" especificam uma lista separada por vírgula de classes de Manipulador de 
# logs.  Esses manipuladores serão instalados durante a inicialização da VM.
# Observe que essas classes devem estar no caminho de classe do sistema.
# Por padrão, configuramos apenas um ConsoleHandler, que apenas
# mostrará mensagens nos níveis INFO e acima.
manipuladores = java.util.logging.ConsoleHandler

# Para incluir também o FileHandler, use a linha a seguir.
#handlers= java.util.logging.FileHandler, java.util.logging.ConsoleHandler

# Nível de criação de log global padrão.
# Isso especifica quais tipos de eventos são registrados entre
# todos os criadores de log.  Para qualquer recurso dado, esse nível global
# pode ser substituído por um nível específico de recurso
# Observe que o ConsoleHandler também possui uma configuração de nível separado
# para limitar as mensagens impressas para o console.
# A próxima linha ativa a criação de log (para todos os objetos do criador de logs) para ocorrer no nível INFO
.level=INFO

############################################################
# Propriedades específicas do manipulador.
# Descreve informações de configuração específicas para os Manipuladores.
############################################################

# CMLogger - Sempre deve estar ativado no nível INFO. 
#
# As linhas a seguir designam a criação de log do objeto CMLogger para que ocorra no nível INFO,
# e que o arquivo de saída do log seja denominado CMLogger[#].log, localizado no diretório HOME do
# usuário conectado; o arquivo de saída do log rodará por 20 arquivos, cada arquivo sendo
# limitado a 20000000 bytes.  As entradas de log serão anexadas ao arquivo de saída de log atual
# na rotação e serão gravadas usando um formato simples.
#
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 - Ativar (remover comentário) as entradas abaixo para uso temporário apenas, pois o rastreio
# pode ser intenso para o recurso.
#
# As linhas a seguir designam o rastreio para o objeto CMTracer para que ocorra no nível FINER,
# e que o testamento de saída de rastreio seja denominado CMTracer[#].log, localizado no diretório HOME do
# do usuário conectado; o arquivo de saída de rastreio rodará por 20 arquivos, cada arquivo sendo
# limitado a 20000000 bytes.  As entradas de rastreio serão anexadas ao arquivo de saída de rastreio atual
# na rotação e serão gravadas usando um formato simples.
#
#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

Essas configurações resultam em um arquivo de log denominado CMLogger[#].log, em que [#] designa o número de rotação do arquivo. Cada arquivo é localizado no diretório HOME do usuário conectado. A saída rola de arquivo para arquivo conforme cada um fica completo.

O uso das entradas logging.properties no exemplo anterior designa que os registros de log sejam anexados ao final do arquivo aplicável e cada entrada seja armazenada em um formato simples. Você deve parar e reiniciar o aplicativo para que as mudanças no arquivo sejam reconhecidas.

Quando um arquivo de saída de log estiver completo, um novo arquivo será criado e o arquivo anterior será renomeado para conter o registro de data e hora de quando ocorreu a rotação do arquivo. Cada arquivo retém 20 MB de dados e novas entradas são anexadas às entradas existentes, incluindo nas reinicializações do aplicativo. Quando a contagem do arquivo de log atinge 20, a rotação para um novo arquivo faz com que o arquivo mais antigo seja excluído.

Para obter mais informações sobre como configurar a criação de log Java, consulte a documentação de Javadoc associada ao seu JDK para java.util.logging.Logger e java.util.logging.FileHandler.

Se você criar um arquivo de propriedade de criação de log customizado, você deverá especificar o local do arquivo usando o argumento -D. Por exemplo:

java -Djava.util.logging.config.file=C:\myLogPropsFile.properties
your_client_java_program_that_uses_CM-API

Feedback