Log and Trace Analyzer v6.0.1 - LEIA-ME

Problemas e Soluções Alternativas Conhecidos

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 Log de Rastreio do WebSphere Application Server
1.2.4 Alguns Arquivos de Log Não Podem Ser Importados com o Uso do IBM Agent Controller V5
1.2.5 Exceção de Falta de 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 do Common Base Mostrados no Log do Diagnóstico do DB2 Não São para Especificação
1.2.8 Os Erros de Importação dos Arquivos de Log Não São Exibidos
1.2.9 Limitação ao Importar os Arquivos activity.log do WebSphere
1.2.10 Limitação ao Importar os Arquivos de Log Criados em um Local Diferente
1.2.11 Importando Falhas com a Mensagem InvocationTargetException
1.2.12 NullPointerException ao Importar um Log Vazio
1.3 Suporte do Banco de Dados
1.4 Outro
1.4.1 Novo Assistente de Correlação de Log Não Exibido Adequadamente no Driver Linux GTK
1.4.2 As Modificações em um Nível de Log do Plug-in após Iniciar pela Primeira Vez o Workbench Não São Respeitadas
1.4.3 Problemas ao Descompactar Arquivos ZIP com o Utilitário de Descompactação de Arquivos 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 Visualização dos Arquivos de Log em XML do Logging Utilities
1.4.6 Somente os Bancos de Dados de Análise de Sintomas no Formato TPTP Podem Ser Criados a partir da Barra de Ferramentas e do Menu Pop-up do Log Navigator
2.0 Ferramenta de Traçado de Perfil
2.1 As Visualizações do Agente e da Interação do Processo Não São Suportadas na Visualização do Diagrama de Seqüência
2.2 O Comando para Atualizar Visualizações do Profiling Navigator Não Funciona para as Interações de Rastreio
2.3 O Traçado de Perfil no Windows que Utiliza o Sun JDK 1.4.x Pode Terminar com um Relatório de Erros da Microsoft

As Informações Adicionais do Leia-me Associadas ao TPTP Log and Trace Analyzer Estão Disponíveis em Notas sobre o Release TPTP V3.3.


1.0 Log and Trace Analyzer

1.1 Visualizações

N/D

1.2 Importando Logs

1.2.1 Problemas ao importar arquivos de log remotos

Ao importar um arquivo de log remoto (File > Import... > Log File), nenhuma entrada de log será exibida na Visualização de log após a atualização das Visualizações do Monitor de Traçado de Perfil (Profile > Refresh Views) ou um diálogo de Mensagem de Log é exibido ao especificar que o cliente local não iniciou o monitoramento do analisador de log remoto após aguardar 30 segundos.

