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 de Adaptador, expanda o nó Contextos > Contextos 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.
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.
Clique no ícone Mostrar Próximo Evento para ver cada um dos registros de log que foram processados pelas regras do extrator gravadas.

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
Especificação do Formato Common Base Event

Tarefas Relacionadas
Criando um Analisador de Log
Criando um Adaptador com Base em Regras
Configurando o Componente Analisador
Configurando a Instância do Contexto
Configurando o Componente Emissor de Saída

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