Configurar el componente analizador para un analizador basado en reglas

El rol del analizador consiste en tomar los mensajes que ha delimitado el extractor y crear un conjunto de correlaciones de valores de cadena de caracteres para los atributos de suceso base común.

Requisitos previos:

Para configurar el componente analizador, debe configurar roles para los dos niveles de ejecución del analizador:

Proceso global

El proceso global en el componente analizador toma un conjunto de reglas de expresiones regulares globales y las aplica con respecto a los resultados de los mensajes que proporciona el extractor.

Para configurar las reglas de proceso global para el componente analizador, siga los pasos que se indican a continuación:

  1. En el panel situado a la izquierda del Editor de configuraciones de adaptador, expanda el nodo Configuración > Instancia de contexto > Analizador. En el panel situado a la derecha se muestra la información del analizador.

    Los detalles de la configuración del analizador se muestran en el panel situado a la derecha

  2. Escriba la descripción del analizador en el campo Descripción.
  3. Si los registros de anotaciones contiene símbolos de separador que delimitan los elementos de un registro, escriba el símbolo en el campo Símbolo de separador. Por ejemplo, para el registro de anotaciones de aplicación myapp, el símbolo de 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 de separador se puede especificar con la expresión regular [ ]{2}.
  4. Si los registros de anotaciones contienen elementos en un patrón de pares de nombre-valor, puede especificar el símbolo que asocia el nombre al valor en el campo Símbolo de designación. Utilizando el mismo ejemplo que anteriormente, en el registro de anotaciones myapp, el símbolo de designación es un signo de dos puntos : .

Nota: Los valores analizados durante la fase de proceso global se eliminan de los caracteres de espacios en blanco iniciales y finales. Por este motivo, se pueden escribir reglas de sustitución que utilicen valores de posición, asumiendo que los valores no tienen caracteres de espacios en blanco iniciales o finales.

Proceso de atributos

La segunda fase de ejecución del analizador aplica reglas de sustitución específicas para identificar los valores que se deben asignar a los atributos de suceso base común.

Los atributos de suceso base común siguientes son obligatorios:

Para obtener una lista completa de los elementos de suceso base común y sus atributos asociados, consulte el apartado Modelo de suceso base común.

Añadir y configurar elementos y atributos

Para añadir y configurar un elemento:

  1. En el panel situado a la izquierda del Editor de configuraciones de adaptador, seleccione Configuración > Instancia de contexto > Analizador > Suceso base común. En el panel situado a la derecha se muestra la información del suceso base común.
  2. Para añadir un elemento, pulse el botón derecho del ratón sobre el nodo Suceso base común y seleccione el elemento que desea añadir en el menú emergente. El elemento se crea debajo del nodo Suceso base común.
    En el ejemplo que se incluye más abajo, se ha añadido el elemento situation.

    El atributo situation se muestra en el panel situado a la derecha

  3. Para configurar el elemento recién añadido, pulse sobre el mismo. Las propiedades del elemento se muestran en el panel situado a la derecha.
  4. El recuadro de selección Requerido por el padre le permite especificar si este elemento debe tener un valor válido para que el elemento padre sea válido. En el ejemplo anterior, si se selecciona el recuadro de selección para el elemento situation, se indica al analizador que el objeto de suceso base común debe tener un elemento de situación válido. Durante el proceso, si el elemento situation devuelve un valor nulo, el analizador no procesa ningún otro elemento hijo del objeto de suceso base común, puesto que ya sabe que este objeto de suceso base común no es válido debido a que el elemento hijo requerido ha devuelto un valor no válido.
  5. El recuadro de selección Opción hijo le permite especificar si el proceso para este elemento se debe detener una vez que un elemento o atributo hijo válido devuelva un valor válido. Por ejemplo, en el caso del elemento situation que se ha mostrado más arriba. Tiene tres elementos hijo con sus propios subárboles. Si se selecciona el recuadro de selección Opción hijo para el elemento situation, el análisis se detiene en el primer subárbol hijo que devuelve un valor válido. Esta característica mejora considerablemente el rendimiento de análisis de elementos con varios atributos o elementos hijo.
    Nota: categoryName es un atributo obligatorio de situation, pero el Adaptador de anotaciones genérico establece categoryName en el valor adecuado si uno de los elementos de tipo de situación devuelve un valor.

Para añadir y configurar un atributo:

  1. En el panel situado a la izquierda del Editor de configuraciones de adaptador, seleccione Configuración > Instancia de contexto > Analizador > Suceso base común. En el panel situado a la derecha se muestra la información del suceso base común.
  2. Para añadir un atributo, pulse el botón derecho del ratón sobre el nodo Suceso base común y seleccione el atributo que desea añadir en el menú emergente. El atributo se crea debajo del nodo Suceso base común.
    En el ejemplo que se incluye más abajo se muestra el atributo msg añadido debajo del nodo Suceso base común.

    El atributo msg se muestra en el panel situado a la derecha

  3. Pulse el atributo para visualizar las propiedades del mismo en el panel situado a la derecha.
  4. Utilizando el elemento anterior, si no todos los registros de anotaciones contienen el atributo msg, puede seleccionar el recuadro de selección Utilizar sustitución de coincidencia anterior como valor por omisión. De este modo, se asigna el valor del último mensaje coincidente al atributo msg.
  5. Si desea establecer un valor por omisión para msg, escríbalo en el campo Valor por omisión. Este valor por omisión sólo se utiliza si no existen coincidencias o reglas de sustitución y no se ha seleccionado el recuadro de selección Utilizar sustitución de coincidencia anterior como valor por omisión, o bien, si se ha seleccionado, no existe ningún valor de coincidencia anterior guardado.
  6. El recuadro de selección Requerido por el padre para el atributo le permite especificar si este atributo tiene que tener un valor válido para que el elemento padre sea válido.

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

