É possível usar arquivos de log para solucionar problemas que ocorrem no servidor de banco de dados do IBM® Engineering Requirements
Management DOORS
(DOORS), no cliente, no servidor de interoperação e no servidor e message broker do IBM
Engineering Requirements Management DOORS - Web
Access
(DWA).
Dependendo de sua configuração, estas ferramentas de criação de log estão disponíveis para diagnosticar um comportamento inesperado:
- Log de diagnóstico para o cliente
- Log de transações do servidor de banco de dados
- Log de transações do cliente
- Logs do servidor DWA, do servidor de interoperação e do message broker
- Logs de mensagem do aplicativo e utilitário de coleta de dados
Log de diagnóstico para o cliente do DOORS
O cliente possui um mecanismo de criação de log integrado que registra quaisquer eventos incomuns integrado que ocorram como resultado de um erro interno durante a sessão. Para visualizar o log de diagnóstico, clique em . Se necessário, é possível copiar as informações da janela de saída e salvá-las como um arquivo de texto local.
Para gravar um log mais detalhado, você também pode ativar a criação de log baseada em transação extra no cliente e no servidor de banco de dados. Para obter mais informações, consulte as próximas seções.
Criação de log do servidor de banco de dados para o DOORS
O servidor de banco de dados fornece criação de log que pode registrar a atividade em diferentes níveis
de detalhe. Por padrão, essa criação de log não será ativada porque ela pode aumentar o uso do processador para transações e reduzir a velocidade de conclusão de uma função solicitada ou degradar o desempenho geral. Os detalhes no log de saída são baseados no valor do nível de log que você configurou. Os valores de intervalo de nível 1, o mais conciso, para o nível 6, o mais detalhado. Antes de ligar a criação de log do servidor,
verifique com o Suporte para determinar qual nível é necessário para resolver o problema.
Tabela 1. Níveis de criação de logNível de log |
Detalhes de informação de log |
1 |
Conexões, desconexões e pacotes de problema |
2 |
Conexões, desconexões e tipos de pacote |
3 |
Conexões, desconexões, tipos de pacotes e argumentos do pacote em formato compacto |
4 |
Conexões, desconexões, tipos de pacotes e argumentos do pacote em formato detalhado |
5 |
Somente operações de cache de dados |
6 |
Conexões, desconexões, operações de cache de dados, tipos de pacotes e argumentos do pacote em formato detalhado |
Para ajudar a identificar um erro não especificado, pode ser necessário iniciar a criação de log no nível 6 para capturar todas as atividades. Depois que a criação de log do banco de dados for ativada e você reproduzir o comportamento, envie o
arquivo de log gerado ao Suporte e desative a criação de log, conforme descrito no tópico da ajuda
Ativando um log de transações no servidor de banco de dados do DOORS.
Nota: Para evitar a degradação de desempenho, ative a criação de log do banco de dados apenas
por períodos de diagnóstico limitados.
Criação de log do cliente para o DOORS
É possível ativar a criação de log para solucionar problemas de conexão com o servidor de banco de dados. O
log não contém dados do módulo ou objeto que possam ter informações sensíveis ao conteúdo; ele
contém apenas os detalhes das transações de arquivos. A partir do computador com o problema, abra o cliente DOORS e execute um comando DXL para ativar a criação de log do cliente e gerar um arquivo de log local. Depois de reproduzir
o comportamento, envie o arquivo de log gerado ao Suporte e desative a criação de log, conforme descrito no
tópico da ajuda de criação de log do cliente Ativando um log de transações no cliente DOORS.
Criação de log para o servidor de interoperação do DOORS e o servidor e o message broker do DWA
Por padrão, os componentes do DWA fornecem registros de log de nível de informações. No nível de Informações, os registros de log contêm
mensagens informativas que descrevem o progresso do aplicativo em um alto nível. Para incluir
mais detalhes, ative os componentes a serem executados no nível de depuração.
O servidor de interoperação do
DOORS e o servidor e message broker do
DWA fornecem registros de log de nível de informações nestes diretórios:
- DWA_INSTALL_DIR\broker\data\activemq.log
- DWA_INSTALL_DIR\server\festival\logs
Para gerar informações detalhadas com a criação de log de nível de depuração, consulte os links relacionados para a criação de log do
DWA. Há vários arquivos de log no diretório de logs. Para diagnosticar um problema,
inicie com estes arquivos:
- festival.log contém cada mensagem de log gravada pelo servidor DWA.
- request.log é usado para verificar se as solicitações são recebidas. Esse log é útil
para diagnosticar processos que abrangem vários aplicativos.
- response.log é usado para confirmar se as respostas foram retornadas ao
aplicativo de chamada. Esse log é útil para confirmar se a solicitação recebida foi concluída e retornou um resultado.
As mensagens de erro são gravadas em diferentes arquivos de log dependendo de como elas são originadas. A maioria dos erros é
gravada em
exception.log, mas também é possível usar os outros arquivos do log de erros. Os
três arquivos do log de erros são:
- exception.log
- error_view.log
- error_misc.log
A criação de log de mensagem do aplicativo e o utilitário coletor de dados
A criação de log da mensagem do aplicativo apresentada da Versão 9.4 que é baseada nos serviços de criação de log Apache log4cxx. É possível executar estas tarefas sem reiniciar o servidor:
- 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
- Mudar o nível de log e as configurações de log
O arquivo de configuração é monitorado a cada 60 segundos para detectar as mudanças.
Existem cinco níveis de criação de log que listados do mais baixo para o mais alto são Depurar, Informações, Aviso, Erro e Fatal. Cada nível registra 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.
Versões anteriores do
DOORS requeriam a reunião iterativa manual de informações de ambiente e recursos, juntamente com os logs de diagnóstico durante a fase inicial de resolução de problemas. Com a introdução do aplicativo de sistema de mensagens na versão 9.4, é possível executar uma ferramenta de coleta de dados da linha de comandos para coletar logs que são gerados de acordo com as instruções de configuração do aplicativo de sistema de mensagens. A ferramenta de coleta de dados também cria três arquivos de texto:
- readme.txt fornece clareza sobre o uso quando o problema ocorrer.
- problemDetails.txt é um arquivo de modelo no qual você pode digitar manualmente os detalhes do problema.
- collectedInformation.txt é um registro de informações coletadas automaticamente
sobre o sistema operacional, informações do produto DOORS,
arquivos da biblioteca de vínculo dinâmico suportada, (.DLL) e o arquivo
config.ini.
Para obter informações sobre a configuração de arquivos de log, consulte estes tópicos:
- Efetuando login no DOORS:
- Efetuando login no DWA: