Configurando o Componente Analisador para um Analisador com Base em Regras
A função do analisador é obter as mensagens que foram delimitadas pelo extrator
e construir um conjunto de mapeamentos de valores de cadeia para os atributos do Common Base Event.
Pré-requisitos:
Para configurar o componente analisador, é necessário configurar regras para os dois níveis de execução do analisador:
- Processamento global - um conjunto de regras globais de expressão comum é executado
para os resultados da mensagem fornecidos pelo extrator
- Processamento de atributos - conjuntos específicos de regras de substituição são executados para
determinar o valor a ser designado a cada atributo do Common Base Event especificado
no editor.
Processamento Global
O processamento global no componente analisador toma um conjunto de regras de expressão comum globais e
aplica essas regras em relação aos resultados de mensagem fornecidos pelo extrator.
Para configurar as regras de processamento global para o componente analisador, siga estas etapas:
- Na área de janela da esquerda do Editor de Configuração de Adaptador, expanda Configuração > Instância do Contexto > Analisador.
A área de janela à direita exibe as informações do analisador.

- Digite a descrição do analisador no campo Descrição.
- Se os registros de log contiverem tokens de separador que delimitam os elementos
em um registro, digite o token no campo Token de Separador.
Por exemplo, para o registro de log do aplicativo myapp, o token de separador entre os
elementos é um espaço duplo:
<14 de março de 2004 10:25:21 EST> aplicativo:myapp gravidade:3 mensagem:AVISO-arquivo style.css ausente
O token de separador pode ser especificado com a expressão comum [ ]{2}.
- Se os registros de log contiverem elementos em um padrão de pares de nome-valor,
você poderá especificar o token que associa o nome ao valor no campo
Token de Atribuição. Utilizando o mesmo exemplo que acima, no registro de log myapp, o
token de atribuição é dois-pontos : .
Nota: Os valores analisados durante a fase de processamento global serão limpos de
caracteres de espaço em branco iniciais e finais. Portanto, as regras de substituição que
usarem valores de posição podem ser criadas supondo que os valores não terão caracteres de
espaço em branco iniciais ou finais.
Processamento de Atributos
A segunda fase da execução no analisador aplica regras de substituição específicas
para identificar quais valores devem ser designados aos atributos do Common Base Event.
Os atributos do Common Base Event a seguir são obrigatórios:
- creationTime
- situation
- sourceComponentID
Para obter uma listagem completa de elementos do Common Base Event e seus atributos associados,
consulte Modelo Common Base Event.
Incluindo e Configurando Elementos e Atributos
Para incluir e configurar um elemento:
- Na área de janela à esquerda do Editor de Configuração de Adaptador, selecione Configuração > Instância do Contexto > Analisador > Common Base Event.
A área de janela à direita exibe as informações do Common Base Event.
- Para incluir um elemento, clique com o botão direito do mouse no nó
Common Base Event e selecione o elemento que deseja incluir no menu pop-up.
O elemento é criado sob o nó Common Base Event.
No exemplo a seguir,
o elemento situation é incluído.

- Para configurar o elemento recém-incluído, clique no elemento. As propriedades do elemento serão exibidas na área de janela da direita.
- A caixa de opções Exigido pelo pai permite especificar se este elemento deve ou não ter
um valor válido para que o elemento pai seja válido.
No exemplo acima, se a caixa de opções for selecionada para o elemento situation, isto indica ao analisador que o objeto do Common Base
Event deve ter um elemento situation válido. Durante o processamento, se o elemento situation
retornar um valor nulo, o analisador não processará nenhum dos outros elementos filhos do objeto Common Base
Event porque ele já saberá que este objeto Common Base Event é inválido, já que
um elemento filho exigido retornou um valor inválido.
- A caixa de opções Escolha de Filho Permite especificar se o processamento para este elemento
deve ou não parar quando um atributo ou elemento filho válido retornar um valor válido.
Por exemplo, considere o elemento situation mostrado acima. Ele tem três elementos filhos com suas próprias sub-árvores.
Se a caixa de opções Opção do filho for selecionada para o elemento situation, a análise parará na
sub-árvore de seu primeiro filho que retornar um valor válido. Esse recurso melhora significativamente o desempenho da
análise de elementos com vários elementos filhos ou atributos.
Nota:categoryName é um atributo exigido de situation mas o Adaptador de Log Genérico configurará categoryName
como o valor apropriado se um dos elementos de tipo de situação retornar um valor.
Para incluir e configurar um atributo:
- Na área de janela à esquerda do Editor de Configuração de Adaptador, selecione Configuração > Instância do Contexto > Analisador > Common Base Event.
A área de janela à direita exibe as informações do Common Base Event.
- Para incluir um atributo, clique com o botão direito do mouse no nó
Common Base Event e selecione o atributo que deseja incluir no menu pop-up.
O atributo é criado sob o nó Common Base Event.
O exemplo a seguir
mostra o atributo msg incluído sob o nó Common Base Event.

