Nodo CandleMonitor


Icono del nodo CandleMonitor

El nodo CandleMonitor forma parte del producto IBM Tivoli OMEGAMON XE for Messaging: WebSphere Message Broker Monitoring. Recopila estadísticas sobre el rendimiento del flujo de mensajes y, opcionalmente, produce mensajes de suceso para la detección de OMEGAMON XE. Es un nodo de tránsito sencillo con un terminal de entrada ("in") y un terminal de salida ("out"). Un nodo CandleMonitor difunde un mensaje sin cambiarlo desde el terminal de entrada hasta el terminal de salida.

Situación del nodo CandleMonitor para supervisar estadísticas

La utilización primaria del nodo CandleMonitor consiste en producir estadísticas. Es importante situar adecuadamente el nodo en los flujos de mensajes para que los informes de estadísticas del producto de supervisión contengan datos útiles. Para obtener las mejores estadísticas, al diseñar un flujo de mensajes, un nodo CandleMonitor debería situarse justo después del nodo MQInput. El atributo "type" de un nodo situado en esta posición debería cambiarse a "input". Si desea situar únicamente un nodo CandleMonitor en un flujo de mensajes, la posición "input" es la mejor opción, dado que la mayoría de estadísticas se generan desde esta posición. Sin embargo, otra posición clave para situar el nodo es justo antes de cualquier nodo de salida, como por ejemplo el nodo MQOutput, MQReply o Publication, para permitir el cálculo de la tasa de salida. En este caso, el atributo "type" del nodo debería cambiarse a "output".

Supervisión de subflujos

De modo opcional, se pueden producir estadísticas para partes de flujos de mensajes, denominados subflujos. Un subflujo puede ser un flujo de mensajes individual incluido en un flujo de mensajes principal (Tipo I) o, únicamente un grupo de uno o más nodos en un flujo que se ha definido como un subflujo utilizando el nodo CandleMonitor (Tipo II).

Para supervisar un subflujo de Tipo I, debe situarse un nodo CandleMonitor justo después del Terminal de entrada en el flujo y otro nodo CandleMonitor justo después del Terminal de salida u otra salida del flujo. En todos estos nodos, debería asignarse el mismo valor para el atributo "subFlowName". El tipo de nodo en la ubicación de entrada debería ser "subFlowInput". El tipo de nodo en una ubicación de salida debería ser "subFlowOutput" o "output" si la salida en realidad es un nodo como, por ejemplo, MQOutput y representa el final del flujo de mensajes para un mensaje que se difunde por dicha vía de acceso.

Para supervisar un subflujo de Tipo II, debe situarse un nodo CandleMonitor al principio del subflujo deseado, con el tipo definido como "subFlowInput" el atributo "subFlowName" asignado. A continuación, debe situarse un nodo CandleMonitor al final del subflujo, con el tipo definido como "subFlowOutput" y con el mismo valor del atributo subFlowName que se ha asignado para el nodo de entrada. Si la sección del flujo de mensajes que debe supervisarse tiene varios conectores de entrada o varios conectores de salida, del mismo modo deberán añadirse varios nodos CandleMonitor con el mismo "subFlowName".

Tanto la entrada como la salida del flujo debe marcarse con nodos CandleMonitor para que se puedan calcular estadísticas válidas. Es necesario que el nodo CandleMonitor tenga el tipo "subFlowOutput" en el subflujo. No es opcional como en el caso del nodo de tipo "output" para un flujo de mensajes principal. Si el atributo "subFlowName" se establece junto con un atributo "type" con el valor "input", se supondrá que el comportamiento del nodo es una combinación del tipo "input" y del tipo "subFlowInput". Si el atributo "subFlowName" se establece junto con un atributo "type" con el valor "output", se supondrá que el comportamiento del nodo es una combinación del tipo "output" y del tipo "subFlowOutput".

Supervisión de puntos individuales de un flujo de mensajes

