Configurando o Componente Extrator para um Analisador com Base em Regras
Pré-requisitos:
Em um analisador de log com base em regras, a função do extrator é extrair
uma coleção de linhas de entrada fornecidas pelo sensor e separá-las
em limites de mensagens. Para configurar o extrator, você precisa primeiro
determinar a classe de extrator a ser utilizada. Em seguida, você pode configurar as regras do Extrator com base na
classe de extrator selecionada.
Configurando a Classe de Extrator
A classe de extrator padrão utilizada é um extrator de expressão
comum. Você pode alterar a classe de extrator, modificando o componente Extrator
na seção Contextos do Arquivo de Configuração do Adaptador.
- No Editor de Configuração do Adaptador, expanda o nó Contextos > Contexto de Implementação de Contexto Básico.
Os detalhes da Implementação de Contexto Básico são mostrados na área de janela à direita.
- Selecione Componente Extrator de Expressão Regular. As propriedades do Extrator são exibidas na área de janela
à direita.

- Atualize a classe executável para a classe que você deseja utilizar. Para obter detalhes, consulte o tópico de referência
Estrutura do Arquivo de Configuração para as classes de extrator fornecidas pelo Adaptador de Log Genérico.
- Salve as alterações do arquivo de configuração do adaptador.
Configurando as Regras do Extrator
Depois de determinar a classe de extrator a ser utilizada, você pode gravar regras
correspondentes para o extrator na instância do contexto.
- Na área de janela à esquerda do Editor de Configuração de Adaptador, selecione Configuração > Instância do Contexto > Extrator.
A área de janela à direita exibe as informações do extrator.

- Se o arquivo de log contiver registros que se estendem por várias linhas no arquivo,
selecione a caixa de opções Contém Quebras de Linha. Não selecione esta caixa de opções se cada linha
no arquivo de log for um registro separado ou se não houver quebras de linha no arquivo de log.
- Se você desejar substituir as quebras de linha com um símbolo alternativo,
selecione Substituir Quebras de Linha e
digite o símbolo no campo Símbolo de Quebra de Linha.
Nota: O efeito colateral de usar essa opção é que os valores analisados do arquivo de log não conterão quebras de linha a menos que sejam incluídas explicitamente pelas regras de substituição do analisador.
- Grave um fragmento de script no campo Padrão de Início para identificar o
padrão de início. A expressão comum padrão é o símbolo ^ (circunflexo), que é um
token nulo correspondente ao início de uma cadeia ou linha.
- Para incluir o padrão de início no resultado, marque a caixa de opções
Incluir Padrão de Início.
- Grave um fragmento de script
no campo Padrão de Fim para identificar o padrão de fim. A
expressão comum padrão é o símbolo $ (dólar), que é um token
nulo correspondente ao fim de uma cadeia ou linha.
- Para incluir o padrão de fim no resultado, selecione a caixa de opções
Incluir Padrão de Fim.
Dica: Para ajudar a identificar os padrões de início e de fim, clique no ícone Reexecutar
,
em seguida, clique no ícone Mostrar Log
. O conteúdo do log que foi lido pelo sensor é mostrado na visualização Resultado do Sensor.
- Salve o arquivo de configuração do adaptador para aplicar as alterações.
- Para testar suas regras, clique no ícone Reexecutar Adaptador
para executar o adaptador. Os resultados serão mostrados na visualização Resultado do Extrator.
Sugestão: Você pode especificar o número do registro a partir do qual deseja iniciar a visualização. Use o drop down disponível a partir do ícone Reexecutar do adaptador
e selecione Iniciar do registro.Isso abrirá um diálogo que permite especificar um número de registro de início.
- Clique no ícone Mostrar Próximo Evento
para ver cada um dos registros de log que foram processados pelas regras do extrator gravadas.
Sugestão: Para alterar o número de entradas do resultado disponíveis para visualização,
clique no ícone de preferências
do Adaptador de Log Genérico
para ativar a página de preferências. Quando a página de preferências for ativada, atualize o tamanho do buffer.
Para obter uma descrição detalhada das propriedades do extrator, consulte o documento de referência
Estrutura do Arquivo de Configuração do Adaptador.
A próxima etapa na criação de um adaptador com base em regras é configurar o componente analisador.
Conceitos Relacionados
Visão Geral do Adaptador de Log Genérico Hyades
Tarefas Relacionadas
Configurando o Componente Analisador
Referências Relacionadas
Estrutura do Arquivo de Configuração do Adaptador
Editor de Configuração de Adaptador
Gramática de Expressão Comum
Limitações do Editor de Configuração de Adaptador
(C) Copyright IBM Corporation 2000, 2005. Todos os Direitos Reservados.