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
1.2.10 Limitação ao Importar Arquivos de Log Gerados em um Código de 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 a Banco de Dados
1.4 Outros
1.4.1 Assistente para Nova Correlação de Log Não Exibido Corretamente no Driver Linux GTK
1.4.2 As Modificações 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 Arquivos com o Utilitário Unzip do Windows XP
1.4.4 Travamento ao Criar um Exemplo no Red Hat Linux v8.0 com o IBM JVM
1.4.5 Restrição do Navegador para Visualizar os Arquivos de Log XML dos Utilitários de Log
1.4.6 Apenas Bancos de Dados de Análise de Sintomas de Formato TPTP Podem ser Criados a Partir do Menu Pop-up e da Barra de Ferramentas do Navegador de Log
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 Navegador 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 leia-me adicionais associadas ao TPTP Log and Trace Analyzer estão disponíveis nas Notas sobre o release do TPTP V3.3.
Ao importar um arquivo de log remoto (Arquivo > Importar... > Arquivo de Log), nenhuma entrada de log é exibida na Visualização do Log após a atualização das Visualizações do Monitor de Traçado de Perfil (Perfil > Atualizar Visualizações) ou um diálogo Mensagem de Log é exibido, indicando que o cliente local não iniciou a monitoração 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 V5 IBM Agent Controller. 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ória"Os 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".
A solução alternativa para esse problema é utilizar o recurso de suporte a 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 Base Comuns resultantes mostrados no Log and Trace Analyzer violam algumas das especificações de Eventos Base Comuns. Isso ocorre devido a um erro no utilitário db2diag.exe que é utilizado para converter logs de Diagnóstico do DB2 em Eventos Base Comuns. Isso não deve afetar a operação. Não existe uma solução alternativa conhecida até que db2diag.exe seja corrigido.
Nenhuma validação é feita pelo Log and Trace Analyzer sobre o tipo de arquivo de log que está sendo importado. Ao importar um arquivo de log, assegure-se de que o tipo e versão corretos do log sejam escolhidos para o arquivo de log que será importado. Se ocorrer um problema durante a importação, nenhum registro ou registros incorretos serão mostrados na Visualização de Log e uma mensagem de erro será exibida. Para obter informações mais detalhadas sobre o erro, visualize os detalhes no diálogo de erros ou tente procurar o arquivo .metadata\.plugins\org.eclipse.hyades.logging.adapter\hgla.log e verificar se ele existe no diretório workspace. Esse arquivo pode conter informações sobre erros ocorridos durante a análise do arquivo de log.
Quando ocorre um erro ao importar um arquivo de log, uma mensagem de erro é exibida e nenhum registro é mostrado na Visualização do Log ou dados incorretos são mostrados nos registros na Visualização do 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 time stamps 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 time stamp e outros dados do registro de log corretamente. Por exemplo, ao importar um arquivo de log de acesso do IBM HTTP Server em inglês para o Log and Trace Analyzer que está sendo executado em uma máquina em japonês, os valores de creationTime nos Eventos Base Comuns resultantes terão um valor zero e o campo de msg do Evento Base Comum ficará em branco.
Para solucionar esse problema, ao importar arquivos de log que contenham time stamps 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 arquivos com o utilitário unzip do Windows XP, a seguir, para obter detalhes adicionais.
Quando um log vazio é importado ou quando é utilizado um filtro de importação que filtra todos os eventos do log, a Visualização de Log aparecerá vazia e uma NullPointerException (no XMLLoader.endElement) pode ser emitida. Verifique o arquivo de log ou tente um filtro diferente que permitirá o carregamento de alguns eventos.
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 de linha de comandos -clean. Essa opção limpará as caches utilizadas para armazenar resolução de dependência de pacote configurável e dados de registro de extensão do eclipse e forçar o Eclipse a reinicializar essas caches. Inclua a opção depois de eclipse.exe em <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, é possível 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 são descompactados. Como resultado desse problema, alguns tipos de arquivo de log não podem ser importados utilizando o Log and Trace Analyzer.
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 utilizando as Visualizações de Log fornecidas pelas Ferramentas de Log. Alternativamente, é possível utilizar um navegador ativado para XML para visualizar o formato do documento XML do arquivo de log (isto é, o arquivo denominado CommonBaseEvents.log_Viewer.xml no subdiretório workspace\.metadata do diretório de instalação). Esse arquivo pode ser visualizado apenas utilizando-se o Microsoft Internet Explorer V6.0.28 e superiores.
Devido a uma limitação do TPTP, os usuários não podem criar os dois tipos de bancos de dados de análise de sintomas a partir do botão da barra de ferramentas do navegador de 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 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 Navegador 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. Entretanto, as interações de rastreio são atualizadas 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 pela inconveniência." A mensagem contém informações e opções para submeter um relatório de erros para a Microsoft. Consulte 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 nas combinações desses modos. Uma solução alternativa para o problema é executar novamente o traçado de perfil ou o aplicativo com o JIT desligado, isto é, fornecendo "-Djava.compiler=NONE" como um argumento do JVM. O problema foi encontrado com o build 1.4.2_08-b03 do SUN JDK para Windows.
Retornar para o arquivo leia-me principal
©Copyright IBM Corporation 2000, 2005. Todos os Direitos Reservados.