Configurar un adaptador para la supervisión de aplicaciones en tiempo real

El Adaptador genérico de anotaciones suministra una clase de productor que permite enviar los objetos Common Base Event generados por el adaptador a un agente de anotación. El Analizador de anotaciones y rastreo puede conectarse al agente de anotación para supervisar y analizar las anotaciones de la aplicación en tiempo real.

Prerrequisitos:

Para configurar el adaptador para la supervisión, siga estos pasos.

Actualizar el componente productor

Nota: Cuando se crea un archivo de configuración de adaptador, se configura para utilizar por omisión la clase CBELogOutputter. Si no ha cambiado este valor, puede pasar por alto este procedimiento.

El componente productor del archivo de configuración del adaptador debe actualizarse para utilizar la clase CBELogOutputter que escribe los objetos Common Base Event en un agente de anotación. Puede actualizar el componente productor existente o añadir uno nuevo.

Para añadir un componente productor nuevo:

  1. Para editar el archivo de configuración del adaptador, selecciónelo en el panel Navegador. Pulse el botón derecho del ratón y seleccione Abrir con > Editor de configuración de adaptador. El archivo se abrirá en el editor.
  2. En la ventana del editor de configuración del adaptador, expanda el nodo Adaptador > Configuración > Instancia de contexto.
  3. Pulse la instancia de contexto con el botón derecho del ratón y seleccione Añadir > Productor. Se creará un productor nuevo en la instancia de contexto.
  4. En el campo Tipo de productor, seleccione LoggingAgentOutputter.
  5. Pulse la propiedad agentName. En el panel de la derecha se mostrarán los detalles de la propiedad.
  6. Actualice el valor de la propiedad con el nombre del agente de anotación que desee. Este es el nombre que verá en el Analizador de anotaciones y rastreo como agente de anotación que debe supervisarse.
  7. Si desea que el productor espere antes de anotar información en la clase CBELogOutputter, añada una propiedad denominada waitUntilLoggingTime y establezca el valor de la propiedad en el tiempo en milisegundos. Para añadir la propiedad, pulse el productor recién creado con el botón derecho del ratón y seleccione Añadir > Propiedad. Se creará una propiedad nueva bajo el nodo del productor nuevo.
  8. Para habilitar la clase CBELogOutputter, es necesario crear el componente productor asociado en la Implementación de contexto básico de contextos. Abra Contextos > Contexto de implementación básica de contextos.
  9. Pulse Contexto de implementación básica de contextos con el botón derecho del ratón y seleccione Añadir > Componente. Un componente nuevo se añadirá al contexto.
  10. Configure el componente nuevo con los siguientes valores:
    Nombre: Nombre del productor en el contexto
    Descripción: Descripción de la actividad de este producto
    Clase ejecutable: org.eclipse.hyades.logging.adapter.outputters.CBELogOutputter
    Nivel de anotación: El nivel de anotación que el productor debe utilizar. El valor 0 indica que el productor no anotará mensajes. El valor 9 indica que el productor anotará mensajes de todas las gravedades. El valor recomendado es 60, que indica que sólo se anotarán los mensajes de errores muy graves.
    Cometido: Productor
    ID exclusivo: Debe señalar al productor definido en la instancia de contexto del paso 2. Utilice el botón Examinar para seleccionar el ID correcto.
  11. Guarde los cambios realizados en el archivo de configuración del adaptador.

Actualizar la instancia de contexto

Si desea que el analizador de anotaciones supervise continuamente el archivo de anotaciones, debe actualizar las propiedades de la instancia de contexto del archivo de configuración del adaptador relativas a la operación continua.

  1. Para editar el archivo de configuración del adaptador, selecciónelo en la perspectiva Navegador. Pulse el botón derecho del ratón y seleccione Abrir con > Editor de configuración de adaptador. El archivo se abrirá en el editor.
  2. En la ventana del editor, seleccione Adaptador > Configuración > Instancia de contexto. En el panel de la derecha se mostrarán los detalles de la instancia de contexto.
  3. Marque el recuadro de selección Operación continua.
  4. Configure los campos Tiempo máximo de desocupación e Intervalo de pausa según sea necesario.
  5. Guarde los cambios realizados en el archivo de configuración del adaptador.

Lanzar el proceso Java para ejecutar el adaptador

El adaptador de anotaciones que ha creado puede ejecutarse externamente desde un archivo por lotes en el entorno Windows o desde un script de shell de entornos no Windows. A continuación figuran archivos de ejemplo que pueden utilizarse para lanzar el proceso Java que ejecutará el adaptador de anotaciones.
Nota: Para ejecutar el Adaptador genérico de anotaciones en un sistema, éste debe tener instalado Hyades.

Archivo por lotes Windows:

