© 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.
Informações adicionais do leia-me associadas ao Adaptador de Log Genérico TPTP estão disponíveis nas Notas sobre o Release do TPTP V4.2.
Quando o Adaptador de Log Genérico estiver monitorando continuamente um arquivo de log, ele não processará o último registro se não houver um padrão de encerramento especificado. O último registro será processado apenas quando o Adaptador de Log Genérico 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.
Ao analisar os logs binários de serviço ou de atividade do WebSphere(R) Application Server nas plataformas UNIXTM utilizando o Adaptador de Log Genérico, o usuário deve ter privilégios iguais ou superiores aos do instalador do WebSphere Application Server.
Para obter uma solução alternativa dessa limitação, mova os logs binários de serviço ou de atividade para um diretório com os mesmos privilégios que o usuário do Adaptador de Log Genérico, antes da análise dos logs.
Ao analisar os logs de Erros do WebSphere MQ em plataformas UNIX utilizando o Adaptador de Log Genérico, o usuário deve ter privilégios iguais ou superiores aos do instalador do WebSphere MQ.
Para obter uma solução alternativa dessa limitação, mova os logs de Erros do MQ para um diretório com os mesmos privilégios que o usuário do Adaptador de Log Genérico, antes da análise dos logs.
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.
O Adaptador de Log Genérico 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 Adaptador de Log Genérico 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.
Quando o Adaptador de Log Genérico é executado em modo independente, fora de um ambiente Eclipse, ele registra as mensagens e os erros em um arquivo denominado hgla.log no diretório de trabalho atual. Se o arquivohgla.log já existir no diretório de trabalho atual, um novo arquivo de log será criado, chamado hgla.nnnnnnnn.log, em que nnnnnnnn é um número exclusivo. Quando o Adaptador de Log Genérico é executado como parte de uma operação de importação de log, as mensagens de erro que ele registra são exibidas em um diálogo de erro no Log and Trace Analyzer.
Ao executar dentro de um ambiente Eclipse na perspectiva do Adaptador de Log Genérico, as mensagens e os erros registrados em log pelo Adaptador de Log Genérico são listados na visualização Problemas.
O Adaptador de Log Genérico registra em log eventos com os níveis de criação de log 5, 10, 20, 30, 50 e 60, dependendo da configuração de loggingLevel para os Contextos e Componentes no arquivo de configuração do adaptador. O arquivo hgla.log pode ser importado para o Log and Trace Analyzer, como um tipo de arquivo XML do Evento de Base Comum, para diagnosticar os problemas encontrados pelo Adaptador de Log Genérico ao analisar o 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 de Base Comum 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.
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.
Ao analisar arquivos de log que contenham registros de data e hora 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 registro de data e hora e outros dados do registro de log podem não ser analisados corretamente. Por exemplo, os valores de creationTime nos Eventos de Base Comum resultantes podem ser zero e o campo msg do Evento de Base Comum ficará em branco.
Para obter uma solução alternativa desse problema, assegure-se de que os valores dos atributos de código de idioma ISO e de código do país ISO de Instância do Contexto no arquivo de adaptador baseado em regras correspondam ao código do idioma dos registros de data e hora no arquivo de log a ser analisado.
Ao converter arquivos de log, que utilizam símbolos de fuso horário de três letras, em formato de Evento de Base Comum utilizando o Adaptador de Log Genérico, os horários de criação incorretos para eventos de log poderão ser o resultado se o símbolo de fuso horário de três letras for não-exclusivo. Por exemplo, o símbolo de três letras "IST" poderá ser interpretado como Horário Padrão de Israel, Horário Padrão do Irã ou Horário de Verão da Irlanda.
Se você analisar um log do IBM(R) DB2(R) Express Diagnostic com os adaptadores em % GLA_Install%\GenericLogAdapter\config\DB2\diag\tool, os Eventos de Base Comum resultantes gravados no arquivo de saída interromperão algumas das especificações do Evento de Base Comum. Isso ocorre por causa de um erro no utilitário db2diag.exe, que é utilizado para converter logs de Diagnóstico do DB2 em Eventos de Base Comuns. Por outro lado, isso não deve afetar a operação de análise. Não há uma solução alternativa conhecida até o db2diag.exe ser corrigido.
A análise de um arquivo de log com um arquivo de adaptador criado utilizando uma versão anterior do Editor de Configuração do Adaptador pode fazer com que a seguinte mensagem de erro seja gravada no arquivo de log do Adaptador de Log Genérico, hgla.log:
IWAT0383E Erro de Validação do Adaptador: cvc-complex-type.4: Atributo 'lineBreakSymbol' deve aparecer no elemento 'ex:Extractor'.
Versões mais antigas do Editor de Configuração do Adaptador criaram arquivos de adaptador sem o atributo Extractor necessário lineBreakSymbol. Esse atributo deve estar presente no elemento Extractor, mesmo que ele tenha um valor vazio. O Adaptador de Log Genérico agora valida o arquivo de adaptador em relação ao esquema do Adaptador de Log Genérico antes de utilizá-lo e lineBreakSymbol é um atributo necessário no esquema.
Para obter uma solução alternativa desse problema, abra o arquivo do adaptador no Editor de Configuração do Adaptador, inclua um valor não vazio no campo lineBreakSymbol do elemento Extractor, salve o arquivo do adaptador, exclua esse valor ser ele não for necessário e salve o arquivo novamente. O arquivo do adaptador agora conterá o atributo lineBreakSymbol no elemento Extractor.
A análise de um arquivo de log com um arquivo de adaptador criado utilizando uma versão anterior do Editor de Configuração do Adaptador pode fazer com que mensagens de erro como a seguinte sejam gravadas no arquivo de log do Adaptador de Log Genérico, hgla.log:
IWAT0438E O formatador de Evento de Base Comum N76D20B0042411D98000E0362B33D6F0 não pode criar um CommmonBaseEvent, pois a propriedade necessária sourceComponentId está ausente.
Essa mensagem indica que o componente do formatador do Adaptador de Log Genérico não pôde criar um Evento de Base Comum, pois sourceComponentId é uma propriedade necessária do Evento de Base Comum e ela está faltando. O Adaptador de Log Genérico agora valida que todas as propriedades necessárias estejam presentes no Evento de Base Comum e, se houver propriedades faltando, o Evento de Base Comum não será retornado. O arquivo do adaptador pode não ter regras de análise para propriedades indicadas nas mensagens ou as regras de análise não estarão corretas.
Para obter uma solução alternativa desse problema, inclua regras do analisador no arquivo do adaptador para as propriedades necessárias ausentes do Evento de Base Comum ou verifique se as regras existentes estão corretas.
Ao analisar logs, as seguintes mensagens de erro poderão ser gravadas no console:
IWAT0310E Não foi possível iniciar o Adaptador de Log Genérico devido a problemas de configuração. IWAT0317E Erro ao criar o componente AdapterLogSensor. IWAT0319E A classe org.eclipse.hyades.logging.adapter.internal.util.AdapterSensor não pode ser instanciada. Exceção = org/eclipse/emf/ecore/EObjectPara obter uma solução alternativa desse problema, faça as seguintes atualizações na opção -classpath nos arquivos de script de tempo de execução gla.bat e gla.sh: