É possível configurar limites no tamanho de 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. Este arquivo de configuração está sendo monitorado no intervalo de 60 segundos e as mudanças nesse arquivo refletirão dentro deste momento.
O servidor Rational DOORS continua a suportar o estilo mais antigo de criação de log que pode ser ativada usando os comutadores da linha de comandos -logfile (-l) (Consulte Comutadores da linha de comandos Comutadores de Linha de Comandos para o Servidor de Banco de Dados para o servidor de banco de dados Rational DOORS.
As informações que devem ser registradas nos arquivos de log são controladas pelo arquivo de configuração baseado em XML. Por padrão, o arquivo de amostra 'logging-config.xml' está localizado no caminho raiz do DOORS (ou seja, C:\Program Files\IBM\Rational\DOORS\9.5). O caminho de arquivo de configuração deve ser fornecido na entrada do registro logxconfig no DOORS_Server ou usando a opção da linha de comandos ‘-x’ ou ‘-logxconfig’ seguida pelo caminho de 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"/> |