Generic Log Adapter - Notas sobre o Release

Problemas Conhecidos e Soluções Alternativas

1.0 Generic Log Adapter
  1.1 Último Registro Não Processado Quando o Generic Log Adapter É Executado Continuamente
  1.2 Problemas ao Chamar o Arquivo de Configuração do Generic Log Adapter
  1.3 Limitação ao Analisar Logs do WebSphere Application Server no UNIX
  1.4 Limitação ao Analisar Logs de Erros do WebSphere MQ no UNIX
  1.5 Problemas ao Analisar Arquivos de Log Utilizando o runregex_showlog_example.bat/sh
  1.6 Dados Incorretos Retornados pelo Analisador de Regras do Log de Diagnósticos do DB2
  1.7 Analisar Alguns Logs Gera Informações Incorretas de Fuso Horário
  1.8 Elementos de Dados Estendidos Inválidos Gerados
  1.9 Scripts do Generic Log Adapter Não Legíveis no z/OS
  1.10 *O Script de Exemplo Errpt do Generic Log Adapter AIX runregex_errpt_example.sh Não Funciona no AIX
  1.11 A Monitoração Contínua de Arquivos de Log com Analisadores Estáticos Não É Suportada
  1.12 Limitações e Informações de Log do Generic Log Adapter
  1.13 Nenhuma Validação Feita no Tipo de Arquivo de Log
  1.14 Limitação ao Analisar os Arquivos activity.log do WebSphere Application Server
  1.15 Limitação ao Analisar Arquivos de Log Gerados em um Código do Idioma Diferente
  1.15 Áreas de Janela Vazias do Editor ao Executar Arquivos de Adaptador do Analisador Estático
  1.17 Problemas ao Descompactar com o Utilitário de Descompactação de Arquivo ZIP do Windows XP

1.0 Generic Log Adapter

1.1 Último Registro Não Processado Quando o Generic Log Adapter É Executado Continuamente

Quando o Generic Log Adapter está monitorando continuamente um arquivo de log, ele não processa o último registro quando não há um padrão de encerramento especificado. O último registro será processado apenas quando o Generic Log Adapter estiver sendo encerrado.

Para assegurar que o último registro seja processado durante a monitoração, forneça um padrão de encerramento para os registros no arquivo de configuração do Generic Log Adapter.

1.2 Problemas ao Chamar o Arquivo de Configuração do Generic Log Adapter

O arquivo de configuração do Generic Log Adapter não é chamado adequadamente quando isso é feito através do arquivo em batch gla.bat.

Isso pode ser resolvido utilizando um caminho absoluto para o arquivo de configuração. Por exemplo, gla.bat c:\mypathname\static.adapter .

1.3 Limitação ao Analisar Logs do WebSphere Application Server no UNIX

Ao analisar os logs binários de serviço e de atividade do WebSphere Application Server nas plataformas UNIX utilizando o Generic Log Adapter, o usuário deve ter privilégios iguais ou superiores aos do instalador do WebSphere Application Server.

Para solucionar essa limitação, o log binário de serviço ou de atividade deve ser movido para um diretório com os mesmos privilégios que o usuário do Generic Log Adapter, antes da análise do log.

1.4 Limitação ao Analisar Logs de Erros do WebSphere MQ no UNIX

Ao analisar os logs de Erros do WebSphere MQ em plataformas UNIX utilizando o Generic Log Adapter, o usuário deve ter privilégios iguais ou superiores aos do instalador do WebSphere MQ.

Para solucionar essa limitação, mova os logs de Erros do MQ para um diretório com os mesmos privilégios que o usuário do Generic Log Adapter, antes da análise dos logs.

1.5 Problemas ao Analisar Arquivos de Log Utilizando o runregex_showlog_example.bat/sh

Ao tentar utilizar o runregex_showlog_example.bat e o runregex_showlog_example.sh para analisar um log de atividades do WebSphere Application Server, não é possível localizar o utilitário showlog do WebSphere Application.

Para solucionar esse problema, edite o arquivo regex_showlog_example.adapter no editor de regras e atualize a propriedade Conversor do Sensor para apontar para o local do diretório apropriado do WebSphere Application Server.

