Ejecución del ejemplo WebSphere Business Monitor

Antes de poder ejecutar el ejemplo debe haber importado y desplegado el ejemplo de WebSphere Business Monitor y debe haber completado las instrucciones de Ejemplo Configurar el ejemplo de WebSphere Business Monitor.

Los pasos siguientes le muestran cómo crear una aplicación de modelo de supervisión desde el modelo y un panel de instrumentos basado en el modelo.

Si encuentra cualquier tipo de problema al ejecutar el ejemplo, consulte Resolución de problemas cuando se ejecutan ejemplos en la documentación de WebSphere Message Broker.

Generar la aplicación de modelo de supervisión

Estas instrucciones se han escrito para WebSphere Business Monitor V7.0 y utilizan el modelo WBMonitorEventsModel, que se ha creado utilizando la opción para exportar información de supervisión del espacio de trabajo. Este modelo no está soportada en versiones de WebSphere Business Monitor 6.2. Si utiliza WebSphere Business Monitor 6.2, debe utilizar el modelo de supervisión ComplexContent del archivo MonitorModels.zip.

  1. Desde el kit de herramientas de WebSphere Message Broker, abra el proyecto WBMonitorEventsProject y exporte el archivo de intercambio de proyectos MonitorModels_V7.zip pulsando Exportar > General > Sistema de archivos.
  2. Inicie el Editor de modelos de supervisión (MME) en kit de herramientas de desarrollo de WebSphere Business Monitor.
  3. Importe el archivo de intercambio del proyecto MonitorModels_V7.zip en MME utilizando Importar > Otros > Intercambio de proyectos.
  4. Abra WBMonitorEvents_V7Project y seleccione WBMonitorEventsModel.mm. Si utiliza WebSphere Business Monitor 6.2, importe el archivo MonitorModels.zip y seleccione ComplexContent.mm desde el proyecto WBMonitorEvents.
  5. Pulse con el botón derecho del ratón el modelo de supervisión y, desde el menú, seleccione Generar proyectos J2EE de supervisión.
  6. En el asistente de Generar proyectos J2EE de supervisión puede conservar el nombre de proyecto predeterminado que se genera automáticamente o indicar un nombre de proyecto.
  7. Escriba el nombre de Nombre de proyecto de aplicación J2EE y pulse Finalizar.
  8. Cuando se haya completado la generación de código, conmute a la perspectiva Java.
  9. Pulse el botón derecho del ratón en el proyecto de aplicación de archivador empresarial (EAR) que se genera. Si ha utilizado el nombre de proyecto de aplicación J2EE predeterminado, el nombre es WBMonitorEventsModelApplication.
  10. Pulse el botón derecho del ratón en el proyecto de aplicación EAR generado y seleccione Exportar > Java EE > Archivo EAR. En el asistente para Exportar pulse Examinar para seleccionar el directorio de archivos y el nombre de archivo EAR al cual que debe exportar la aplicación EAR.

Instalar y configurar la aplicación de modelo de supervisión

  1. Inicie el servidor de supervisión.
  2. Abra la consola de administración del servidor de supervisión y, desde el panel de navegación, pulse Aplicaciones > Aplicación nueva y seleccione Nueva aplicación empresarial.
  3. Establezca la Vía de acceso a la aplicación nueva en la ubicación de la aplicación EAR exportada y pulse Siguiente en el resto de paneles.
  4. Revise la información de resumen y pulse Finalizar. Compruebe que el mensaje que indica que la aplicación se ha instalado satisfactoriamente.
  5. Pulse Guardar para guardar los cambios en la configuración maestra.
  6. Pulse Aplicaciones > Tipos de aplicación > Aplicaciones empresariales de WebSphere, seleccione WBMonitorEventsModelApplication y pulse Iniciar. Ahora el Estado de aplicación contiene una flecha verde.

Crear un panel de instrumentos de WebSphere Business Monitor

Estas instrucciones describen la creación de un panel de instrumentos para WebSphere Business Monitor 7.0.