Esse problema se dá devido ao tempo de espera da rede e pode ser corrigido ao aumentar o tempo que o Agent Controller aguarda pelo cliente local para iniciar o monitoramento do analisador de log remoto. Para solucionar esse problema, tente executar as seguintes etapas:

  1. Tente importar o arquivo de log novamente.
  2. Se os sintomas persistirem, inclua a entrada a seguir no aplicativo remoto RemoteLogParserLoader na configuração do Agent Controller (isto é, <Agent Controller's installation directory>/plugins/com.ibm.etools.logging.parsers/config/pluginconfig.xml):
      
    <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>
    
    onde xxxxx é o tempo de espera máximo em milissegundos (isto é, maior do que 30000).
  3. Uma vez feita a atualização, reinicie o Agent Controller e tente importar o arquivo de log novamente.

1.2.2 Importando os arquivos de log no Linux e AIX

Algumas importações de arquivos de log não funcionam de maneira nenhuma nas plataformas Linux e AIX.

Isso ocorre quando o usuário não tem as permissões adequadas para acessar os arquivos de log. Para resolver esse problema, os arquivos de log devem ser copiados no diretório inicial do usuário e importados a partir dele.

1.2.3 Importando o log de rastreio do WebSphere Application Server

Uma Correlação Interna é criada quando um arquivo trace.log do WebSphere Application Server é importado.

O usuário não deve apagar essas correlações uma vez que elas contêm informações relacionadas à estrutura interna do agente correspondente.

1.2.4 Alguns arquivos de log não podem ser importados com o uso do IBM Agent Controller V5

Os arquivos de log remotos diferentes de activity.log não podem ser importados com o uso do IBM Agent Controller V5. Ao importar os arquivos remotamente, o Agent Controller na máquina remota deve estar em nível igual ou superior do Log and Trace Analyzer para a Computação Autônoma.

Para solucionar essa limitação, instale o IBM Agent Controller enviado com o Log and Trace Analyzer na máquina remota.

1.2.5 Exceção de falta de memória

Os arquivos de log de até 25MB podem ser importados para o espaço de trabalho e abertos no Log and Trace Analyzer. O período de tempo para abrir o arquivo de log depende do número de registros de log no arquivo e pode ocorrer uma exceção de "falta de memória".

Para solucionar esse problema, utilize o amplo recurso de suporte ao log.

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 GT

Durante a importação de um arquivo de log, Erro de índice fora dos limites aparece ao tentar clicar em OK no assistente Incluir arquivo de log. Isso ocorre devido ao fato de o arquivo de log que está sendo incluído não ter uma versão selecionada.

Certifique-se de que uma opção de versão válida é selecionada na lista de versões no menu suspenso na guia Detalhe do assistente Incluir arquivo de log.

1.2.7 Os eventos do Common Base mostrados no log do Diagnóstico do DB2 não são para especificação

Se você importar um log do Diagnóstico do DB2, os Eventos do Common Base resultantes mostrados no Log and Trace Analyzer interromperão algumas das especificações de Eventos do Common Base. Isso ocorre devido a um erro no utilitário db2diag.exe que é utilizado para converter os logs do Diagnóstico do DB2 em Eventos do Common Base. Isso não deve afetar a operação. Não há uma solução alternativa conhecida até que o db2diag.exe seja corrigido.

1.2.8 Nenhuma validação foi feita pelo Log and Trace Analyzer quanto ao tipo de arquivo de log que está sendo importado

Nenhuma validação foi feita pelo Log and Trace Analyzer quanto ao tipo de arquivo de log que está sendo importado. Ao importar um arquivo de log, certifique-se de que o tipo e a versão de log corretos são escolhidos para o arquivo de log que está sendo importado. Se ocorrer um problema durante a importação, não será mostrado nenhum registro ou registro incorreto na Visualização de log e uma mensagem de erro será exibida. Para obter informações mais detalhadas sobre o erro, veja os detalhes do diálogo de erro ou tente procurar no arquivo .metadata\.plugins\org.eclipse.hyades.logging.adapter\hgla.log, se ele existir no diretório de espaço de trabalho. Esse arquivo pode conter informações sobre erros que ocorreram durante a análise do arquivo de log.

Se ocorrer um erro durante a importação do arquivo de log, será exibida uma mensagem de erro e nenhum registro será mostrado na Visualização de log ou dados incorretos serão mostrados nos registros na Visualização de log.

1.2.9 Limitação ao importar os arquivos activity.log do WebSphere

Ao importar os arquivos de log de atividades do WebSphere Application Server de ou para as máquinas que não estejam configuradas em inglês, o analisador de arquivo de log baseado nas regras não mapeiam com sucesso os dados de registro de log em um Evento do Common Base. Em vez disso, alguns dados do registro de log podem aparecer no campo incorreto do Evento do Common Base.

Para solucionar esse problema, ao importar os arquivos de log de atividades do WebSphere Application Server de ou para máquinas que não esteja configuradas em inglês, utilize o analisador de arquivo de log estático.

Limitação ao importar os arquivos de log criados em um local diferente

Ao importar arquivos de log que contenham timestamps em um local diferente do local que o Log and Trace Analyzer está sendo executado, o analisador de arquivo de log baseado em regras, às vezes, não analisa o timestamp e outros dados do registro de log corretamente. Por exemplo, ao importar um arquivo de log de acesso em inglês do IBM HTTP Server para o Log and Trace Analyzer que está sendo executado em uma máquina configurada em japonês, os valores de creationTime nos Eventos resultantes do Common Base terão um valor de zero e o campo de msg de Evento do Common Base ficará em branco.

Para solucionar esse problema, ao importar arquivos de log que contêm timestamps em um local diferente do local atual da máquina, utilize um analisador de arquivo de log estático, se disponível.

1.2.11 Importando falhas com a mensagem InvocationTargetException

Se o Log and Trace Analyzer não tiver sido instalado corretamente e alguns de seus arquivos estiverem faltando, a importação de um arquivo de log pode 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 de descompactação de arquivo ZIP nativo do Windows XP. Consulte Problemas ao descompactar arquivos ZIP com o utilitário de descompactação de arquivos do Windows XP, abaixo, para obter detalhes adicionais.

1.2.12 NullPointerException ao importar um log vazio

Quando um log vazio é importado ou quando um filtro de importação é utilizado nesses filtros fora de todo os eventos de log, a Visualização de Log aparecerá vazia e um NullPointerException (no XMLLoader.endElement) pode ser emitido. Verifique o arquivo de log ou tente um filtro diferente que permitirá que alguns eventos sejam carregados.

1.3 Suporte do Banco de Dados

N/D

1.4 Outro

1.4.1 Assistente de Nova Correlação de Log não exibido adequadamente no driver Linux GTK

No assistente Nova Correlação de Log, somente a lista de Logs Disponíveis é mostrada, e a lista está vazia. Isso ocorre devido ao fato de que somente a parte esquerda da página do assistente é exibida.

Para solucionar esse problema, tente redimensionar a página do assistente para ter a lista de Logs Selecionados e os botões de ação mostrados. Uma solução alternativa é selecionar os arquivos de log para a correlação na visualização Navegador de Logs antes de clicar no botão Nova Correlação de Log.

1.4.2 As modificações em um nível de log do plug-in após iniciar pela primeira vez o workbench não são respeitadas

Se você modificar um nível de log do plug-in em seu arquivo plugin.xml (via os pontos de extensão com.ibm.etools.common.logging.commonLoggingOptions ou com.ibm.etools.logging.util.loggingOptions) após iniciar pela primeira vez um workbench, a alteração não será respeitada nas ativações subseqüentes do workbench. O nível de log especificado no arquivo plugin.xml do plug-in está em cache pelo tempo de execução do Eclipse ao iniciar pela primeira vez o workbench. As inicializações subseqüentes do workbench utilizam o valor em cache do nível de log do plug-in apesar da modificação do arquivo plugin.xml.

Para solucionar esse problema, reinicie o workbench com o argumento de linha de comando -clean. Essa opção limpará as caches utilizadas para armazenar a resolução de dependência do pacote configurável e os dados de registro da extensão do eclipse e forçará o Eclipse a reinicializar suas caches. Inclua a opção após o eclipse.exe em <workbench installation directory>\eclipse\ac.bat (Windows) ou em <workbench installation directory>/eclipse/ac.sh (Linux). Alternativamente, você pode modificar o nível de log do plug-in na página de preferências de Log (Window > Preferences > Logging) e reiniciar o workbench.

1.4.3 Problemas ao descompactar arquivos ZIP com o utilitário de descompactação de arquivos do Windows X

Ao instalar o Log and Trace Analyzer no Windows XP, há problemas ao descompactar o arquivo de tempo de execução do Log and Trace Analyzer com o utilitário nativo de descompactação de arquivos ZIP 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 com o uso do Log and Trace Analyzer.

Para solucionar esse problema, ao fazer a instalação no Windows XP, utilize outro utilitário de descompactação de arquivo, como WinZip ou UnZip.

1.4.4 Travamento ao criar um exemplo no Red Hat Linux v8.0 com o IBM JVM

Ao criar um exemplo no Log and Trace Analyzer utilizando o assistente Criação de Exemplo (New > Example), o Workbench trava. Isso acontece quando o assistente 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 o IBM JVM, e é um erro SWT (https://bugs.eclipse.org/bugs/show_bug.cgi?id=76515).

Para solucionar esse problema, tente incluir -Xj9 como um argumento do JVM no ac.sh para ativar utilizando o 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 o SWT FAQ (http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-swt-home/faq.html).

Nota: Conforme apresentado na tabela de plataformas de referência do Eclipse (http://www.eclipse.org/eclipse/development/eclipse_project_plan_3_0.html#TargetOperatingEnvironments), somente os sistemas Linux a seguir são suportados: versão 2.2.1 do GTK+ widget toolkit e bibliotecas associadas (GLib, Pango); o visualizador SWT HTML requer o Mozilla 1.4GTK2. Para Motif em outros sistemas Linux: Abra o Motif 2.1 (incluso); o visualizador SWT HTML requer o Mozilla 1.4GTK2.

1.4.5 Restrição do navegador para visualização dos arquivos de log XML do Common Logging

O arquivo CommonBaseEvents.log criado pelo workbench é melhor visualizado com o uso das visualizações de Log fornecidas pelas ferramentas de Log. Alternativamente, você pode utilizar um navegador ativado em XML para visualizar o formato de documento de 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 só pode ser visualizado com o uso do Microsoft Internet Explorer V6.0.28 e acima.

1.4.6 Somente os bancos de dados de análise de sintomas no formato TPTP podem ser criados a partir da barra de ferramentas e do menu pop-up do Log Navigator

Por 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 e do menu de contexto da barra de ferramentas do Log Navigator. Uma solução alternativa é selecionar File > New > Other > Profiling and Logging no menu do workbench e escolher o tipo de banco de dados de análise de sintomas que se deseja criar.

2.0 Ferramenta de Traçado de Perfil

2.1 As visualizações do Agente e da Interação do Processo não são suportadas na visualização do Diagrama de Seqüência

As visualizações das Interações do Agente e a visualização das Interações do Processo não são suportadas a partir da visualização do Diagrama de Seqüência dos arquivos de log.

Não há atualmente uma solução alternativa para esse problema.

2.2 O comando para atualizar visualizações do Profiling Navigator não funciona para as Interações de Rastreio

O comando para atualizar visualizações do Profiling Navigator não funciona para as Interações de Rastreio. Entretanto, as interações de rastreio se atualizam automaticamente em seus intervalos próprios em intervalos regulares.

Uma solução alternativa é selecionar outro nó na árvore de Traçado de perfil e selecionar novamente o nó anterior.

2.3 O traçado de perfil no Windows que utiliza o Sun JDK 1.4.x pode terminar com um relatório de erros da Microsoft

Defeito Bugzilla: 103058

O traçado de perfil ou aplicativo termina com a mensagem "java.exe encontrou um problema e precisa ser fechado. Desculpe-nos pela inconveniência.". A mensagem contém informações e opções para o envio do relatório de erros para a Microsoft. Consulte o bugzilla 103058 para obter uma captura de tela da mensagem.

Esse problema foi observado em uma série de modos: Análise de tempo (com ou sem "Mostrar instâncias"), Análise da memória e em combinações desses modos. Você pode solucionar o problema ao executar novamente o traçado de perfil ou o aplicativo com JIT desligado, isto é, fornecendo o "-Djava.compiler=NONE" como um argumento de JVM. O problema foi encontrado com o SUN JDK 1.4.2_08-b03 embutido no Windows.


(C) Direitos Autorais IBM Corporation 2000, 2005. Todos os Direitos Reservados.

Retornar para o Arquivo Leia-me Principal

Direitos Autorais e Avisos