Utilice el nodo Trace para generar registros de rastreo que puede utilizar para supervisar el comportamiento de un flujo de mensajes.
Este tema contiene las secciones siguientes:
Los registros de rastreo pueden incorporar texto, el contenido del mensaje e información de fecha y hora que ayuden a supervisar el comportamiento del flujo de mensajes.
Puede escoger y grabar los registros en el archivo de rastreos de usuario, en otro archivo o en las anotaciones de error locales (que contienen errores y mensajes de información escritos por los demás componentes de WebSphere Message Broker). Si graba los registros en las anotaciones de error locales, puede emitir un mensaje desde el catálogo de mensajes predeterminado que se proporciona con WebSphere Message Broker o puede crear su propio catálogo de mensajes.
La operación del nodo Trace es independiente de la configuración del rastreo de usuario para el flujo de mensajes que lo contiene. En particular, los registros que el nodo Trace graba en las anotaciones de rastreo de usuario se graban aunque el rastreo de usuario no esté activo en ese momento para el flujo de mensajes.
El nodo Trace se encuentra en la bandeja Construcción de la paleta y está representado en el entorno de trabajo por el siguiente icono:
Consulte los ejemplos siguientes para ver cómo se debe utilizar este nodo:
Los ejemplos sólo pueden verse cuando se utiliza el centro de información que está integrado en el Kit de herramientas de Message Brokers.
Incluya un nodo Trace como ayuda para el diagnóstico de errores en el flujo de mensajes. Al realizar un rastreo del contenido del mensaje en diversos puntos del flujo, puede determinar la secuencia de proceso. Puede configurar el nodo Trace para registrar el contenido de un mensaje, y para comprobar la acción de un nodo específico en el mensaje. Por ejemplo, puede incluir un nodo Trace inmediatamente después de un nodo Compute para comprobar si e mensaje de salida tiene el formato esperado.
También puede utilizar el nodo Trace para proporcionar información sobre el manejo de errores dentro de los flujos de mensajes. Por ejemplo, puede utilizar este nodo para registrar anomalías en el proceso debido a errores en el contenido o el formato de un mensaje.
Elimine los nodos Trace del flujo de mensajes cuando haya probado el flujo de mensajes y haya confirmado que su funcionamiento es correcto.
Cuando haya colocado una instancia del nodo Trace en un flujo de mensajes, podrá configurarlo; consulte el apartado Configurar un nodo de flujo de mensajes. Las propiedades del nodo se visualizan en la vista Propiedades. Para visualizar las propiedades del nodo en el diálogo Propiedades, efectúe una doble pulsación en el nodo o pulse con el botón derecho del ratón sobre el nodo y pulse Propiedades. Todas las propiedades obligatorias para las que debe especificar un valor (las que no tienen un valor predeterminado definido) están marcadas con un asterisco.
Los terminales del nodo Trace se describen en la tabla siguiente.
Terminal | Descripción |
---|---|
In (de entrada) | El terminal de entrada que acepta un mensaje para que lo procese el nodo. |
Out (de salida) | El terminal de salida a través del cual se propaga el mensaje. |
Las tablas siguientes describen las propiedades de nodo. La columna con la cabecera O indica si la propiedad es obligatoria (marcada con un asterisco si tiene que entrar un valor cuando no hay definido ningún valor predeterminado); la columna con la cabecera C indica si la propiedad es configurable (puede cambiar el valor cuando añade el flujo de mensajes al archivo BAR para desplegarlo).
En la tabla siguiente se describen las propiedades de descripción del nodo Trace.
Propiedad | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Nombre de nodo | No | No | El tipo de nodo: Trace | El nombre del nodo. |
Descripción corta | No | No | Descripción breve del nodo. | |
Descripción larga | No | No | Texto que describe el propósito del nodo en el flujo de mensajes. |
En la tabla siguiente se describen las propiedades básicas del nodo Trace.
Propiedad | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Destino | Sí | No | Rastreo de usuario | El destino del registro de rastreo que graba el nodo. El Destino hace referencia al
sistema que aloja el intermediario en el que se ha desplegado el nodo Trace:
|
Vía de acceso a archivo | No | Sí | Nombre de archivo totalmente calificado en el que se graban los registros. Esta propiedad sólo es válida si Destino está establecido en Archivo. | |
Patrón | No | No | Los datos que van a incluirse en el
registro de rastreo. Cree un patrón ESQL para especificar la información que debe grabarse.
Si graba el
registro de rastreo en las anotaciones de error locales, el patrón
controla la información que se graba en el texto del número de mensaje
seleccionado. Si utiliza el catálogo de mensajes predeterminado, y un
número entre 3051 y
3099, la información del
patrón se inserta como &1 en el texto del mensaje.
El patrón siguiente ilustra algunas de las opciones disponibles. Graba una
línea de texto inicial, registra dos elementos del mensaje actual y añade
una indicación de la hora simple:
Mensaje pasado con los siguientes campos: El nombre de la tienda es ${Body.storedetailselement.storename} El total de ventas es ${Body.totalselement.totalsales} La hora es: ${EXTRACT(HOUR FROM CURRENT_TIMESTAMP)} :${EXTRACT(MINUTE FROM CURRENT_TIMESTAMP)} El registro de rastreo resultante es:
Mensaje pasado con los siguientes campos: El nombre de la tienda es 'SRUCorporation' El total de ventas es '34,98' La hora es: 11:19 Un patrón que contenga errores de sintaxis no impide el despliegue de un flujo de mensajes que contenga el nodo Trace, pero éste no grabará ningún registro de rastreo. |
|
Catálogo de mensajes | No | No | Nombre del catálogo de mensajes desde el que se
extrae el texto de error que corresponde al número de error de la excepción. El valor predeterminado (espacio en blanco) indica que el mensaje
se toma del catálogo de mensajes que se proporciona con
WebSphere Message Broker. ![]() ![]() |
|
Número de mensaje | No | No | 3051 | Número de error del mensaje que se graba. |