É possível configurar limites no tamanho dos arquivos de log, configurar a limpeza automática de arquivos antigos, escolher o formato de arquivos de log de saída, alterar o nível de log e alterar essas configurações de log sem reiniciar o servidor. Esses arquivos de configuração estão sendo monitorados no intervalo de 60 segundos e qualquer mudança feita neste arquivo refletirá neste tempo.
O servidor Rational DOORS continua a suportar o antigo estilo da criação de log que pode ser ativada usando comutadores da linha de comandos -logfile (-l) (Consulte Comutadores da Linha de Comandos para servidor de banco de dados do Rational DOORS).
As informações que devem ser registradas nos arquivos de log são controladas pelo arquivo de configuração baseado em XML, o arquivo de amostra 'logging-config.xml' está localizado no caminho raiz do DOORS, por padrão, (por exemplo, C:\Program Files\IBM\Rational\DOORS\9.4). O caminho do arquivo de configuração deve ser fornecido na entrada de registro logxconfig no DOORS_Server ou usando a opção da linha de comandos ‘-x’ ou ‘-logxconfig’ seguida pelo caminho do arquivo de configuração.
O arquivo xml logging-config de amostra deve ser configurado para incluir um caminho do local da pasta válida para gerar os arquivos de log.
Por exemplo:
<param name="file" value="${LOG_FOLDER_LOCATION}/IBM/DOORS/log/SystemError.log" /> pode ser alterado para <param name="file" value="C:/My Server Log/IBM/DOORS/log/SystemError.log" />
O arquivo logging-config.xml contém basicamente duas seções:
A primeira seção contém uma lista de anexadores que fornece configurações sobre o caminho de arquivo de log, nível de log, tamanho máx. do arquivo, formato e índice máx. de backup para cada um dos arquivos de log.
Há cinco modos de log FATAL < ERROR < WARN < INFO < DEBUG (As informações registradas para cada nível de log serão todas as informações de prioridade igual ou menor das informações registradas).
O criador de log da segunda seção que fornece as configurações no modo de criação de log geral e o conjunto de anexadores a ser ativado para a criação de log.
Para desativar a criação de log configure o nível de prioridade como "desativar".
A tabela a seguir descreve os parâmetros usados no arquivo -config.xml de criação de log:
Nome da Seção | Nome do Parâmetro | Descrição | Valor |
---|---|---|---|
Parâmetros da Seção do Anexador | |||
nome do anexador | Esse é o nome do anexador que será usado posteriormente para descrever que todos os anexadores são ativados. | Nada. Ex: SystemOutAppender | |
arquivo | O arquivo de log é criado no nome do arquivo especificado e no local mencionado neste valor de parâmetro. | Local acessível no sistema. | |
anexar | true: anexar ao arquivo mencionado no parâmetro de arquivo. false: sobrescrever o arquivo mencionado no parâmetro de arquivo | true/false | |
Limite | Esse parâmetro configura o modo de log. | desativar, fatal, erro, aviso, informações, depuração | |
Se o limite for configurado como fatal, ele registrará apenas as informações fatais no arquivo de log. | |||
Se o limite for configurado como erro, ele registrará apenas informações fatais e de erros no arquivo de log | |||
Se o limite for configurado como aviso, ele registrará apenas informações fatais, de erro e de aviso no arquivo de log | |||
Se o limite for configurado como informações, ele será registrado como fatal, erro, aviso e informações no arquivo de log | |||
Se o limite for configurado como depuração, ele registrará todas as informações, isto é, informações fatais, de erro, de aviso, de informações e depuração | |||
Se o limite for configurado como desativar, a criação de log será desativada | |||
MaxFileSize | Esse parâmetro configura o tamanho máximo do arquivo de log e depois que o arquivo de log atingir esse limite ele criará um novo arquivo de log com o nome do arquivo anexando o número incremental | Qualquer coisa com a unidade. Ex: 1000KB | |
MaxBackupIndex | Esse parâmetro configura o número máximo de arquivos criados para o criador de logs e depois que ele atingir esse limite, retrocederá para o arquivo mais antigo e iniciará a sobrescrição nesse arquivo | Qualquer número inteiro | |
Padrão de Conversão | Esse parâmetro especifica o formato no qual as informações são registradas no arquivo de log. | %d{dd MMM yyyy HH:mm:ss:SSS} [%p] %m%n: Inicia com a data | |
Ele inclui basicamente o formato de data e hora e juntamente com isso, ele exibe o tipo de log [modo de log] e o resumo das informações registradas. É possível alterar a sequência dependendo de como deseja ver os logs. | [%p] %m%n %d{dd MMM yyyy HH:mm:ss:SSS}: inicia com o modo de log | ||
parâmetros da seção do criador de logs | |||
prioridade | Isso configurará o nível de modo de criação de log para a criação de log geral. Para desativar a criação de log configure esse valor de parâmetro como "desativar" | desativar, fatal, erro, aviso, informações, depuração | |
referência do anexador | O valor da referência contém o nome dos anexadores definidos nas seções do anexador acima. Dependendo do que todos os anexadores definidos acima precisam para serem ativados para a criação de log necessária para fornecer esses nomes dos anexadores | <referência do anexador ref="DOORSConsoleAppender"/> | |
Para ativar diversos anexadores crie diversas instâncias da tag <referência do anexador>. | <referência do anexador ref="SystemOutAppender"/> |