Nota: si la seguridad está habilitada en el servidor de supervisión, puede que tenga que utilizar el panel Seguridad de datos de supervisión en la consola administrativa para asignar el correspondiente permiso de forma que los modelos de supervisión estén visibles en el panel de instrumentos. Para obtener más información, consulte el Este enlace se abre en una nueva ventana Centro de información de IBM WebSphere Business Process Management.

  1. Abra un navegador web y vaya a https://localhost:<WC_default_secure>/BusinessDashboard/login.jsp para abrir el gestor de espacio empresarial.
  2. En el Gestor de espacios empresariales, pulse Acciones en el banner y seleccione Crear espacio.
  3. Escriba un nombre para el nuevo espacio en el campo Nombre de espacio. Pulse Guardar.
  4. Cree una página seleccionando el icono Crear una página (+) del banner.
  5. Especifique el nombre de la página en el campo Título. Pulse Guardar.
  6. Pulse la página creada. Pulse Editar página.
  7. En el panel Widget, seleccione Instancias y pulse el icono Añadir a página (+).
  8. En el panel Instancias, seleccione Editar valores en el menú.
  9. Seleccione la página Mostrar/Ocultar.
  10. Si ve el mensaje Si no se muestran modelos de supervisor, es porque no hay modelos instalados o porque no está autorizado a ver los modelos instalados, vaya a la consola administrativa del servidor de supervisión y lleve a cabo estos pasos:
    1. Seleccione Seguridad > Seguridad de datos de supervisión y pulse Root.
    2. Resalte los modelos en el panel Modelos. Seleccione Administrador KPI y pulse Usuarios.
    3. Pulse Buscar. En la columna Disponible, seleccione el usuario que desea utilizar. Para mover el usuario a la columna Seleccionado, pulse la flecha (>) y, a continuación, pulse Aceptar.
    4. En la página Administración de la seguridad de los datos de supervisión, pulse Aceptar.
    5. Vuelva al Gestor de espacios empresariales y renueve la página. Aparecerán los modelos de supervisión instalados.
  11. Seleccione WBMonitorEventsModel en el panel "Seleccionar los contextos de supervisión para personalizarlos". Baje de nivel y seleccione TotalPurchaseOrderFlow. Seleccione todas las columnas en Disponible y pulse la doble flecha (>>) para moverlas a la columna Seleccionado.
  12. Pulse Establecer como valor predeterminado.
  13. Pulse Aceptar.
  14. Ahora añada algunos KPI:
    1. En el panel Widget seleccione KPI y pulse el icono Añadir a página (+).
    2. En el panel KPI, seleccione Editar valores en el menú.
    3. Pulse el signo más (+) que hay junto a WBMonitorEventsModel para expandir la lista de KPI.
    4. Seleccione algunos de los KPI de la lista. Por ejemplo, Total de pedidos de clientes oro, Total de pedidos de clientes habituales y Promedio de duración de la transacción TotalPurchaseOrderFlow.
    5. Pulse Aceptar.

Instalar y configurar el bean controlado por mensaje (MDB)

En este ejemplo, WebSphere MQ se configura como proveedor JMS. Debe establecer las siguientes definiciones en el gestor de colas de WebSphere Message Broker para poder configurar WebSphere MQ como proveedor JMS:

  1. Cree un escucha TCP e inícielo.
  2. Cree un canal de conexión de servidor.
  3. Ejecute el archivo MQJMS_PSQ.mqsc proporcionado por WebSphere MQ para crear las colas JMS necesarias en el gestor de colas de WebSphere Message Broker. Este archivo .mqsc está contenido en el directorio de instalación del producto WebSphere MQ en el subdirectorio java/bin. Ejecute el mandato runmqsc, por ejemplo:
    runmqsc MB8QMGR < MQJMS_PSQ.mqsc

