É possível utilizar os arquivos de log para resolver problemas que ocorrem no servidor de banco de dados do IBM® Rational DOORS, cliente e servidor de interoperação e no servidor Rational DOORS Web Access e message broker.
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
- Criação de log de transações do servidor de banco de dados
- Criação de log de transações do cliente
- O servidor do Rational DOORS Web Access, servidor de interoperação e a criação de log do message broker
- Criação de log de mensagem do aplicativo e o utilitário de coleta de dados
Log de diagnóstico para o cliente do Rational 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 Rational DOORS
O servidor de banco de dados fornece um recurso de criação de log que pode registrar a atividade em níveis diferentes de detalhes. 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 ativar a criação de log do servidor, verifique com o IBM Software Support 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 estiver ativada e você tiver reproduzido o comportamento, envie o arquivo de log gerado para o Suporte de Software IBM e desative a criação de log, conforme descrito no tópico da ajuda de log do servidor.
Ativando a criação de log de transações no servidor de banco de dados do Rational DOORSNota: Ativar a criação de log do banco de dados somente para períodos de diagnóstico limitados. Para desativar a criação de log sem encerrar seu servidor, configure o valor do nível de log para 0 utilizando o comando dbadmin -serverlogging; por exemplo, dbadmin -d 36677@IBMEDSERV -serverlogging 0.
Criação de log do cliente para o Rational DOORS
É possível ativar um recurso de criação de log para resolver problemas de conexão com o servidor de banco de dados. A partir do computador com o problema, abra o cliente
Rational DOORS e execute um comando DXL para ativar a criação de log do cliente e gerar um arquivo de log local. Ao reproduzir o comportamento, envie o arquivo de log gerado para o IBM Software Support e desative a criação de log, conforme descrito no tópico da ajuda de criação de log do cliente.
Ativando a criação de log da transação no cliente Rational DOORS Rational DOORS
Criação de log para o servidor de interoperação do Rational DOORS e o servidor Rational DOORS Web Access e o message broker
Por padrão, os componentes do Rational DOORS Web Access fornecem os 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 alto nível.
Para diagnosticar problemas com sua instalação, você pode ativar os componentes para execução no modo de depuração.
No nível de Depuração, os registros de log contêm eventos informativos mais detalhados que são
úteis para depurar um aplicativo.
O servidor de interoperação do
Rational DOORS e o servidor
Rational DOORS Web Access e o message broker fornecem os registros de log do nível de Informações nestes diretórios:
- DWA_INSTALL_DIR\broker\data\activemq.log
- DWA_INSTALL_DIR\server\festival\logs
Se você precisar de informações mais detalhadas para diagnosticar problemas, ative a criação de log do nível de Depuração. Para configurar a criação de log aprimorada, consulte os links relacionados para o Rational DOORS Web Access. Há vários arquivos de log no diretório de logs.
Para diagnosticar um problema, comece com estes arquivos:- festival.log contém todas as mensagens de log gravadas pelo servidor do Rational DOORS Web Access.
- request.log é utilizado para verificar se as solicitações são realmente recebidas.
Isso é útil ao lidar com os processos que se estendem por vários aplicativos.
- response.log é utilizado para confirmar se as respostas foram retornadas ao aplicativo de chamada. Isso é útil para confirmar que a solicitação recebida foi concluída e retornou um resultado.
As mensagens de erro são gravadas em logs diferentes dependendo de como são originadas.
A maioria dos erros é gravada em exception.log, mas os arquivos de log de outros erros também podem ser utilizados.
Há 3 arquivos de log de erro:- 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 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 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
Rational 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 3 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 é o registro de informações coletadas automaticamente sobre o sistema operacional, as informações do produto Rational DOORS, os arquivos dinâmicos da biblioteca vinculada suportados (.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 Rational DOORS:
- Efetuando login no Rational DOORS Web Access: