Notas sobre o Release do Log and Trace Analyzer

© Copyright International Business Machines Corporation 2000, 2007. Todos direitos reservados. Direitos Restritos a Usuários do Governo dos Estados Unidos - Uso, duplicação e divulgação restritos pelo documento GSA ADP Schedule Contract com a IBM Corporation.

Notas sobre o Release

1.0 Limitações, Problemas e Soluções Alternativas Conhecidas
   1.1 Problemas com as Funções de Filtragem e Realce na Visualização Log
   1.2 Problemas ao Importar Arquivos de Log Remoto
   1.3 Importando Arquivos de Log no Linux e AIX
   1.4 Importando o trace.log do WebSphere Application Server
   1.5 Exceção de Falta de Memória
   1.6 Os Eventos de Log Mostrados no Log do Diagnóstico do DB2 Express Não São para Especificação
   1.7 Nenhuma Validação É Feita no Tipo de Arquivo de Log que Está Sendo Importado
   1.8 Limitação ao Importar Arquivos de Log Gerados em um Código do Idioma Diferente
   1.9 Falha na Importação do Log de Atividades do WebSphere Application Server com o Analisador de Regras do AIX
   1.10 A Filtragem de Tipos Complexos de Common Base Event Não É Suportada para Importações de Arquivo de Log
   1.11 Problemas ao Importar Múltiplos Arquivos de Log Simultaneamente
   1.12 O Acesso Simultâneo de Clientes Utilizando a Mesma Conta de Banco de Dados Não é Suportado
   1.13 Conflito de Caminhos de Recursos
   1.14 As Preferências de Suporte a Recursos Grandes Permanecem Desativadas apesar da Seleção Válida
   1.15 Melhorando o Desempenho de Suporte a Logs Grandes
   1.16 Exceção Intermitente do SQL
   1.17 A Conexão de Teste Retornará um Erro se Você Não Tiver Aplicado Preferências
   1.18 A Expressão XPath Não É Suportada ao Analisar Logs Grandes
   1.19 Apenas um contextDataElement É Exibido para Logs Grandes
   1.20 Assistente de Nova Correlação de Log Não Exibido Corretamente no Driver Linux GTK
   1.21 Travamento ao Criar um Exemplo no Red Hat Linux v8.0 com a IBM JVM
   1.22 Apenas 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 Navegador de Log
   1.23 Mensagens Maiores que 1024 Bytes Não Processadas
   1.24 O Editor de Sintomas Gera Regras XPATH que Não São Válidas ao Utilizar Elementos Complexos
   1.25 As Visualizações Agente e Interação do Processo Não São Suportadas na Visualização Diagrama de Seqüência
   1.26 O Comando Atualizar Visualizações do Profiling Navigator Não Funciona para Interações de Rastreio

1.0 Limitações, Problemas e Soluções Alternativas Conhecidas

1.1 Problemas com as Funções de Filtragem e Realce na Visualização Log

Na Visualização de Log, as funções Filtragem e Realce não funcionam em elementos complexos do evento de Log (por exemplo, sourceComponentId)

1.2 Problemas ao Importar Arquivos de Log Remoto

Ao importar um arquivo de log remoto (Arquivo > Importar > Gerenciamento de Perfis e Criação de Log > Arquivo de Log), nenhuma entrada de log é exibida na Visualização de Log após a atualização das Visualizações do Monitor de Gerenciamento de Perfis (Perfil > Atualizar Visualizações) ou um um diálogo de Mensagem de Criação de Log é exibido informando que o cliente local não iniciou o monitoramento do analisador de log remoto depois de aguardar 30 segundos.
Esse problema ocorre devido ao tempo de espera da rede e é possível corrigi-lo aumentando o tempo que o Agent Controller aguarda pelo cliente local para iniciar o monitoramento do analisador de log remoto. Para solucionar esse problema, tente as etapas a seguir:


Tente importar o arquivo de log novamente.