1.6 Dados Incorretos Retornados pelo Analisador de Regras do Log de Diagnósticos do DB2

Ao analisar os arquivos do Log de Diagnósticos do DB2 com a configuração do adaptador baseado em regras, as mensagens do arquivo de log na saída analisada incluem um caractere anormal de dois-pontos.

Atualmente não existe solução alternativa para esse problema.

1.7 Analisar Alguns Logs Gera Informações Incorretas de Fuso Horário

A análise de alguns logs gera informações incorretas de fuso horário.

Apenas os arquivos de log com timestamps contendo informações de fuso horário produzirão dados analisados com valores creationTime tendo o fuso horário correto. Se os timestamps em um arquivo de log não contiverem informações de fuso horário, o Generic Log Adapter gerará valores de creationTime com informações incorretas de fuso horário.

1.8 Elementos de Dados Estendidos Inválidos Gerados

O Generic Log Adapter gerará um elemento inválido do Evento de Base Comum extendedDataElements para um registro de log se não houver uma regra que corresponda ao valor do nome ou tipo. O extendedDataElement não deverá ser gerado se não houver um nome ou tipo analisado a partir do registro de log, mas o Generic Log Adapter gerará apenas um com o campo de valor.

Para solucionar esse problema, assegure-se de que sejam fornecidas regras que façam com que os três campos - nome, valor, tipo - do extendedDataElement sejam correspondidos.

1.9 Scripts do Generic Log Adapter Não São Legíveis no z/OS

A descompactação dos arquivos runtime.zip e rules.zip no z/OS às vezes produz scripts de arquivo ilegíveis.

Para evitar esse problema, assegure-se de que o procedimento a seguir seja seguido ao descompactar os arquivos runtime.zip e rules.zip em um sistema z/OS.

unzip -a runtime.zip
unzip -a rules.zip
unzip -o rules.zip *.adapter
*1.10 O Script de Exemplo Errpt do Generic Log Adapter AIX runregex_errpt_example.sh Não Funciona no AIX

O script de exemplo errpt do Generic Log Adapter AIX, runregex_errpt_example.sh, não funciona no sistema AIX.

Para solucionar esse problema, edite o arquivo de adaptador do exemplo errpt do AIX GenericLogAdapter\config\AIX\syslog\v4\regex_errpt_example.adapter com o editor de configuração do Generic Log Adapter e faça as seguintes alterações:

  1. Altere a propriedade de conversor do Sensor de modo que tenha errpt -a >/tmp/errpt.out como um Valor da Propriedade.
  2. Inclua uma nova propriedade no Sensor com o Nome da Propriedade shell e Valor da Propriedade sh.

Nota: Isso foi corrigido na V6.0.0.1.

1.11 A Monitoração Contínua de Arquivos de Log com Analisadores Estáticos Não É Suportada

Não é possível monitorar arquivos de log continuamente com classes de analisadores estáticos Java. Utilize o analisador baseado em regras, caso exista, para monitorar continuamente esses arquivos de log.

1.12 Limitações e Informações de Log do Generic Log Adapter

Quando o Generic Log Adapter é executado fora de um ambiente Eclipse, ele registra as mensagens e os erros em um arquivo denominado hgla.log.  Ao ser executado no modo independente, o hgla.log será criado no diretório de trabalho atual.  Ao ser executado como parte de uma operação de importação do log remoto utilizando o Log and Trace Analyzer, o hgla.log estará localizado no diretório /tmp do sistema remoto se estiver sendo executado em um sistema UNIX ou Linux ou no c:\Documents and Settings\userid\Local Settings\Temp, se estiver sendo executado em um sistema Windows.  O Generic Log Adapter registra eventos com níveis de log 10, 20, 30, 50 e 60.  O arquivo hgla.log pode ser importado para o Log and Trace Analyzer para diagnosticar problemas encontrados pelo Generic Log Adapter ao analisar o arquivo de log.

