Configurar el componente analizador de un analizador basado en normas

Prerrequisitos:

El cometido del analizador consiste en tomar los mensajes que el extractor ha delimitado y crear un conjunto de correlaciones de valores de serie con los atributos de Common Base Event.

Para configurar el componente analizador, es necesario configurar normas para los dos niveles de ejecución del analizador:

Proceso global - un conjunto de normas de expresiones regulares globales se ejecutan con los resultados de mensaje suministrados por el extractor.
Proceso de atributos - se ejecutan conjuntos específicos de normas de sustitución para determinar el valor que debe asignarse a cada atributo de Common Base Event especificado en el editor.

Configurar normas para el proceso global

En el panel izquierdo del editor de configuración del adaptador, seleccione Configuración > Instancia de contexto > Analizador. El panel derecho visualizará la información del analizador.
Escriba una descripción del analizador en el campo Descripción.
Si hay registros de anotaciones que contienen símbolos separadores que de.limitan los elementos dentro de un registro, escriba el símbolo en el campo Símbolo separador. Por ejemplo, para el registro de anotaciones de aplicación myapp, el símbolo separador entre los elementos es un doble espacio:
```
<March 14, 2004 10:25:21 EST>  application:myapp  severity:3  message:WARNING-file style.css missing
```
El símbolo separador puede especificarse con la expresión regular [ ]{2}.
Si hay registros de anotaciones que contienen elementos en un patrón de pares nombre-valor, puede especificar el símbolo que asocia el nombre con el valor en el campo Símbolo de designación. En el ejemplo indicado anteriormente, en el registro de anotaciones myapp el símbolo de designación es un signo de dos puntos : .

Configurar normas para el proceso de atributos

La segunda fase de ejecución del analizador se aplica a normas de sustitución específicas para identificar los valores que deben asignarse a los atributos de Common Base Event.

Añadir y configurar atributos de Common Base Event

Son necesarios los siguientes atributos de Common Base Event:

creationTime
situation
sourceComponentID

Para obtener una lista completa de los atributos de Common Base Event, consulte el Modelo de Common Base Event.

En el panel izquierdo del editor de configuración del adaptador, seleccione Configuración > Instancia de contexto > Analizador > Common Base Event. El panel derecho visualizará la información de Common Base Event.
Para añadir un atributo, pulse el nodo Common Base Event con el botón derecho del ratón y seleccione el atributo que desee añadir en el menú emergente. El atributo se crea debajo del nodo Common Base Event. En el ejemplo que figura a continuación, se añade el atributo msg.
Para configurar el atributo que acaba de añadir, pulse sobre él. En el panel derecho se visualizarán los detalles del atributo.
Siguiendo el ejemplo anterior, si no todos los registros de anotaciones contienen el atributo msg, puede marcar el recuadro de selección Utilizar sustitución coincidente anterior como valor por omisión. Con ello asignará el valor del último mensaje coincidente al atributo msg.
Si desea establecer un valor por omisión para el atributo msg, escriba el valor en el campo Valor por omisión. Este valor por omisión sólo se utilizará si no existen normas de sustitución o coincidencia y la opción Utilizar sustitución coincidente anterior como valor por omisión no está seleccionada o, si lo está, no se ha guardado ningún valor de coincidencia anterior.
Continúe añadiendo todos los atributos necesarios siguiendo los pasos anteriores.

Añadir y configurar normas de sustitución de atributos

Para añadir una norma de sustitución al atributo de Common Base Event, seleccione Atributo > Añadir > Norma de sustitución. En el panel derecho del editor se visualizarán los detalles de las normas de sustitución.