Cuando haya completado los tres pasos anteriores para establecer las definiciones, puede configurar WebSphere MQ como proveedor JMS:

  1. Cree una fábrica de conexiones de tema:
    1. En la consola administrativa del Servidor de supervisión expanda Recursos > JMS > Proveedores JMS y seleccione un ámbito apropiado en la lista de la configuración.
    2. Bajo Recursos > JMS seleccione Fábricas de conexiones de tema y pulse Nuevo.
    3. Pulse Proveedor de mensajería de WebSphere MQ y pulse Aceptar.
    4. Especifique el nombre y el nombre JNDI en los campos Nombre y Nombre JNDI respectivamente; por ejemplo, topicConn y jms/topicConn, y pulse Siguiente > Siguiente.
    5. Especifique el nombre del gestor de colas para su gestor de colas de WebSphere Message Broker y pulse Siguiente.
    6. Establezca Transporte para Cliente.
    7. Especifique el nombre de host en el que se ejecuta el gestor de colas de WebSphere Message Broker.
    8. En el campo Puerto, especifique el número de puerto del escucha TCP que ha definido en el gestor de colas de WebSphere Message Broker.
    9. En el campo Canal, especifique el nombre del canal de conexión de servidor.
    10. Pulse Siguiente > Siguiente > Finalizar.
    11. Pulse Guardar.
  2. Cree un tema:
    1. Pulse Recursos > JMS, seleccione Temas y pulse Nuevo.
    2. Pulse Proveedor de mensajería de WebSphere MQ y pulse Aceptar.
    3. Especifique el nombre y el nombre JNDI en los campos Nombre y Nombre JNDI respectivamente; por ejemplo, topicName y jms/topicName.
    4. En el campo Nombre de tema base, especifique el nombre del tema de supervisión. Si utiliza la configuración predeterminada, el nombre de tema es $SYS/Broker/MB8BROKER/Monitoring/WBMonitorEventsExecGroup/TotalPurchaseOrderFlow.
    5. Pulse Aceptar y pulse Guardar.
  3. Instale la aplicación MDB:
    1. En el kit de herramientas de WebSphere Message Broker, exporte el archivo MDB .zip WBEventEmitterEAR y extraiga el archivo.
    2. Conmute a la consola administrativa del servidor de supervisión pulsando Aplicaciones > Aplicación nueva y seleccione Nueva aplicación empresarial.
    3. Pulse Examinar y seleccione el archivo WMBEventEmitter.ear que ha extraído del archivo .zip y, a continuación, pulse Siguiente.
    4. Seleccione Detallado - Mostrar todas las opciones y parámetros de instalación y pulse Siguiente.
    5. Pulse Continuar.
    6. Pulse Siguiente hasta que llegue a Enlazar escuchas para bean controlador por mensaje. Anote el nombre del puerto de escucha.
    7. Pulse Siguiente en el resto de pantallas; al final de la pantalla de resumen, pulse Finalizar.
    8. Guarde la definición.
  4. (Opcional) Si la seguridad está habilitada en el servidor de supervisión:
    1. Conmute a la consola administrativa del servidor de supervisión pulsando Aplicaciones > Tipos de aplicación > Aplicaciones empresariales de WebSphere.
    2. Pulse WMBEventEmitter. En Propiedades detalladas, seleccione Rol de seguridad para correlación de usuarios/grupos.
    3. Seleccione el recuadro de selección eventEmitter role, pulse Correlacionar usuarios.
    4. Pulse Buscar y en la columna Disponible, seleccione el Usuario administrativo que desee correlacionar con el rol eventEmitter. Pulse la doble flecha (>>) para mover el usuario administrativo a la columna Seleccionado y pulse Aceptar.
    5. Marque el recuadro de selección Rol eventEmitter.
    6. Pulse Aceptar y pulse Guardar.
    7. El usuario seleccionado ahora está correlacionado con el rol eventEmitter, y debe asignar el nombre de usuario y la contraseña al rol eventEmitter.
      1. Conmute a la consola administrativa del servidor de supervisión pulsando Aplicaciones > Tipos de aplicación > Aplicaciones empresariales de WebSphere.
      2. Pulse WMBEventEmitter. En Propiedades detalladas, seleccione Roles de usuario RunAs.
      3. Marque el recuadro de selección Rol eventEmitter.
      4. Escriba el nombre de usuario y la contraseña del usuario en los campos Nombre de usuario y Contraseña.
      5. Pulse Aplicar. El usuario se visualiza en el campo Nombre de usuario junto a los roles eventEmitter.
      6. Pulse Aceptar y pulse Guardar.
  5. Cree un escucha para el MDB:
    1. Pulse Servidores > Tipos de servidor > Servidores de aplicaciones de WebSphere , pulse sobre su servidor.
    2. Bajo la sección Comunicaciones, vaya a Mensajería> Servicio de escucha de mensajes > Puertos de escucha. Pulse Nuevo y escriba el nombre de escucha que ha anotado al instalar la aplicación MDB.
    3. En el campo Nombre JNDI de fábrica de conexión, escriba el nombre JNDI que ha utilizado cuando creó la fábrica de conexiones de temas; por ejemplo, jms/topicConn.
    4. En el campo Nombre JNDI de destino, escriba el nombre JNDI que se utilizó cuando se creó el tema; por ejemplo, jms/topicName.
    5. Pulse Aceptar y pulse Guardar.
    6. Reinicie el servidor.
    7. Pulse Servidores > Servidores de aplicación y pulse sobre su servidor. Bajo la sección Comunicaciones vaya a Mensajería > Servicio de escucha de mensajes > Puertos de escucha y compruebe que el puerto de escucha estén en ejecución.
    8. Bajo Aplicaciones > Aplicaciones de empresa compruebe que WMBEventEmitter esté en ejecución.

