1.0 Log and Trace Analyzer
1.1 Visualizações
1.2 Importando Logs
1.2.1 Problemas ao Importar Arquivos de Log Remotos
1.2.2 Importando Arquivos de Log no Linux e AIX
1.2.3 Importando o trace.log do WebSphere Application Server
1.2.4 Alguns Arquivos de Log Não Podem Ser Importados
Utilizando o IBM Agent Controller V5
1.2.5 Exceção Sem Memória
1.2.6 Erro de Índice Fora dos Limites ao Incluir o Arquivo de Log
no Assistente para Importar Arquivo de Log no Driver Linux GTK
1.2.7 Os Eventos de Base Comum Mostrados para o Log de Diagnóstico do DB2® não São para Especificação
1.2.8 Erros ao Importar Arquivos de Log Não Exibidos
1.2.9 Limitação ao Importar Arquivos
activity.log do WebSphere Application Server
1.2.10 Limitação ao Importar Arquivos de Log
Gerados em um Código do Idioma Diferente
1.2.11 A Importação Falha com a Mensagem InvocationTargetException
1.2.12 NullPointerException ao Importar um Log Vazio
1.3 Suporte ao Banco de Dados
1.4 Outro
1.4.1 Assistente de Nova Correlação de Log Não
Exibido Adequadamente no Driver Linux GTK
1.4.2 As Modificações Feitas no Nível de Log de um
Plug-in Após o Primeiro Início do Workbench Não São Respeitadas
1.4.3 Problemas ao Descompactar com o Utilitário Descompactar Arquivo ZIP do Windows XP
1.4.4 Travamento ao Criar um Exemplo no
Red Hat Linux v8.0 com a IBM JVM
1.4.5 Restrição do Navegador para Visualização de Arquivos de Log XML de Utilitários de Log
1.4.6 Apenas Bancos de Dados de Análise de Sintomas com Formato TPTP Podem Ser Criados a Partir da Barra de Ferramentas do Navigator do Log e do Menu Pop-up
2.0 Ferramenta de Definição de Perfis
2.1 As Visualizações de Interação de Agente e de Processo
Não São Suportadas na Visualização Diagrama de Seqüência
2.2 O Comando Atualizar Visualizações do Navigator de Traçado de Perfil
Não Funciona para Interações de Rastreio
2.3 O Traçado de Perfil no Windows Utilizando o Sun JDK 1.4.x Pode Ser Finalizado com um Relatório de Erros da Microsoft®
Informações adicionais do leia-me associadas ao Analisador de Log e de Rastreio de TPTP estão disponíveis em Notas sobre o Release V3.3 do TPTP.
Durante a importação de um arquivo de log remoto (Arquivo > Importar... > Arquivo de Log), nenhuma entrada de log é exibida na Visualização de Log após a atualização das Visualizações do Monitor de Traçado de Perfil (Perfil > Atualizar Visualizações) ou uma caixa de diálogo Mensagem de Log é exibida, indicando que o cliente local não iniciou o monitoramento do analisador de log remoto após espera de 30 segundos.
Esse problema é devido à latência da rede e pode ser corrigido, aumentando o tempo que o Agent Controller aguarda o cliente local iniciar a monitoração do analisador de log remoto. Para solucionar esse problema, tente as etapas a seguir:
<Application configuration="default" executable="RemoteLogParserLoader" extends="default" location="%SYS_TEMP_DIR%" path="%JAVA_PATH%"> ... <Parameter position="prepend" value="-Dorg.eclipse.hyades.logging.parsers.maxWaitTimeInMillis=xxxxx"/> ... </Application>em que xxxxx é o tempo máximo de espera, em milissegundos (isto é, maior que 30000).
Algumas importações de arquivos de log não funcionam mesmo nas plataformas Linux e AIX®.
Isso ocorre quando o usuário não possui permissões apropriadas para acessar os arquivos de log. Para resolver esse problema, os arquivos de log devem ser copiados para o diretório home do usuário e importados dele.
1.2.3 Importando o trace.log do WebSphere Application ServerA Correlação Interna é criada quando um arquivo trace.log do WebSphere Application Server é importado.
O usuário não deve excluir essas correlações porque elas contêm informações relacionadas à estrutura interna no agente correspondente.
1.2.4 Alguns Arquivos de Log Não Podem Ser Importados Utilizando o IBM Agent Controller V5Os arquivos de log remotos diferentes do activity.log não podem ser importados utilizando um IBM Agent Controller V5. Ao importar os arquivos de log remotamente, o Agent Controller na máquina remota deve estar no mesmo nível, ou superior, que o Log and Trace Analyzer para Computação Autônoma.
Para solucionar essa limitação, instale o IBM Agent Controller fornecido com o Log and Trace Analyzer na máquina remota.
1.2.5 Exceção Sem MemóriaOs arquivos de log de até 25 MB podem ser importados no espaço de trabalho e abertos no Log and Trace Analyzer. O tempo para abrir o arquivo de log depende do número de registros de log no arquivo e é possível que você obtenha uma exceção "sem memória".
Para solucionar esse problema, utilize o recurso de suporte de log grande.
1.2.6 Erro de Índice Fora dos Limites ao Incluir o Arquivo de Log no Assistente para Importar Arquivo de Log no Driver Linux GTKDurante a importação de um arquivo de log, o erro Índice fora dos limites é emitido quando você tenta clicar em OK no assistente para Incluir Arquivo de Log. Isso ocorre porque o arquivo de log que está sendo incluído não possui uma versão selecionada.
Certifique-se de que uma opção de versão válida esteja selecionada na lista de opções de versão sob a guia Detalhe do assistente para Incluir Arquivo de Log.
Se você importar um log de Diagnóstico do DB2, os Eventos de Base Comum resultantes mostrados no Analisador de Log e de Rastreio não atenderão a uma das especificações de Eventos de Base Comum. Isso ocorre devido a um erro no utilitário db2diag.exe, que é utilizado para converter logs de Diagnóstico do DB2 em Eventos de Base Comum. Isso não deve afetar a operação. Não há uma solução alternativa conhecida até que db2diag.exe seja corrigido.
Nenhuma validação é feita pelo Analisador de Log e de Rastreio quanto ao tipo de arquivo de log que está sendo importado. Ao importar um arquivo de log, lembre-se de escolher o tipo e a versão corretos do log para o arquivo de log que está sendo importado. Se ocorrer um problema durante a importação, nenhum registro será mostrado (ou serão mostrados registros incorretos) na Visualização de Log, e será exibida uma mensagem de erro. Para obter informações mais detalhadas sobre o erro, verifique os detalhes da caixa de diálogo do erro ou tente consultar o arquivo .metadata\.plugins\org.eclipse.hyades.logging.adapter\hgla.log, se ele existir no diretório do espaço de trabalho. Esse arquivo pode conter informações sobre erros ocorridos durante a análise do arquivo de log.
Se ocorrer um erro durante a importação de um arquivo de log, será exibida uma mensagem de erro e nenhum registro será mostrado na Visualização de Log ou serão mostrados dados incorretos nos registros da Visualização de Log.
Ao importar arquivos de log de atividades do WebSphere Application Server de ou em máquinas não em inglês, o analisador de arquivo de log baseado em regras não mapeia com êxito os dados do registro de log em um Evento de Base Comum. Em vez disso, alguns dados do registro de log podem aparecer no campo incorreto do Evento de Base Comum.
Para solucionar esse problema, ao importar arquivos de log de atividades do WebSphere Application Server de ou em máquinas não em inglês, utilize o analisador estático de arquivo de log.
Ao importar arquivos de log que contenham timestamps em um código do idioma diferente daquele em que o Log and Trace Analyzer está sendo executado, algumas vezes o analisador de arquivo de log baseado em regras não analisa o timestamp e outros dados do registro de log corretamente. Por exemplo, ao importar um arquivo de log de acesso ao IBM HTTP Server em inglês no Analisador de Log e de Rastreio que está sendo executado em uma máquina em japonês, os valores de creationTime nos Eventos de Base Comum resultantes terão um valor zero e o campo de mensagem do Evento de Base Comum ficará em branco.
Para solucionar esse problema, ao importar arquivos de log que contenham timestamps em um código do idioma diferente daquele da máquina atual, utilize um analisador de arquivo de log estático, se disponível.
Se o Log and Trace Analyzer não foi instalado corretamente e alguns de seus arquivos estiverem ausentes, a importação de um arquivo de log poderá falhar com a seguinte mensagem de log:
java.lang.reflect.InvocationTargetException
Para solucionar esse problema, reinstale o Log and Trace Analyzer. Nota: Ao instalar no Windows XP, não utilize o utilitário descompactar arquivo zip do Windows XP. Consulte Problemas ao Descompactar com o Utilitário de Descompactação de Arquivo ZIP do Windows XP a seguir para obter mais detalhes.
Quando um log vazio for importado ou quando um filtro de importação for utilizado para selecionar todos os eventos de log, a Visualização de Log aparecerá vazia e um NullPointerException (em XMLLoader.endElement) poderá ser emitido. Verifique o arquivo de log ou tente um filtro diferente que permita que alguns eventos sejam carregados.
N/D
No assistente Nova Correlação de Log, apenas a lista Logs Disponíveis é mostrada e a lista está vazia. Isso ocorre porque apenas a parte esquerda da página do assistente é exibida.
Para solucionar esse problema, tente redimensionar a página do assistente para que a lista Logs Selecionados e os botões de ação sejam mostrados. Uma solução alternativa é selecionar os arquivos de log para correlação na visualização Navegador de Logs, antes de clicar no botão Nova Correlação de Log.
Se você modificar o nível de log de um plug-in em seu arquivo plugin.xml (por meio dos pontos de extensão com.ibm.etools.common.logging.commonLoggingOptions ou com.ibm.etools.logging.util.loggingOptions) após o primeiro início de um workbench, a alteração não será respeitada em ativações subseqüentes do workbench. O nível de log especificado no arquivo plugin.xml do plug-in é armazenado em cache pelo tempo de execução do Eclipse no primeiro início do workbench. Inícios subseqüentes do workbench utilizam o valor armazenado em cache do nível de log do plug-in apesar da modificação no arquivo plugin.xml.
Uma solução alternativa para esse problema é reiniciar o workbench com o argumento da linha de comando -clean. Essa opção limpará os caches utilizados para armazenar os dados de resolução de dependência de pacote configurável e de registro do Eclipse e forçará o Eclipse a reinicializar esses caches. Inclua a opção após eclipse.exe no <diretório de instalação do workbench>\eclipse\ac.bat (Windows) ou <diretório de instalação do workbench>/eclipse/ac.sh (Linux). Como alternativa, você pode modificar o nível de log do plug-in na página de preferências de Log (Janela > Preferências > Log) e reiniciar o workbench.
Ao instalar o Log and Trace Analyzer no Windows XP, ocorrem problemas ao descompactar o arquivo de tempo de execução do Log and Trace Analyzer com o utilitário descompactar arquivo ZIP nativo do Windows XP. Alguns diretórios e arquivos não serão descompactados. Como resultado desse problema, alguns tipos de arquivo de log não podem ser importados utilizando o Analisador de Log e de Rastreio.
Para solucionar esse problema, ao instalar no Windows XP, utilize um outro utilitário de descompactação de arquivo ZIP, como WinZip ou UnZip.
Ao criar um exemplo no Log and Trace Analyzer utilizando o assistente de Criação de Exemplo (Novo > Exemplo), ocorre travamento do Workbench. Isso ocorre quando o assistente de Criação de Exemplo tenta abrir o arquivo readme.html como parte das etapas de criação. Esse problema é encontrado no Red Hat Linux v8.0 com a IBM JVM e é um erro do SWT ( https://bugs.eclipse.org/bugs/show_bug.cgi?id=76515).
Para solucionar esse problema, tente incluir -Xj9 como um argumento de JVM no ac.sh para ativar a utilização da IBM J9 JVM. (Por exemplo, ./eclipse -vmargs -Xj9 -Xmx500m). Para obter informações adicionais sobre como executar o SWT no Red Hat Linux v8.0, verifique as Perguntas Mais Freqüentes do SWT (http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-swt-home/faq.html).
Nota: Conforme indicado na tabela de plataformas de referência do Eclipse (http://www.eclipse.org/eclipse/development/eclipse_project_plan_3_0.html#TargetOperatingEnvironments), apenas os sistemas Linux a seguir são suportados: versão 2.2.1 do toolkit de widget GTK+ e bibliotecas associadas (GLib, Pango); o visualizador de HTML do SWT requer o Mozilla 1.4GTK2. Para Motif em outros sistemas Linux: Abra o Motif 2.1 (incluído); o visualizador de HTML do SWT requer o Mozilla 1.4GTK2.
O arquivo CommonBaseEvents.log gerado pelo workbench é melhor visualizado com a utilização das Visualizações de log fornecidas pelas ferramentas de Log. Como alternativa, você pode utilizar um navegador ativado para XML para visualizar o formato do documento XML do arquivo de log (ou seja, o arquivo chamado CommonBaseEvents.log_Viewer.xml no subdiretório workspace\.metadata do diretório de instalação). Esse arquivo somente pode ser visualizado com o Microsoft Internet Explorer V6.0.28 e versão mais recente.
Por causa de uma limitação TPTP, os usuários não podem criar ambos os tipos de bancos de dados de análise de sintomas a partir do botão da barra de ferramentas do navigator do log e do menu de contexto. Uma solução alternativa é selecionar Arquivo > Novo > Outro > Traçado de Perfil e Log no menu do workbench e escolher o tipo de banco de dados de análise de sintomas que você deseja criar.
A visualização Interações de Agente e a visualização Interações de Processo não são suportadas a partir da visualização Diagrama de Seqüência para arquivos de log.
Atualmente não existe solução alternativa para esse problema.
2.2 O Comando Atualizar Visualizações do Navigator de Traçado de Perfil Não Funciona para Interações de RastreioO Comando Atualizar Visualizações do Navegador de Definição de Perfis Não Funciona para Interações de Rastreio. No entanto, as interações de rastreio são atualizadas independente e automaticamente em intervalos regulares.
Uma solução alternativa é selecionar um outro nó na árvore de Definição de Perfis e selecionar novamente o nó anterior.
2.3 O Traçado de Perfil no Windows utilizando o Sun JDK 1.4.x Pode Ser Finalizado com um Relatório de Erros da MicrosoftDefeito do Bugzilla: 103058
O traçado de perfil ou o aplicativo é finalizado com a mensagem "java.exe encontrou um problema e precisa ser fechado. Desculpe-nos o transtorno." A mensagem contém informações e opções para envio de um relatório de erros para a Microsoft. Consulte o Bugzilla 103058 para obter uma captura de tela da mensagem.
Esse problema foi observado em diversos modos: Análise de Tempo (com ou sem "Mostrar Instâncias"), Análise de Memória e em combinações desses modos. Uma solução alternativa para o problema é executar novamente o traçado de perfil ou o aplicativo com o JIT desativado, ou seja, fornecendo "-Djava.compiler=NONE" como um argumento JVM. O problema foi encontrado no SUN JDK 1.4.2_08-b03 build para Windows.
Retornar para o arquivo leia-me principal
©Copyright IBM Corporation 2000, 2005. Todos os Direitos Reservados.