- Clique no atributo para exibir as propriedade do atributo na área de janela da direita.
- Utilizando o exemplo acima, se os registros de log não contiverem o atributo msg, você poderá
selecionar a caixa de opções Utilizar Substituição de Correspondência Anterior como Padrão. Isso
designará o valor da última mensagem correspondida ao atributo msg.
- Se você desejar um valor padrão para msg, digite o
valor no campo Valor Padrão.
Este valor padrão será utilizado apenas se nenhuma regra de substituição existir ou
corresponder e Utilizar Substituição de Correspondência Anterior como Padrão não
estiver marcado ou, se estiver marcado, não houver nenhum valor de correspondência anterior salvo.
- A caixa de opções Exigido pelo pai para o atributo permite especificar se este atributo deve ou não ter
um valor válido para que o elemento pai seja válido.
Incluindo e Configurando Regras de Substituição de Atributos
Para incluir uma regra de substituição para o atributo do Common Base Event, selecione Atributo > Incluir > Regra de Substituição.
Os detalhes da regra de substituição são exibidos na área de janela à direita do editor.
- O campo Posições pode ser utilizado quando o
registro de log contém pares de nome e valor delimitados por um token.
O valor de um par de nome e valor pode ser extraído utilizando a expressão $h('nameofNameValuePair').
Por exemplo, utilizando o mesmo registro de log do aplicativo myapp:
<14 de março de 2004 10:25:21 EST> aplicativo:myapp gravidade:3 mensagem:AVISO-arquivo style.css ausente
com o token de separador = []{2} e o token de atribuição = : ,
a expressão para extrair a mensagem seria $h('mensagem').
Para outros aplicativos do campo Posições, consulte o tópico de uso
Campo Posições.
- Corresponder especifica um padrão a procurar no registro.
Se o campo Posições for especificado, uma parte do registro será procurada,
caso contrário, o registro inteiro será procurado para o padrão especificado.
Neste padrão, certos dados podem ser agrupados utilizando
parênteses, que podem ser referidos no campo Substituir.
Se o padrão corresponder dados no registro, o atributo do
Common Base Event para o qual a regra foi criada receberá um valor com base no
campo Substituir. Se o campo Corresponder for deixado vazio, a regra será considerada uma correspondência.
No exemplo de registro de log myapp, para corresponder o valor da mensagem
extraída pelo campo Posições, a expressão regular a seguir poderá
ser utilizada:
^(\w+)-(.*)
Este padrão de correspondência contém dois grupos.
O primeiro grupo é um conjunto de caracteres de palavra antes de um traço.
O segundo grupo é tudo o que há após o traço até o final do valor da
mensagem, conforme definido pela especificação do campo Posições.
- O campo Substituir é o valor a ser designado
para o atributo do Common Base Event como um resultado de uma correspondência.
Os valores podem ser extraídos da cadeia correspondida, utilizando os literais
$1, $2, etc que representam os grupos definidos no padrão de correspondência.
No exemplo de registro de log myapp, se você apenas desejar designar o
valor do aviso ao atributo msg do Common Base Event, especifique a substituição como $2.

- A Classe de Extensão de Substituição poderá ser utilizada se você desejar
executar a lógica de análise customizada no valor correspondido pelas campos Posições,
Corresponder e Substituir.
A classe de usuário deve implementar a interface do Adaptador de Log Genérico
org.eclipse.hyades.logging.adapter.parsers.ISubstitutionExtension
para que este seja executado pelo Adaptador de Log Genérico.
- O campo Formato de Hora pode ser utilizado para criar uma regra de substituição
para o atributo creationTime.
Especifique uma cadeia de padrão de hora Java neste campo. O padrão digitado será utilizado
para analisar o valor correspondido pelos campos Posições, Corresponder e Substituir,
utilizando a classe java.text.SimpleDateFormat
para gerar a data como um valor longo.
Este valor é, então, utilizado para gerar o valor de cadeia da data no
formato dateTime do Esquema XML requerido pelo Common Base Event.
No exemplo de registro de log myapp, a regra do Formato de Hora será conforme a seguir:

- Aplique as alterações feitas, salvando o arquivo de configuração do adaptador.
- Para testar suas regras, clique em Reexecutar Adaptador
para executar o adaptador. Os resultados serão mostrados na visualização Resultado do Formatador.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 visualizar os atributos do Common Base Event gerados utilizando as regras gravadas.
Nota: Para obter informações adicionais sobre o formato de data simples do Java,
consulte o javadoc
java.sun.com/j2se/1.4.2/docs/api/java/text/SimpleDateFormat.html.
Uma vez que as regras do analisador estão concluídas, você pode configurar o componente emissor de saída do arquivo de configuração do adaptador.
Conceitos Relacionados
Visão Geral do Adaptador de Log Genérico Hyades
Especificação do Formato Common Base Event
Tarefas Relacionadas
Configurando o Componente Emissor de Saída
(C) Copyright IBM Corporation 2000, 2005. Todos os Direitos Reservados.