Criação de log de mensagem do aplicativo no IBM Rational DOORS

No IBM® Rational DOORS, você pode utilizar mensagens de aplicativos para controlar os logs de diagnóstico para resolução de problemas.

A Versão 9.4 introduziu a criação de log da mensagem do aplicativo que é baseada nos serviços de criação de log Apache log4cxx. É possível limitar o tamanho do arquivo de log, configurar a limpeza automática de arquivos antigos, escolher o formato de arquivos de log de saída e alterar o nível de log e as configurações de log sem reiniciar o servidor. O arquivo de configuração é monitorado a cada 60 segundos para detectar mudanças.

Existem cinco modos de log, listados aqui a partir do mais baixo para o mais alto: Depurar, Informações, Aviso, Erro e Fatal. Cada nível registrará as informações para esse nível e todos os níveis superiores. Por exemplo, o nível Aviso inclui informações dos modos Aviso, Erro e Fatal.

O servidor de banco de dados Rational DOORS ainda suporta o estilo anterior de criação de log, que você pode ativar utilizando o comutador de linha de comandos -logfile. Para obter mais informações, consulte Comutadores da linha de comandos para o servidor do banco de dados.

As informações que são transmitidas para os arquivos de log são controladas por um arquivo de configuração baseado em XML. Dois arquivos de configuração são fornecidos:

Por padrão, esses arquivos estão no caminho raiz do Rational DOORS; por exemplo, C:\Program Files\IBM\Rational\DOORS\9.version.

O arquivo de configuração do arquivo .xml

Os parâmetros que controlam a criação de log da mensagem do aplicativo estão em duas seções do arquivo de configuração:
  • Os parâmetros do anexador fornecem configurações para o caminho de arquivo de log, nível de log, tamanho máximo do arquivo, índice máximo de backup e formato para cada um dos arquivos de log.
  • Os parâmetros do criador de logs fornecem as configurações para o modo de criação de log geral e um conjunto de anexadores que podem ser ativados para a criação de log.
Tabela 1. Parâmetros do anexador
Nome Descrição Valor
nome do anexador Este parâmetro é o nome do anexador que é utilizado para descrever quais anexadores são ativados. Qualquer um; por exemplo, SystemOutAppender
arquivo Este valor de parâmetro especifica o nome e o local de um arquivo de log que é criado. Um local acessível em seu sistema; por exemplo, C:\IBM\DOORS\log\SystemError.log
anexar Se este parâmetro for configurado como true, as informações serão anexadas ao arquivo que é mencionado no parâmetro de arquivo. Se esse parâmetro for configurado como false, o arquivo que é mencionado no parâmetro do arquivo será sobrescrito. true ou false
Limite Esse parâmetro configura o modo de log. desativar, fatal, erro, aviso, informações ou depuração
Se o limite for configurado como fatal, apenas as informações fatais serão registradas no arquivo de log. fatal
Se o limite for configurado como erro, as informações de fatal e erro serão registradas no arquivo de log. error
Se o limite for configurado para aviso, as informações de fatal, erro e aviso serão registradas no arquivo de log. warn
Se o limite for configurado para informações, as mensagens de informações de fatal, erro e aviso serão registradas no arquivo de log. informações
Se o limite for configurado para depurar, todas as informações serão registradas no arquivo de log. debug
Se o limite for configurado como desativado, a criação de log será desativada. off
MaxFileSize Este parâmetro configura o tamanho máximo do arquivo de log. Após o arquivo de log atingir o tamanho máximo, outro arquivo de log será criado. O nome do arquivo novo inclui o número incremental. Qualquer um com uma unidade; por exemplo, 1000 KB
MaxBackupIndex Este parâmetro configura o número máximo de arquivos que são criados para o criador de logs. Depois que o número máximo for atingido, os arquivos serão sobrescritos, iniciando com o arquivo mais antigo. Qualquer número inteiro
Padrão de Conversão Este parâmetro especifica o formato no qual as informações são registradas no arquivo de log. Você pode incluir a data e hora, o modo de log e um resumo das informações que são registradas. É possível alterar a sequência, conforme necessário. Este valor começa com a data: %d{dd MMM yyyy HH:mm:ss:SSS} [%p] %m%n
Este valor começa com o modo de log: [%p] %m%n %d{dd MMM yyyy HH:mm:ss:SSS}
Tabela 2. Parâmetros do criador de logs
Nome do parâmetro Descrição Valor
prioridade Este parâmetro configura o nível de modo de criação de log para a criação de log geral. A configuração padrão é igual a "all". Para desativar a criação de log, configure esse valor de parâmetro como "desativar" todos, depuração, erro, fatal, informações, desativar ou aviso
referência do anexador O valor da referência contém o nome dos anexadores que você definiu nas seções do anexador. Dependendo de quais anexadores devem ser ativados para a criação de log, você deve fornecer os nomes do anexador. <appender-ref ref="DOORSConsoleAppender"/>
Para ativar diversos anexadores, crie várias instâncias da tag <appender-ref>. <appender-ref ref="SystemOutAppender"/>

Feedback