Compruebe que el tema de suceso tenga registrada una suscripción para el flujo de mensajes:

  1. Abra WebSphere MQ Explorer y amplíe el gestor de colas MB8QMGR en la carpeta Gestores de Colas.
  2. Para abrir el panel Suscripciones, efectúe una doble pulsación en Suscripciones.
  3. Pulse Renovar y compruebe que existe una suscripción con la serie de tema $SYS/Broker/MB8BROKER/Monitoring/WBMonitorEventsExecGroup/TotalPurchaseOrderFlow.

El código fuente del MDB se incluye en el archivo WMBEventEmitter.ear. Esto proporciona un ejemplo de un MDB que puede utilizarse para:

  1. Recibir mensajes de sucesos de Message Broker
  2. Enviarlos en un formato adecuado al servidor de CEI para ser procesados por Websphere Business Monitor

En los siguientes pasos se describe cómo importar WMBEventEmitter.ear en Websphere Integration Developer 7.0 permitiéndole ver, editar y recompilar el código fuente del MDB.

  1. Inicie Websphere Integration Developer y seleccione un espacio de trabajo
  2. En el menú, seleccione Archivo>Importar...>Java EE>Archivo EAR y pulse Siguiente
  3. Utilice el botón Navegar en el campo archivo EAR para seleccionar la ubicación de WMBEventEmitter.ear. Una vez seleccionado, el campo Proyecto EAR se rellenará como WMBEventEmitter. Compruebe que el campo Tiempo de ejecución de destino está lleno con el valor correspondiente a la instalación. Pulse Finalizar. Si todavía no está en la perspectiva Java EE, se le solicitará que vaya a dicha perspectiva. Pulse para hacerlo.
  4. Aparecerán dos proyectos en el espacio de trabajo, WMBEventEmitter y WMBEventEmitterEJB.
  5. Expanda WMBEventEmitterEJB>ejbModule>com.ibm.wmb.event.cbe>WMBMDBEmitterBean.java para ver el código fuente del MDB.
  6. Si ve un error con el mensaje No puede resolverse la importación de com.ibm.events, debe añadir el archivo com.ibm.events.client.jar a la vía de acceso de compilación. Para hacerlo:
    1. Pulse el botón derecho del ratón en WMBEventEmitterEJB y seleccione Vía de acceso de construcción>Configurar vía de acceso de construcción.
    2. Seleccione la página Bibliotecas y pulse Añadir JAR externos....
    3. Vaya hasta com.ibm.events.client.jar en el directorio ${WAS_INSTALL_PATH}/plugins y pulse Aceptar

Para exportar el MDB para la instalación de una aplicación:

  1. Pulse el botón derecho del ratón en el proyecto WMBEventEmitter y seleccione Exportar>Exportar...Java EE>Archivo EAR.
  2. Pulse Siguiente.
  3. Utilice el botón Examinar para definir el campo Destino y pulse Finalizar.
  4. Continúe en el paso Instale la aplicación MDB para instalar la aplicación MDB en el servidor.

Configurar orígenes de sucesos en el flujo de mensajes

Los orígenes de sucesos ya se han configurado en el flujo de mensajes. Efectúe una doble pulsación en el flujo de mensaje TotalPurchaseOrderFlow para abrir el Editor de flujos de mensajes. Pulse la paleta de flujos de mensajes. El separador Supervisión visualiza cinco orígenes de suceso que se han habilitado:

eventSummary

Cada definición de suceso contiene un separador Básico, Correlación y Secuencia. El separador Básico define el origen de los sucesos y el nombre del suceso. El separador también contiene opciones para establecer el filtro de sucesos para añadir datos de la carga útil del mensaje y de la corriente de bits del mensaje. El separador Correlación define la información de Correlación de sucesos. El separador Secuencia define la información de la Secuencia de sucesos. En este ejemplo, se utilizan los valores predeterminados para cada definición de suceso.

Se ha establecido un filtro de sucesos en cada suceso que se haya definido en el nodo InputOrder. Estos filtros suprimen sucesos de clientes de tipo GUEST.