Se os sintomas persistirem, inclua a entrada a seguir no aplicativo remoto RemoteLogParserLoader na configuração do Agent Controller (isto é, <diretório de instalação do Agent Controller>/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>

em que xxxxx é o tempo máximo de espera, em milissegundos (isto é, maior que 30000).
Uma vez feita a atualização, reinicie o Agent Controller e tente importar o arquivo de log novamente.

1.3 Importando Arquivos de Log no Linux e AIX

Algumas importações de arquivos de log não funcionam 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.4 Importando o trace.log 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.5 Exceção de Falta de Memória

Os arquivos de log com até 25 MB podem ser importados para o espaço de trabalho. 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 recurso de suporte a logs grandes.

1.6 Os Eventos de Log Mostrados no Log do Diagnóstico do DB2 Express Não São para Especificação

Se você importar um log de Diagnóstico do IBM DB2® Express, os eventos de Log resultantes mostrados não seguirão completamente a especificação de evento de Log. Isso ocorre devido a um erro no utilitário db2diag.exe que é utilizado para converter os logs do Diagnóstico do DB2 em eventos de Log. Isso não deveria afetar de outro modo a operação de importação. Não há uma solução alternativa conhecida até que o db2diag.exe seja corrigido. 

1.7 Nenhuma Validação É Feita no Tipo de Arquivo de Log que Está Sendo Importado

Nenhuma validação é feita no 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 a partir do diálogo de erro.  

1.8 Limitação ao Importar os Arquivos de Log Gerados em um Código do Idioma Diferente

Ao importar arquivos de log que contêm registros de data e hora em um código do idioma diferente daquele em que o workbench está sendo executado, o analisador de arquivo de log baseado em regras, às vezes, não analisa corretamente o registro de data e hora e outros dados do registro de log. Por exemplo, ao importar um arquivo de log de acesso ao IBM HTTP Server em inglês para uma máquina que esteja em japonês, os valores de creationTime nos eventos de log resultantes terão um valor de zero e o campo de msg do evento de Log ficará em branco.

Para solucionar esse problema, ao importar arquivos de log que contêm registros de data e hora em um código do idioma diferente daquele da máquina atual, especifique o código do idioma do arquivo de log na guia Detalhes no assistente de Importação de Log, se existir um campo de código do idioma.

1.9 Falha na Importação do Log de Atividades do WebSphere Application Server com o Analisador de Regras do AIX

A importação de um log de atividades binárias do WAS falha com o analisador de Regras de um sistema AIX, 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 Ocorreram erros ao analisar o arquivo de log /home/tfoun/logs/activity.log.
java.lang.Exception: IWAT0239E Falha no comando de conversor: java.lang.Exception:
IWAT0238E Processo de conversor encerrado com o valor de saída 1

O comando de 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 o arquivo de log de atividades binárias ou converta o arquivo de log de atividades binárias em texto, utilizando o utilitário showlog do WAS, e importe o arquivo de texto resultante. O utilitário showlog do WAS pode ser localizado no diretório bin no diretório de instalação do WAS. Por exemplo, utilize o seguinte comando 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 o activity.txt.

1.10 A Filtragem de Tipos Complexos de Common Base Event Não É Suportada para Importações de Arquivo de Log

Ao especificar arquivos de log para importação, você pode criar filtros avançados. Na caixa de diálogo Incluir Propriedade de Filtro, existe uma caixa de combinação para o campo Atributo. Essa caixa de combinação lista várias propriedades de evento de Log. Observe que ela não lista os tipos complexos para as propriedades de evento de Log. 

1.11 Problemas ao Importar Múltiplos Arquivos de Log Simultaneamente

Ao importar múltiplos arquivos de log simultaneamente, as datas nos registros importados podem estar incorretas. Para solucionar esse problema, importe os arquivos um por vez. 

1.12 O Acesso Simultâneo de Clientes Utilizando a Mesma Conta de Banco de Dados Não é Suportado

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 do banco de dados.

1.13 Conflito de Caminhos de Recursos

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.

Como solução alternativa para esse problema, utilize nomes de projeto e de monitor diferentes em cada espaço de trabalho para evitar colisões de caminhos de recursos.

1.14 As Preferências de Suporte a Recursos Grandes Permanecem Desativadas apesar da Seleção Válida

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.

1.15 Melhorando o Desempenho de Suporte a Logs Grandes

Para melhorar 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.sql
em que x_x_x é o número de versão no diretório do plug-in.

1.16 Exceção Intermitente do SQL

Ocasionalmente, pode ocorrer a seguinte exceção SQL:

com.ibm.db2.jcc.b.SQLException: NULLID.SYSSH203 0X5359534C564C3031

Quando esse problema ocorrer, reinicie o workbench e o banco de dados, se estiver utilizando o DB2 ou o Cloudscape™ em modo de rede. Registros importados quando essa exceção ocorre não serão válidos e precisarão ser importados novamente.

1.17 A Conexão de Teste Retornará um Erro se Você Não Tiver Aplicado Preferências

Na página Suporte a Grandes Logs da seção Traçado de Perfil e Log do diálogo Preferências, se você clicar em Testar Conexão antes de ter aplicado alterações nas configurações, poderá obter um erro de conexão. Para evitar isso, clique em Aplicar após fazer qualquer alteração na configuração e, em seguida, clique em Testar Conexão.

1.18 A Expressão XPath Não É Suportada ao Analisar Logs Grandes

A expressão XPath a seguir não é suportada ao analisar logs grandes.
    <expression:xpathExpression>/CommonBaseEvent</expression:xpathExpression>

1.19 Apenas um contextDataElement É Exibido para Logs Grandes

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 contextDataElements múltiplos para esse evento.

1.20 Assistente de Nova Correlação de Log Não Exibido Corretamente no Driver Linux GTK

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.

1.21 Travamento ao Criar um Exemplo no Red Hat Linux v8.0 com a IBM JVM

Ao criar um exemplo utilizando o assistente de Criação de Exemplo (Novo > Exemplo), o Workbench 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 JVM (Java™ Virtual Machine) e é um erro 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 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 seguintes sistemas Linux são suportados: versão 2.2.1 do kit de ferramentas de widget GTK+ 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 (incluído); o visualizador de HTML do SWT requer o Mozilla 1.4GTK2.

1.22 Apenas 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 Navegador de Log

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 da barra de ferramentas e do menu de contexto do navegador de log. Uma solução alternativa é selecionar Arquivo > Novo > Outro > Gerenciamento de Perfis e Criação de Log no menu do workbench e escolher o tipo de banco de dados de análise de sintomas que se deseja criar. 

1.23 Mensagens Maiores que 1024 Bytes Não Processadas

Em regras XPath e regras de correlação IBM, a cadeia na propriedade de evento de Log de msg não deve ter mais que 1024 bytes. Se a cadeia tiver mais de 1024 bytes, ela não será processada.

1.24 O Editor de Sintomas Gera Regras XPATH que Não São Válidas ao Utilizar Elementos Complexos

Ao utilizar elementos complexos do evento de Log (por exemplo, sourceComponentID), o Editor de Sintomas gera regras XPATH inválidas. 

1.25 As Visualizações Agente e Interação do Processo Não São Suportadas na Visualização Diagrama de Seqüência

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.

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

1.26 O Comando Atualizar Visualizações do Profiling Navigator Não Funciona para Interações de Rastreio

O 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 outro nó na árvore de Traçado de perfil e selecionar novamente o nó anterior.