© Copyright International Business Machines Corporation 2000, 2006. Todos direitos reservados. Direitos Restritos para Usuários do Governo dos Estados Unidos - Uso, duplicação e divulgação restritos pelo documento GSA ADP Schedule Contract com a IBM Corporation.
1.0 Log and Trace Analyzer
1.1 Visualizações
1.1.1 Problemas com as Funções de Filtragem e Realce na
Visualização de Log
1.2 Importando Logs
1.2.1 Problemas ao Importar Arquivos de Log Remotos
1.2.2 Importando Arquivos de Log no Linux e no 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 ao Importar Arquivos de Log e Catálogos de
Sintomas Grandes
1.2.6 Eventos de Base Comuns Mostrados para o Log de Diagnóstico do DB2 Express Não São para Especificação
1.2.7 Nenhuma Validação é Feita pelo Log and Trace Analyzer Quanto ao Tipo de Arquivo de Log Sendo Importado
1.2.8 Limitação ao Importar Arquivos de Log Gerados em um Código do Idioma Diferente
1.2.9 Falha na Importação do Log de Atividades do WebSphere Application Server com Analisador de Regras do AIX
1.2.10 Impossível Criar uma Correlação Baseada no Tempo com o Apache Derby Versão 10.1.2.1
1.2.11 Desempenho Lento ao Criar e Mostrar Correlação para Logs Grandes
1.3 Suporte ao Banco de Dados
1.3.1 Não é Suportado Acesso Simultâneo de Clientes Utilizando a Mesma Conta do Banco de Dados
1.3.2 Colisão do Caminho de Recurso
1.3.3 As Preferências de Suporte a Recursos Grandes Permanecem Desativadas, Apesar da Seleção Válida
1.3.4 Aprimorando o Desempenho do Suporte a Logs Grandes
1.3.5 Reiniciar o DB2 Depois de Criar Banco de Dados e Tabelas
1.3.6 Exceção SQL Intermitente
1.3.7 Conexão de Teste Retorna Erro se Você Não Aplicar as Preferências
1.3.8 Expressão XPath do CommonBaseEvent não Suportada ao Analisar Logs Grandes
1.3.9 Somente um contextDataElement é Exibido para Logs Grandes
1.4 Outro
1.4.1 Assistente de Nova Correlação de Log Não Exibido Adequadamente no Driver GTK do Linux
1.4.2 Modificações no Nível de Criação de Log de um Plug-in após o Primeiro Início do Ambiente de Trabalho Não São Respeitadas
1.4.3 Travamento ao Criar um Exemplo no Red Hat Linux v8.0 com a IBM JVM
1.4.4 Somente Bancos de Dados de Análise de Sintomas com Formato TPTP Podem ser Criados na Barra de ferramentas e no Menu Pop-up do Navegador do Log
1.4.5 IBM Log Analyzer Só Processa Mensagens com Até 1024 Bytes
1.4.6 O Editor de Sintomas Gera Regras XPATH Não Válidas ao Utilizar
Elementos Complexos
1.4.7 O Editor de Sintomas Gera Regras XPATH que não Correspondem a
Nenhum Evento de Base Comum
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 Definição de Perfis Não Funciona para Interações de Rastreio
2.3 A Definição de Perfis no Windows Utilizando o Sun JDK 1.4.x Pode Finalizar com um Relatório de Erros Microsoft(R)
Informações adicionais de leia-me associadas ao Log and Trace Analyzer TPTP estão disponíveis nas
notas sobre o release do TPTP V4.2.
Na Visualização de Log, as funções Filtragem e Realce não funcionam em elementos complexos do Evento de Base Comum (por exemplo, sourceComponentId). Será fornecida uma correção no próximo fix pack.
Durante a importação de 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 Definição de Perfis (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 depois de aguardar 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 completamente nas plataformas Linux(R) e AIX(R).
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 ServerUma Correlação Interna é criada quando um arquivo trace.log do WebSphere(R) 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 V5Arquivos de log remotos diferentes de activity.log não podem ser importados utilizando um IBM(R) Agent Controller V5. Ao importar arquivos de log remotamente, o IBM Agent Controller da máquina remota deve estar no mesmo nível, ou superior, que o IBM Log and Trace Analyzer para Eclipse.
Para solucionar esse problema, instale o IBM Agent Controller fornecido com o IBM Log and Trace Analyzer para Eclipse na máquina remota.
1.2.5 Exceção Sem Memória ao Importar Arquivos de Log e Catálogos de Sintomas GrandesArquivos de log e catálogos de sintomas com até 25 MB podem ser importados no espaço de trabalho e abertos no Log and Trace Analyzer.
A quantia de tempo que demora 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 a logs grandes.
Se aparecer uma exceção "sem memória" ao importar catálogos de sintomas grandes, aumente o tamanho de heap, incluindo o seguinte vmargs:
-vmargs -Xmx1000m
Se você estiver utilizando o recurso de suporte para logs grandes, não corrija o problema da exceção "sem memória" ao importar logs grandes; o aumento do tamanho de heap deve ajudar.
Se você importar um log de Diagnóstico do IBM DB2(R) Express, os Eventos de Base Comuns mostrados no Log and Trace Analyzer não estarão de acordo com a especificação do Evento de Base Comum. Isto ocorre devido a um erro no utilitário db2diag.exe que é utilizado para converter logs do DB2 Diagnostic em Eventos de Base Comum. Isso não deve afetar a operação de importação. Não há 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, certifique-se de que o tipo de log e a versão corretos sejam escolhidos para o arquivo de log que está sendo importado. Se o problema ocorrer durante a importação, nenhum registro ou registro incorreto será mostrado 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 do erro.
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, na importação de um arquivo de log de acesso ao IBM HTTP Server em inglês no Log and Trace Analyzer executando em uma máquina em japonês, os valores de creationTime nos Eventos de Base Comuns resultantes terão o valor zero e o campo de mensagens do Evento de Base Comum ficará em branco.
Para solucionar esse problema, ao importar arquivos de log que contenham registros de data e hora em um código de idioma diferente do atual da máquina, especifique o código do idioma do arquivo de log na guia Detalhes do assistente para Importação de Log, se um campo de código do idioma existir.
A importação de um log binário de Atividades do WAS com o analisador de Regras do sistema AIX falha com o seguinte erro exibido no diálogo de erro:
IWAT0030E Ocorreu um erro durante a execução do log remoto parser "com.ibm.etools.logging.adapter.config.StaticParserExtension": IWAT0412E Erros ocorridos ao analisar o arquivo de log /home/tfoun/logs/activity.log. java.lang.Exception: IWAT0239E Falha no comando conversor: java.lang.Exception: IWAT0238E Processo do conversor encerrado com o valor de saída 1
O comando conversor para converter o arquivo de log binário em texto para que possa ser analisado falha no AIX. Para solucionar esse problema, utilize o analisador Estático para importar ou para converter o arquivo de log de atividades binário em texto utilizando o utilitário showlog do WAS e importe o arquivo de texto resultante no Log and Trace Analyzer. O utilitário showlog do WAS pode ser encontrado no diretório bin do diretório de instalação do WAS. Por exemplo, utilize o comando a seguir para converter o arquivo de log binário em um arquivo de texto chamado activity.txt:
/opt/WebSphere/AppServer/bin/showlog activity.log activity.txt
Em seguida, importe activity.txt para o Log and Trace Analyzer.
Embora não seja suportado oficialmente pelo TPTP, um usuário do TPTP tentou utilizar o Derby 10.1.2.1 em conjunto com o suporte a logs grandes e teve esse problema. Na tentativa de criar uma correlação baseada no tempo com um log grande, ocorreu uma ArrayIndexOutOfBoundsException, que fez com que a correlação fosse executada continuamente sem parar. Esse é um erro conhecido do Derby que foi corrigido na versão 10.2.0.0. Para obter mais informações, consulte a descrição do erro Derby em http://www.archivum.info/derby-dev@db.apache.org/2006-03/msg01624.html.
Observe que essa exceção ocorre no lado do servidor e não é visto no ambiente de trabalho do usuário. Isso é exibido na janela de comando em que o comando é emitido para iniciar o servidor Derby.
Ao criar ou mostrar uma correlação para um log grande, o desempenho pode ficar lento no Apache Derby e no DB2.
Para aprimorar o desempenho ao criar uma correlação, importe logs com um filtro de importação para que os eventos não necessários ou não relacionados não sejam incluídos no banco de dados. Utilizar um filtro "Mostrar apenas eventos correlacionados" pode aumentar o desempenho ao abrir a correlação na visualização Interações de Log.
O acesso simultâneo de clientes a um banco de dados pode bloquear algumas tabelas. Para desbloquear as tabelas, reinicie o Ambiente de Trabalho e o servidor de banco de dados.
Se você utilizar o mesmo banco de dados e mesma conta do banco de dados para vários espaços de trabalho, poderão ocorrer colisões do caminho de recurso e o recurso não será persistido no banco de dados.
Para solucionar esse problema, utilize nomes de projeto e de monitor diferentes em cada espaço de trabalho para evitar colisões do caminho de recurso.
No Linux/GTK, na página de preferências do Suporte a Recursos Grandes, os campos de configurações do banco de dados permanecerão desativados mesmo que um tipo de banco de dados válido seja selecionado.
Para solucionar esse problema, selecione o DB2 como o tipo de banco de dados e aplique as configurações. Feche e reabra o diálogo de preferências; os campos serão ativados.
Para aprimorar o desempenho do suporte a logs grandes, execute o seguinte comando depois de importar logs grandes:
db2 -tvf plugins/com.ibm.etools.ac.resources.database_x_x_x /scripts/runStatsForAllHyadesTablesDB2-8.1.sqlem que x_x_x é o número da versão no diretório do plug-in.
Depois de executar o script de criação do banco de dados e tabelas, CreateDatabaseAndTablesDB2-8.1.sql, você deve reiniciar o DB2. Em uma janela de comando do DB2, execute db2stop e db2start para aplicar as alterações feitas pelo script nos parâmetros de configuração.
Ocasionalmente, pode ocorrer a seguinte exceção SQL:
com.ibm.db2.jcc.b.SQLException: NULLID.SYSSH203 0X5359534C564C3031
Quando esse problema ocorrer, reinicie o ambiente de trabalho e o banco de dados, se estiver utilizando o DB2 ou o CloudscapeTM no modo de rede. Logs importados quando essa exceção ocorre não serão válidos e deverão ser importados novamente.
Na página Suporte a Logs Grandes da seção Definição de Perfis e Criação de Log do diálogo Preferências, se você clicar em Testar Conexão antes de aplicar as alterações nas configurações, poderá receber um erro de conexão. Para evitar isso, clique em Aplicar depois de fazer alterações de configuração e clique em Testar Conexão.
A seguinte expressão XPath não é suportada pelo IBM Log Analyzer ao analisar logs grandes.
<expression:xpathExpression>/CommonBaseEvent</expression:xpathExpression>
Se o DB2 for utilizado para suporte a logs grandes, apenas um contextDataElement de um evento será exibido na visualização de Log, mesmo se houver vários contextDataElements para esse evento.
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.
Para solucionar esse problema, reinicie o ambiente de trabalho com o argumento da linha de comandos -clean. Essa opção limpará os caches utilizados para armazenar a resolução de dependência de pacotes configuráveis e os dados do registro de extensão 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 ambiente de trabalho>\eclipse\ac.bat (Windows(R)) ou no <diretório de instalação do ambiente de trabalho>/eclipse/ac.sh (Linux). Como alternativa, você pode modificar o nível de criação de log do plug-in na página de preferências de Criação de Log (Janela > Preferências > Criação de Log) e reiniciar o ambiente de trabalho.
Ao criar um exemplo no Log and Trace Analyzer utilizando o assistente de Criação de Exemplo (Novo > Exemplo), o Ambiente de Trabalho trava. 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 JavaTM Virtual Machine (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.
Devido a uma limitação do TPTP, os usuários não podem criar ambos os tipos de banco de dados de análise de sintomas no botão da barra de ferramentas e no menu de contexto do navegador do log. Uma solução alternativa é selecionar Arquivo > Novo > Outro > Definição de Perfis e Criação de Log no menu do ambiente de trabalho e escolher o tipo de banco de dados de análise de sintomas que você deseja criar.
Nas regras XPATH e nas regras de correlação da IBM, a cadeia da propriedade msg do Evento de Base Comum deve ter mais que 1024 bytes. Se a cadeia tiver mais que 1024 bytes, não será processada pelo IBM Log Analyzer.
Na utilização de elementos complexos do Evento de Base Comum (por exemplo, sourceComponentID), o Editor de Sintomas gera regras XPATH que não são válidas. Será fornecida uma correção no próximo fix pack.
Se algum dos ExtendedDataElements for selecionado na criação de uma nova expressão XPATH,
o catálogo de sintomas resultante conterá
extendedDataElement
, em vez de extendedDataElements
.
Como resultado, o Editor de Sintomas gerará regras XPATH que não correspondem a nenhum
Evento de Base Comum de entrada.
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 Definição de Perfis 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 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 A Definição de Perfis no Windows Utilizando o Sun JDK 1.4.x Pode Finalizar com um Relatório de Erros MicrosoftDefeito do Bugzilla: 103058
A definição de perfis ou o aplicativo termina com a mensagem "java.exe encontrou um problema e precisa ser fechado. Desculpe o inconveniente." 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 com esses modos. A solução alternativa desse problema é reexecutar a definição de perfis ou o aplicativo com o JIT desativado, ou seja, fornecendo "-Djava.compiler=NONE" como um argumento da JVM. O problema foi encontrado com o build SUN JDK 1.4.2_08-b03 para Windows.