El nodo CandleMonitor se puede situar en cualquier otro lugar de un flujo de mensajes si sólo se desea obtener estadísticas de un único punto del flujo de mensajes y verlas en las vistas de informe Estadísticas de nodo CandleMonitor. En este caso, el atributo "type" del nodo debería tener el valor "other". Para un nodo con el atributo "type" que tenga el valor "other", se puede establecer el atributo "subFlowName", pero únicamente actúa para identificar el nodo como parte del subflujo y no afecta a las estadísticas del subflujo generadas.

Generación de sucesos de flujo de mensajes

Una utilización secundaria del nodo CandleMonitor consiste en producir sucesos de flujo de mensajes definidos por el usuario que se pueden detectar por medio de las situaciones y los informes de Sucesos de flujo de mensajes de OMEGAMON XE. Cuando se sitúa un nodo con esta finalidad, el atributo "type" debe ser "other" y el atributo "eventMessage" debe establecerse en el texto de mensaje que desea que aparezca en los informes o que se detecte en las situaciones en las que se entra este nodo. El nodo CandleMonitor también obtiene otra información sobre el suceso para ayudar a identificar la parte del flujo de mensajes afectada y el mensaje que se está procesando mientras se produce el suceso.

La situación de un nodo con la finalidad de generar sucesos de flujo de mensajes depende de la decisión del usuario, pero IBM recomienda no situar nodos con esta finalidad en partes del flujo de mensajes cuyo proceso se considere normal. Se recomienda utilizar esta función en partes de un flujo de mensajes que procese anomalías u otras condiciones que no se consideren normales y que deberían considerarse como una situación de alerta. Por ejemplo, puede situarse un nodo con esta finalidad después del terminal "failure" en el nodo MQInput. No se recomienda establecer el atributo "eventMessage" para ningún nodo de tipo "input" o "output". Asimismo, el atributo "eventMessage" sólo debería establecerse para los nodos de tipo "subFlowInput" o "subFlowOutput" que no forman parte del proceso normal (por ejemplo, en un subflujo de manejo de errores). Cualquier nodo CandleMonitor genera automáticamente sucesos para las excepciones de flujo de mensajes que detecta. Tenga en cuenta que el nodo CandleMonitor no realiza ninguna recuperación de errores puesto que se trata únicamente de un nodo de tránsito. En este caso, se trata meramente de un mecanismo de alerta.

Supervisión de horas de colas

El atributo "collectQueueTime" se aplica a los nodos de tipo "input" y permite desactivar la recopilación de estadísticas de horas de colas. Las horas de colas se calculan utilizando la fecha y hora en que se ha situado el mensaje en la cola. Si la cola de entrada para un flujo de mensajes va a contener mensajes con fechas y horas de situación en la cola que no reflejan con exactitud cuándo se ha situado el mensaje en la cola de entrada, al configurar el nodo CandleMonitor de tipo "input", el atributo "collectQueueTime" debería establecerse en "no" para que no se recopilen horas de cola para estos mensajes. Las fechas y horas de situación no son indicadores exactos cuando se conserva el contexto de origen para un mensaje durante la situación por parte de una aplicación en la cola de entrada para el flujo de mensajes. Esto sucede comúnmente cuando una aplicación traslada mensajes de una cola a otra o cuando una aplicación pasa o establece el contexto de origen para un mensaje. En particular, si la cola de entrada para el flujo de mensajes B es la cola de salida del flujo de mensajes A, el intermediario pasa el contexto de origen de modo que la fecha y hora de situación del mensaje en el flujo de mensajes B no permite calcular con exactitud la hora de la cola. El atributo "collectQueueTime" para el nodo CandleMonitor del flujo de mensajes B debería establecerse en "no".

Activación y desactivación de nodos CandleMonitor

