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.

  1. 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.
  2. Selecione Componente Extrator de Expressão Regular. As propriedades do Extrator são exibidas na área de janela à direita.

    o nome do extrator, a descrição e a classe executável são listados na área de janela de propriedades

  3. 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.
  4. 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.

  1. 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.

    Configuração do Sensor

  2. 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.
  3. 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.
  4. 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.
  5. Para incluir o padrão de início no resultado, marque a caixa de opções Incluir Padrão de Início.
  6. 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.
  7. 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   Figura do ícone do Reexecutar Adaptador, em seguida, clique no ícone Mostrar Log Ícone Mostrar Log. O conteúdo do log que foi lido pelo sensor é mostrado na visualização Resultado do Sensor.
  8. Salve o arquivo de configuração do adaptador para aplicar as alterações.
  9. Para testar suas regras, clique no ícone Reexecutar Adaptador  Figura do í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.
  10. Clique no ícone Mostrar Próximo Evento  Figura do ícone Mostrar Próximo Evento para ver cada um dos registros de log que foram processados pelas regras do extrator gravadas.

    Imagem das regras do extrator e os resultados da saída na visualização Resultado do Extrator com o padrão de início omitido e o padrão de fim padrão utilizado.


    Sugestão: Para alterar o número de entradas do resultado disponíveis para visualização, clique no ícone de preferências ícone de preferências do gla 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