Los datos se capturan de la carga útil del mensaje en tres de las definiciones de suceso. Algunos de los datos extraídos se utilizan después en el modelo de WebSphere Business Monitor.

InputOrderTransactionStart

Este suceso contiene los siguientes elementos simples (mostrados con datos de ejemplo) de la carga útil del mensaje de entrada:

  <PO:purchaseOrderID>11112222</PO:purchaseOrderID>
  <PO:customerID>111111</PO:customerID> 

Este suceso también contiene el siguiente elemento complejo (mostrado con datos de ejemplo) de la carga útil del mensaje de entrada:

 <PO:items>
    <PO:item>
      <PO:partNum>0239232</PO:partNum>
      <PO:productName>compost</PO:productName>
      <PO:quantity>14</PO:quantity>
      <PO:price>4.99</PO:price>
    </PO:item>
    <PO:item>
      <PO:partNum>0451481</PO:partNum>
      <PO:productName>lawnmower</PO:productName>
      <PO:quantity>10</PO:quantity>
      <PO:price>79.99</PO:price>
    </PO:item>
    <PO:item>
      <PO:partNum>0481257</PO:partNum>
      <PO:productName>spade</PO:productName>
      <PO:quantity>10</PO:quantity>
      <PO:price>19.99</PO:price>
    </PO:item>
  </PO:items>

Efectúe una doble pulsación en el nodo InputOrder MQInput. El separador Básico muestra las definiciones de XPath que se utilizan para extraer estos datos de la carga útil del mensaje en la sección Carga útil del suceso:

$Body/PO:purchaseOrder/PO:purchaseOrderID
$Body/PO:purchaseOrder/PO:customerID
$Body/PO:purchaseOrder/PO:items	

GoldOrderTotalInTerminal y RegularOrderTotalInTerminal

Ambas definiciones contienen los mismos datos de mensaje definidos en InputOrder.TransactionStart. Ambas definiciones de suceso capturan también los datos del elemento priceSummary añadido al nodo Compute ComputeTotalOrder (que se muestra con los datos de ejemplo):

 <PO:priceSummary>
   <PO:itemTotal>1069.66</PO:itemTotal>
   <PO:deliveryCharges>19.99</PO:deliveryCharges>
   <PO:discount>163.44</PO:discount>
   <PO:invoice>926.21</PO:invoice>
 </PO:priceSummary>	

Efectúe una doble pulsación en el nodo GoldOrderTotal o en el nodo RegularOrderTotal MQOutput. El separador Básico muestra las definiciones de XPath que se utilizan para extraer estos datos de la carga útil del mensaje en la sección Carga útil del suceso:

$Body/PO:purchaseOrderPriced/PO:purchaseOrderID
$Body/PO:purchaseOrderPriced/PO:customerType
$Body/PO:purchaseOrderPriced/PO:priceSummary

Habilitar la supervisión en el flujo de mensajes desplegado

  1. Si aún no ha desplegado el flujo de mensajes, hágalo utilizando el archivo de intermediario (BAR) TotalPurchaseOrderArchive.bar.
  2. Emita el siguiente mandato para habilitar la supervisión para el flujo de mensajes TotalPurchaseOrderFlow desplegado:
    mqsichangeflowmonitoring MB8BROKER -e WBMonitorEventsExecGroup 
    -f TotalPurchaseOrderFlow -c active

Enviar mensajes a través del flujo de mensajes TotalPurchaseOrderFlow

  1. En WBMonitorEventsProject, abra la carpeta Pruebas de flujo y efectúe una doble pulsación en TotalPurchaseOrderFlow_1.mbtest.
  2. Pulse Invocar flujo de mensajes.
  3. Pulse Enviar mensaje para enviar el primer mensaje de pedido de cliente a la cola de entrada de flujo de mensajes.
  4. En la ventana Ubicación de despliegue, seleccione el grupo de ejecución WBMonitorEventsExecGroup y pulse Finalizar.
  5. Repita estos pasos abriendo las Pruebas de flujo restantes y sometiendo el resto de pedidos de cliente.

Ver los sucesos en el panel de instrumentos de WebSphere Business Monitor

Abra el panel de instrumentos de WebSphere Business Monitor y conmute al panel de instrumentos que ha creado anteriormente. Puede ver los sucesos para los mensajes que ha enviado a través del flujo de mensajes TotalPurchaseOrderFlow.

Volver a la página inicial del ejemplo