© 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.
O Adaptador de Log Genérico está no pacote configurável do Agent Controller. O Adaptador de Log Genérico permite criar um adaptador para formatos de log customizado. 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 final especificado. O último registro só será processado quando o Adaptador de Log Genérico for 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 logs binários de atividade ou serviço do WebSphere® Application Server em plataformas UNIX™ utilizando o Adaptador de Log Genérico, o usuário deve ter privilégios iguais ou superiores ao do instalador do WebSphere Application Server.
Para solucionar essa limitação, mova os logs binários de atividade ou serviço para um diretório com os mesmos privilégios que o usuário do Adaptador de Log Genérico antes de analisar os logs.
Ao analisar os logs de Erros do WebSphere MQ nas 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 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 Adaptador de Log Genérico antes de analisar os logs.
Quando o Adaptador de Log Genérico é executado no modo independente, fora de um ambiente do Eclipse, ele registra mensagens e erros em um arquivo chamado hgla.log no diretório de trabalho atual. Se o arquivo hgla.log já existir no diretório de trabalho atual, será criado um novo arquivo de log 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 do log, as mensagens de erro registradas são exibidas em um diálogo de erro no Log and Trace Analyzer.
Ao executar dentro de um ambiente Eclipse na perspectiva Adaptador de Log Genérico, as mensagens e os erros registrados pelo Adaptador de Log Genérico são listadas na visualização Problemas.
O Adaptador de Log Genérico registra 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 Common Base Event, para diagnosticar 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 de log que contêm registros de data e hora em um código de idioma diferente daquele que o Adaptador de Log Genérico está sendo executado, utilizando um arquivo do adaptador baseado em regras configurado para utilizar o atributo de Formato de Hora na regra de substituição do creationTime, o registro de data e hora e os outros dados de registro de log podem não ser analisados corretamente. Por exemplo, os valores de creationTime nos Common Base Events resultantes podem ser zero e o campo de msg do Common Base Event pode ficar em branco.
Para solucionar esse problema, certifique-se de que os valores dos atributos de código do idioma ISO e de código do país ISO da Instância de Contexto no arquivo do 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, para o formato Common Base Event utilizando o Adaptador de Log Genérico, horas de criação incorretas dos eventos de log poderão ocorrer se o símbolo de fuso horário de três letras não for exclusivo. Por exemplo, o símbolo de três letras "IST" poderia ser interpretado como Israeli Standard Time (Horário Padrão de Israel), Indian Standard Time (Horário Padrão da Índia), Iran Standard Time (Horário Padrão do Irã) ou Irish Summer Time (Horário de Verão da Irlanda).
Se você analisar um log do Diagnóstico do IBM® DB2® Express com os adaptadores em GLA_INSTALL\GenericLogAdapter\config\DB2\diag\tool, os Common Base Events resultantes gravados no arquivo de saída interromperão uma parte da especificação do Common Base Event. 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 deveria afetar de outro modo a operação de análise. Não há uma solução alternativa conhecida até que o db2diag.exe seja corrigido.
A análise de um arquivo de log com um arquivo do adaptador criado utilizando uma versão anterior do Editor de Configuração do Adaptador pode causar a gravação da seguinte mensagem de erro no arquivo de log do Adaptador de Log Genérico, hgla.log:
IWAT0383E Adapter Validation Error: cvc-complex-type.4: Attribute 'lineBreakSymbol' deve aparecer no elemento 'ex:Extractor'.
Versões mais antigas do Editor de Configuração do Adaptador criavam arquivos do adaptador sem o atributo lineBreakSymbol do Extractor necessário. Esse atributo deve estar presente no elemento Extractor, mesmo se tiver um valor vazio. O Adaptador de Log Genérico valida agora o arquivo do adaptador para o esquema do Adaptador de Log Genérico, antes de utilizá-lo, e lineBreakSymbol é um atributo necessário no esquema.
Para solucionar esse 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, em seguida, exclua esse valor se ele não for necessário e salve o arquivo novamente. O arquivo do adaptador conterá agora o atributo lineBreakSymbol no elemento Extractor.
A análise de um arquivo de log com um arquivo do adaptador criado utilizando uma versão anterior do Editor de Configuração do Adaptador pode causar a gravação de mensagens de erro, como as seguintes, no arquivo de log do Adaptador de Log Genérico, hgla.log:
IWAT0438E O formatador N76D20B0042411D98000E0362B33D6F0 do Common Base Event não pode criar um CommonBaseEvent porque a propriedade necessária sourceComponentId está faltando.
Essa mensagem indica que o componente de formatador do Adaptador de Log Genérico não pôde criar um Common Base Event porque o sourceComponentId é uma propriedade necessária do Common Base Event e está faltando. O Adaptador de Log Genérico valida agora se todas as propriedades necessárias estão presentes no Common Base Event e, se alguma estiver faltando, o Common Base Event não será retornado. O arquivo do adaptador pode não ter regras de análise para as propriedades indicadas nas mensagens ou as regras de análise não estão corretas.
Para solucionar esse problema, inclua regras do analisador no arquivo do adaptador para as propriedades necessárias do Common Base Event que estão faltando ou verifique se as regras existentes estão corretas.
Ao analisar logs, as seguintes mensagens de erro podem ser gravadas no console:
IWAT0310E O Adaptador de Log Genérico não pôde ser iniciado devido a problemas de configuração.
IWAT0317E Erro ao construir 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 solucionar esse 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:
- Substitua emf.common_2.2.0.qualifier.jar por emf.common_2.2.0.v200606051102.jar.
- Substitua emf.ecore_2.2.0.qualifier.jar por emf.ecore_2.2.0.v200606051102.jar.