@rem USAGE:  runregex
@rem Cambie las siguientes líneas para señalar al directorio en el que ha descomprimido el entorno de ejecución
@rem y al directorio en el que reside el adaptador de anotaciones
SET HYADES_HOME=d:\hyades\eclipse\plugins
SET YOUR_ADAPTER_DIRECTORY=MyAdapterDirectory
SET CONFIG_FILE=%HYADES_HOME%\%YOUR_ADAPTER_DIRECTORY%\myadapter.adapter
PUSHD %HYADES_HOME%\%YOUR_ADAPTER_DIRECTORY%
java -classpath "%HYADES_HOME%\org.eclipse.hyades.logging.adapter\hgla.jar;%HYADES_HOME%\org.eclipse.hyades.execution.remote\hexr.jar;%HYADES_HOME%\org.eclipse.hyades.logging.core\hlevents.jar;%HYADES_HOME%\org.eclipse.hyades.logging.core\hlcore.jar;%HYADES_HOME%\org.apache.jakarta_oro\jakarta-oro.jar;%HYADES_HOME%\org.apache.xerces\xercesImpl.jar;%HYADES_HOME%\org.apache.xerces\xmlParserAPIs.jar" org.eclipse.hyades.logging.adapter.Adapter -ac "%CONFIG_FILE%" -cc "%CONFIG_FILE%"
POPD
Archivo por lotes no Windows:
#!/bin/sh
# USAGE:  runregex_example.sh
# Cambie las siguientes líneas para señalar al directorio en el que ha descomprimido el entorno de ejecución
HYADES_HOME=/home/eclipse/GenericLogAdapter
export HYADES_HOME
YOUR_DIRECTORY=/yourdirectory
export YOUR_DIRECTORY

CONFIG_FILE=$HYADES_HOME/$YOUR_DIRECTORY/myadapter.adapter
export CONFIG_FILE

CUR_DIR=`pwd`
export CUR_DIR

cd $HYADES_HOME/$YOUR_DIRECTORY

java -classpath $HYADES_HOME%\org.eclipse.hyades.logging.adapter\hgla.jar;$HYADES_HOME%\org.eclipse.hyades.execution.remote\hexr.jar;$HYADES_HOME%\org.eclipse.hyades.logging.core\hlevents.jar;$HYADES_HOME%\org.eclipse.hyades.logging.core\hlcore.jar;$HYADES_HOME%\org.apache.jakarta_oro\jakarta-oro.jar;$HYADES_HOME%\org.apache.xerces\xercesImpl.jar;$HYADES_HOME%\org.apache.xerces\xmlParserAPIs.jar" org.eclipse.hyades.logging.adapter.Adapter -ac "%CONFIG_FILE%" -cc "%CONFIG_FILE%"

cd $CUR_DIR
Configure el archivo según sea necesario para lanzar el proceso Java que ejecutará el adaptador.

Supervisar las anotaciones de aplicación en tiempo real

Ahora está preparado para supervisar las anotaciones de aplicación en tiempo real.

  1. Asegúrese de que la anotación está habilitada en las preferencias.
    1. En la barra de herramientas principal, seleccione Ventana > Preferencias . Se abrirá el asistente Preferencias.
    2. Seleccione Perfilado y anotación en el panel izquierdo. Las preferencias de perfilado y anotación se cargarán en el panel derecho.
    3. Seleccione Habilitar anotación en Opciones de perfilado y anotación.

      Recuadro de selección Habilitar anotación marcado en el panel de preferencias de perfilado y anotación

    4. Seleccione Aceptar para aplicar los cambios.
  2. En la perspectiva Perfilado y anotación, pulse el icono Perfilado Icono de la herramienta de perfilado en la barra de herramientas y seleccione Perfilar. Se abrirá el asistente Perfilar.
  3. Seleccione Conectar - Proceso Java y pulse el botón Nuevo situado al final de la lista. Se creará una configuración de proceso Java nueva.
  4. Pulse la pestaña Sistemas principales y seleccione el sistema principal en el que residen las anotaciones de aplicación.
    Nota: Para supervisar anotaciones de aplicación en tiempo real, el motor de recogida de datos de Hyades debe estar en ejecución en el mismo sistema que la aplicación.
  5. Pulse la pestaña Agentes y utilice las teclas de flecha para seleccionar el agente de anotación que ha configurado.

    En el asistente de preferencias de perfilado, el agente de anotación creado por el usuario se encuentra en el panel izquierdo

  6. Pulse Aplicar.
  7. Pulse Ejecutar para conectarse al agente de anotación.
  8. En la vista Supervisor de perfilado de la perspectiva Perfilado y anotación, seleccione el agente de anotación.
  9. Pulse el agente con el botón derecho del ratón y seleccione Iniciar supervisión.
  10. Pulse el agente con el botón derecho del ratón y seleccione Abrir con > Vista Anotaciones. Los eventos de anotaciones de las anotaciones de aplicación se cargarán en la vista Anotaciones.

 

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

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