Para añadir una regla de sustitución al atributo de suceso base común, seleccione Atributo > Añadir > Regla de sustitución. Los detalles de la regla de sustitución se muestran en el panel situado a la derecha del editor.

  1. Se puede utilizar el campo Posiciones cuando el registro de anotaciones contiene pares de nombre-valor delimitador por un símbolo. El valor de un par de nombre-valor se puede extraer utilizando la expresión $h('nameofNameValuePair').
    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 de separator = []{2} y el símbolo de designación = : , la expresión para extraer el mensaje sería $h('message').
    Para otras aplicaciones del campo Posiciones, consulte el tema de utilización campo Posiciones.
  2. La Coincidencia especifica un patrón para buscar en el registro. Si se especifica el campo Posiciones, se busca una parte del registro, de lo contrario, se busca el patrón especificado en el registro completo. En este patrón, algunos datos se pueden agrupar utilizando paréntesis, a los que se puede hacer referencia en el campo Sustituir. Si el patrón coincide con los datos del registro, se proporciona un valor basado en el campo Sustituir al atributo de suceso base común para el que se ha escrito la regla. Si el campo Coincidencia se deja vacío, la regla se considera como una coincidencia.
    En el ejemplo del registro de anotaciones myapp, para la coincidencia del valor del mensaje que extrae el campo de posiciones se puede utilizar la expresión regular siguiente:
    ^(\w+)-(.*)
    Este patrón de coincidencia contiene dos grupos. El primer grupo es un conjunto de caracteres de palabras delante de un guión. El segundo grupo es todo lo que se incluye detrás del guión hasta el final del valor del mensaje tal como lo define la especificación del campo Posiciones.
  3. El campo Sustituir es el valor que se va a asignar al atributo de suceso base común como resultado de una coincidencia. Los valores se pueden extraer de la cadena de caracteres coincidente utilizando los literales $1, $2, y así sucesivamente, que representan los grupos definidos en el patrón de coincidencia.
    En el ejemplo del registro de anotaciones myapp, si sólo desea asignar el valor del aviso al atributo msg de suceso base común, especifique la sustitución como $2.

    Ejemplo de registro de anotaciones que se está analizando y el resultado se muestra en la vista de resultados del formateador

  4. Se puede utilizar la Clase de extensión de sustitución si se desea ejecutar la lógica de análisis personalizado en el valor coincidente con los campos Posiciones, Coincidencia y Sustituir. La clase de usuario debe implementar la interfaz del Adaptador de anotaciones genérico
    org.eclipse.hyades.logging.adapter.parsers.ISubstitutionExtension 
    para que la ejecute el Adaptador de anotaciones genérico.

  5. Se puede utilizar el campo Formato de hora para crear una regla de sustitución para el atributo creationTime. Especifique una cadena de caracteres de patrón de tiempo Java en este campo. El patrón indicado se utiliza para analizar el valor que coincide con los campos Posiciones, Coincidencia y Sustituir por medio de la clase java.text.SimpleDateFormat para generar la fecha como un valor largo. Este valor se utiliza para generar el valor de cadena de caracteres de la fecha en el formato dateTime del Esquema XML que necesita el suceso base común.
    En el ejemplo del registro de anotaciones myapp, la regla Formato de hora es la siguiente:

    Regla de ejemplo para el campo de formato de la hora utilizando la clase de formato de fecha simple de Java

  6. Aplique los cambios que ha realizado. Para ello, guarde el archivo de configuración del adaptador.
  7. Para probar las reglas, pulse Volver a ejecutar adaptador Imagen del icono Volver a ejecutar adaptador par ejecutar el adaptador. Los resultados se muestran en la vista Resultado del formateador. Sugerencia: Puede especificar el número del registro por el que desea empezar la visualización. Utilice el menú desplegable disponible en el icono Volver a ejecutar adaptador y seleccione Iniciar desde registro. Se abre un diálogo que le permite especificar un número de registro por el que empezar.
  8. Pulse el icono Mostrar suceso siguiente Imagen del icono Mostrar suceso siguiente para ver los atributos de suceso base común que se han generado utilizando las reglas que ha escrito.

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

Una vez que haya completado las reglas del analizador, puede configurar el componente productor del archivo de configuración del adaptador.

Conceptos relacionados
Visión general del Adaptador de anotaciones genérico de Hyades
Especificación del formato de suceso base común

Tareas relacionadas
Configurar el componente productor