Ao ser executado em um ambiente Eclipse, por exemplo como parte de uma operação de importação do log local utilizando o Log and Trace Analyzer, o Generic Log Adapter não registra mensagens no arquivo hgla.log ou em qualquer outro local.

1.13 Nenhuma Validação Feita no Tipo de Arquivo de Log

Nenhuma validação é feita pelo Generic Log Adapter para determinar se o tipo de arquivo de log que está sendo analisado corresponde à configuração do arquivo de adaptador.  Por exemplo, se o arquivo de log especificado na configuração do sensor no arquivo de adaptador não for do tipo para o qual as regras de configuração e de substituição do extrator na configuração do analisador foram projetadas, poderão ocorrer resultados inesperados.  A análise pode suceder sem erro, mas os dados resultantes do Evento Base estarão incorretos.  A análise pode falhar com mensagens de erro indicando que dados incorretos foram encontrados.

Para solucionar esse problema, assegure-se de que o arquivo especificado na configuração do componente de sensor seja do tipo correto.

1.14 Limitação ao Analisar os Arquivos activity.log do WebSphere Application Server

Ao analisar arquivos binários do log de atividades do WebSphere Application Server em máquinas não em inglês, utilizando o runregex_showlog_example.bat/sh, os dados do registro de log não serão mapeados com êxito em um Evento de Base Comum.  Em vez disso, alguns dados do registro de log poderão aparecer no campo incorreto do Evento de Base Comum.

1.15 Limitação ao Analisar Arquivos de Log Gerados em um Código do Idioma Diferente

Ao analisar arquivos de log que contenham timestamps em um código do idioma diferente daquele em que o Generic Log Adapter está sendo executado, utilizando um arquivo de adaptador baseado em regras configurado para utilizar o atributo Formato de Hora na regra de substituição para creationTime, o timestamp e outros dados do registro de log podem não ser analisados corretamente.  Por exemplo, ao analisar um arquivo de log de acesso ao IBM HTTP Server em inglês, em uma máquina em japonês, utilizando  config\IHS\access\v1.3.19.3\runregex_example.bat/sh, os valores de creationTime nos Eventos de Base Comum resultantes terão um valor zero e o campo de msg do Evento de Base Comum ficará em branco.

Para solucionar esse problema, altere o arquivo runregex_example.bat/sh, incluindo os seguintes parâmetros da JVM no comando java:

-Duser.language=2-char-language-code -Duser.region=2-char-country-code

em que o idioma e os códigos de idioma são para o código do idioma em que se encontram os timestamps.  Para o exemplo mencionado, os parâmetros da JVM seriam:

-Duser.language=en -Duser.region=US
1.16 Áreas de Janela Vazias do Editor ao Executar Arquivos de Adaptador do Analisador Estático

Ao executar um arquivo de adaptador do analisador estático no editor de configuração do Generic Log Adapter, as áreas de janela Resultado do Extrator e Resultado do Formatador estarão vazias. Isso ocorre porque um adaptador do analisador estático não contém um componente extrator e formatador. Entretanto, se o arquivo de adaptador do analisador estático for configurado corretamente, a área de janela Resultado do Sensor conterá dados. A saída do sensor do analisador estático consiste nos Eventos Base Comuns que representam os registros analisados do log. A área de janela Resultado do Sensor conterá Eventos Base Comuns no formato de cadeia. Se a área de janela Resultado do Sensor estiver vazia após o clique no botão Reexecutar Adaptador, clique no botão Mostrar Log na barra de ferramentas no início da área de janela Resultado do Extrator para exibir a saída do sensor na área de janela Resultado do Sensor.

1.17 Problemas ao Descompactar com o Utilitário de Descompactação de Arquivo ZIP do Windows XP

Ao instalar o Generic Log Adapter no Windows XP, ocorrem problemas ao descompactar o arquivo rules.zip do Generic Log Adapter com o utilitário nativo de descompactação de arquivo 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 analisados utilizando o Generic Log Adapter.Para solucionar esse problema, ao instalar no Windows XP, utilize um outro utilitário de descompactação de arquivo ZIP, como WinZip ou UnZip.

Retornar para o Arquivo Leia-me Principal