El atributo "activateNode" permite especificar el nivel de activación del nodo CandleMonitor de modo que se pueda desactivar. El valor predeterminado es "yes" e indica que el nodo está activo (no desactivado). Para WebSphere Business Integration versión 5.0 y posterior, se puede configurar el atributo "activateNode". Esto significa que se puede establecer durante la configuración de los archivos bbar para que tenga un valor diferente para los distintos archivos bar que se utilizan, por ejemplo, para el despliegue de pruebas y producción. Además, la versión 5.0 permite promover el valor del atributo para que éste tenga el mismo valor para cada instancia del nodo CandleMonitor en un flujo de mensajes. El conjunto de valores posibles para el atributo admite la especificación de algunas reglas generales para cuando el nodo debe estar activo, como por ejemplo si debe estar activo para todos los nodos de tipo "input" o "output", pero para ningún otro. En general, cuando se configura un nodo CandleMonitor en un flujo de mensajes, debe utilizarse el valor predeterminado "yes" para facilitar la utilización del nodo durante la prueba. A continuación, durante el despliegue a un intermediario de producción, debe configurarse el valor del archivo bar para "activateNode" en el nivel que se desee y promover el atributo para cambiar de modo automático el valor de todos los nodos del flujo a dicho nivel de activación. Para versiones anteriores a la 5.0 (y también para la 5.0, si se desea), el código de plug-in de nodo CandleMonitor acepta la especificación de un valor de alteración temporal del tiempo de ejecución para el atributo "activateNode", lo cual permite diferentes niveles de activación para diferentes intermediarios. Si desea obtener más información, consulte la guía del usuario del producto.

Terminales del nodo CandleMonitor

in El terminal de entrada que acepta un mensaje para que lo procese el nodo.
out El terminal de salida al cual se difunde el mensaje.

Propiedades del nodo CandleMonitor

Atributo Valor predeterminado Descripción
type "other" Especifica el tipo de nodo CandleMonitor. Los valores válidos son:
input
En la mayoría de cálculos se utilizan estadísticas recopiladas (excepto valores "output") para todos los niveles de informe excepto para subflujo si no se proporciona subFlowName.
output
En los cálculos de recuento y de tasa de salida se utilizan estadísticas recopiladas para todos los niveles de informe excepto para subflujo si no se proporciona subFlowName.
other
Se utilizan estadísticas recopiladas sólo para informes de Estadísticas de nodo CandleMonitor. Este tipo resulta útil si se utiliza junto con el atributo eventMessage.
subFlowInput
Se utilizan estadísticas recopiladas para los cálculos de estadísticas de subflujo. Debe proporcionarse el atributo subFlowName.
subFlowOutput
Se utilizan estadísticas recopiladas para los cálculos de estadísticas de subflujo. Debe proporcionarse el atributo subFlowName.
eventMessage "" Produce un suceso cuando se inserta el nodo si el valor establecido es distinto de "".
collectQueueTime "yes" Especifica si el nodo debe recopilar horas de colas. Los valores válidos son yes y no.
subFlowName "" Especifica el nombre del subflujo del cual forma parte del nodo CandleMonitor.
activateNode "yes" Especifica el nivel de activación del nodo. Los valores válidos son:
yes
El nodo CandleMonitor está activo.
no
El nodo CandleMonitor no está activo. No producirá estadísticas ni sucesos de flujo de mensajes.
eventOnly
El nodo CandleMonitor sólo está activo si se asigna un valor distinto de "" al atributo "eventMessage". Sin embargo, no produce estadísticas; sólo produce sucesos de flujo de mensajes.
inputOutputOnly
El nodo CandleMonitor sólo está activo si el atributo "type" es "input" o "output". En estos casos, produce estadísticas. También produce sucesos de flujo de mensajes si está establecido el atributo "eventMessage".
inputOutputAndEventOnly
El nodo CandleMonitor sólo está activo si el atributo "type" es "input" o "output", o si se asigna un valor distinto de "" al atributo "eventMessage". En estos casos, produce estadísticas. También produce sucesos de flujo de mensajes si está establecido el atributo "eventMessage".

 

(C) IBM Corporation 2006. Reservados todos los derechos.