El campo Posiciones puede utilizarse cuando el registro de anotaciones contiene pares de nombre y valor delimitados por un símbolo. El valor de un par de nombre y valor puede extraerse mediante el átomo $h('nombredeParNombreValor').
Por ejemplo, utilizando el mismo registro de anotaciones de la aplicación myapp:
```
<March 14, 2004 10:25:21 EST>  application:myapp  severity:3  message:WARNING-file style.css missing
```
con el símbolo separador = []{2} y el símbolo de designación = : , el átomo de extracción del mensaje sería $h('mensaje').
Para conocer otras aplicaciones del campo Posiciones, consulte el tema relativo a la utilización del campo Posiciones.
El campo Coincidencia especifica un patrón que debe buscarse en el registro. Si se especifica el campo Posiciones, se buscará en una parte del registro; de lo contrario, el patrón especificado se buscará en todo el registro. Dentro de este patrón, ciertos datos pueden agruparse conjuntamente entre paréntesis y puede hacerse referencia a ellos en el campo Sustitución. Si el patrón coincide con datos del registro, el atributo de Common Base Event al que va destinado esta norma recibirá un valor basado en el campo Sustitución. Si se deja vacío, la norma se considerará una coincidencia.
En el ejemplo de registro de anotaciones myapp, para emparejar el valor del mensaje extraído por el campo Posiciones, puede utilizarse la siguiente expresión regular:
```
^(\w+)-(.*)
```
Este patrón de coincidencia contiene dos grupos. El primer grupo es un conjunto de caracteres de palabra antes de un guión. El segundo grupo es todo lo que sigue al guión hasta el final del valor de mensaje, según lo definido en la especificación del campo Posiciones.
El campo Sustitución es el valor que debe asignarse al atributo de Common Base Event como resultado de una coincidencia. Los valores pueden extraerse de la serie coincidente utilizando los literales $1, $2, etc., que representan los grupos definidos en el patrón de coincidencia.
En el ejemplo de registro de anotaciones myapp, si sólo desea asignar el valor del aviso al atributo msg de Common Base Event, especifique la sustitución como $2.
El campo Clase de extensión de sustitución puede utilizarse si desea ejecutar lógica de análisis personalizado en el valor emparejado por los campos Posiciones, Coincidencia y Sustitución. La clase de usuario debe implementar la interfaz de Adaptador genérico de anotaciones
```
classorg.eclipse.hyades.logging.adapter.parsers.ISubstitutionExtension 
```
para que el Adaptador genérico de anotaciones puede ejecutarla.
El campo Formato de hora puede utilizarse para crear una norma de sustitución para el atributo creationTime. Especifique una serie de patrón de hora Java en este campo. El patrón especificado se utilizará para analizar el valor emparejado por los campos Posiciones, Coincidencia y Sustitución utilizando la clase java.text.SimpleDateFormat para generar la fecha como valor de tipo long. A continuación, este valor se utiliza para generar el valor de serie de la fecha en el formato dateTime de esquema XML necesario para Common Base Event.
En el ejemplo de registro de anotaciones myapp, la norma de formato de hora será la siguiente:
Aplique los cambios realizados guardando el archivo de configuración del adaptador.
Para probar las normas, pulse el icono Reejecutar adaptador para volver a ejecutar el adaptador. El resultado se mostrará en la vista Resultado del formateador.
Pulse el icono Mostrar evento siguiente para visualizar los atributos de Common Base Event generados mediante las normas que ha escrito.

Nota: Para obtener más información acerca del formato de fecha simple de Java, consulte el javadoc java.sun.com/j2se/1.4.2/docs/api/java/text/SimpleDateFormat.html.

Una vez completadas las normas del analizador, puede configurar el componente productor del archivo de configuración del adaptador.

Conceptos relacionados
Visión general del Adaptador genérico de anotaciones Hyades
Especificación de formato de Common Base Event

Tareas relacionadas
Crear un analizador de anotaciones
Crear un adaptador basado en normas
Configurar el componente productor

Consultas relacionadas
Estructura del archivo de configuración del adaptador
Editor de configuración del adaptador
Gramática de expresiones regulares
Ejemplos de normas de sustitución