Este tema contiene las secciones siguientes:
Utilice el nodo Trace para generar registros de rastreo que 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 grabar los registros en el archivo de rastreo de usuario, en otro archivo o en el archivo de anotaciones de error locales (que contiene los mensajes de error y de información generados 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 por omisión que se proporciona con WebSphere Message Broker o puede crear su propio catálogo de mensajes.
El funcionamiento del nodo Trace es independiente de la configuración del rastreo de usuario para el flujo de mensajes en el que reside. 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 representa en el entorno de trabajo con el siguiente icono:
Consulte los ejemplos siguientes para ver cómo puede utilizar este nodo:
Incluya un nodo Trace para facilitar el diagnosis de los errores en el flujo de mensajes. Al realizar un rastreo del contenido del mensaje en distintos puntos del flujo, puede determinar la secuencia del proceso. También 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 que el mensaje de salida tenga el formato esperado.
Elimine los nodos Trace del flujo de mensajes cuando lo haya probado y haya comprobado que su funcionamiento es correcto.
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.
Cuando haya colocado una instancia del nodo Trace en un flujo de mensajes, podrá configurarlo. Pulse el botón derecho del ratón en el nodo en la vista de editor y seleccione Propiedades. Aparecen las propiedades básicas del nodo.
Todas las propiedades obligatorias para las que ha de entrar un valor (las que no tienen definido un valor por omisión) aparecen con un asterisco en el diálogo de propiedades.
Configure el nodo Trace de la manera siguiente:
La información que haya incluido en el registro de rastreo se grabará en:
Si selecciona esta opción, debe indicar el número del mensaje de rastreo a grabar y el catálogo de mensajes en el que está definido el mensaje.
También debe entrar el número de error del registro en Número de mensaje. Los números 3051 a 3099 están reservados para ese uso en el catálogo de WebSphere Message Broker (valor por omisión). En el catálogo de mensajes por omisión, el texto de cada uno de estos mensajes es idéntico, pero si utiliza un número distinto dentro de ese rango para cada situación que rastrea, podrá identificar la causa precisa del error. El número de mensaje por omisión es 3051.
También debe entrar el número apropiado para el mensaje en el catálogo que desea grabar en las anotaciones de error locales en Número de mensaje. En algunas plataformas, los números de mensaje que terminan en 00 están reservados para uso del sistema; no incluya mensajes con números como 3100 en el catálogo de mensajes.
Los registros se grabarán independientemente del valor de la propiedad Rastreo de usuario para el flujo de mensajes desplegado.
El Rastreo de usuario se graba en el subdirectorio \log del directorio raíz (por ejemplo, el valor por omisión en Windows 2000 es c:\Archivos de programa\IBM\WebSphere Message Broker). El nombre del archivo está formado por el nombre del intermediario, el UUID del intermediario y el sufijo userTrace.bin (por ejemplo, broker.e51906cb-dd00-0000-0080-b10e69a5d551.userTrace.bin.0). Utilice los mandatos mqsireadlog y mqsiformatlog antes de consultar las anotaciones de rastreo.
Si selecciona esta opción, también debe establecer Vía de acceso a archivo en la vía de acceso totalmente calificada para el rastreo. Si no establece la vía de acceso, la ubicación del archivo dependerá del sistema. Por ejemplo, en z/OS, el archivo se crea dentro del directorio inicial del ID de servicio de intermediario.
Puede utilizar cualquier nombre para el archivo de rastreo. Por ejemplo, c:\$user\trace\trace.log.
Si especifica un archivo que no existe, el archivo se creará. No obstante, como este proceso no crea directorios, ya debe existir la vía de acceso completa.
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.
Pulse Cancelar para cerrar el diálogo y eliminar todos los cambios que ha efectuado en las propiedades.
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 del nodo; la columna con la cabecera O indica si la propiedad es obligatoria (marcada con un asterisco en el diálogo de propiedades si tiene que entrar un valor cuando no hay definido ningún valor por omisión), 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 básicas del nodo Trace.
Propiedad | O | C | Valor por omisión | Descripción |
---|---|---|---|---|
Destino | Sí | No | Rastreo de usuario | El destino del registro de rastreo grabado por el nodo. Los valores válidos son Rastreo de usuario, Archivo, Anotaciones de error locales y Ninguno. |
Vía de acceso a archivo | No | Sí | Nombre de archivo totalmente calificado en el que se graban los registros. Sólo es válido si Destino está establecido en Archivo. | |
Patrón | No | No | Los datos que van a incluirse en el 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 por omisión (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. |
En la tabla siguiente se describen las propiedades de descripción del nodo Trace.
Propiedad | O | C | Valor por omisión | Descripción |
---|---|---|---|---|
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. |