Este tema contiene las siguientes secciones:
Utilice el nodo Trace para generar registros de rastreo que puedan incorporar texto, contenido del mensaje e información de fecha y hora, para ayudarle a supervisar el comportamiento del flujo de mensajes.
Puede grabar los registros en el archivo de rastreo de usuario, en otro otro archivo o en las anotaciones de error locales (que contiene mensajes informativos y de error escritos por todos los demás componentes de WebSphere Business Integration Message Broker). Si graba los rastreos en las anotaciones de error locales, puede emitir un mensaje del catálogo de mensajes por omisión que se proporciona con WebSphere Business Integration Message Broker o puede crear su propio catálogo de mensajes.
El funcionamiento del nodo Trace es independiente del valor del rastreo de usuario para el flujo de mensajes en el que reside. En concreto, los registros que el nodo Trace graba en las anotaciones de rastreo de usuario se graban aunque el rastreo de usuario no esté activo actualmente para el flujo de mensajes.
El nodo Trace se representa en el área de trabajo por el icono siguiente:
Consulte el ejemplo siguiente para ver cómo puede utilizar este nodo:
La inclusión de un nodo Trace le ayudará en el diagnóstico de errores en el flujo de mensajes. Mediante el rastreo del contenido del mensaje en distintos puntos del flujo, se puede determinar la secuencia del proceso. También puede configurar el nodo Trace para registrar el contenido del mensaje y 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 tiene el formato esperado.
Elimine los nodos Trace del flujo cuando haya comprobado que funciona correctamente.
También puede utilizar el nodo Trace para suministrar información en el manejo de errores dentro de los flujos de mensajes. Por ejemplo, puede utilizar este nodo para anotar anomalías en el proceso debido a errores en el contenido del mensaje o en el formato.
Después de transferir una instancia del nodo Trace a un flujo de mensajes, puede configurarla. Pulse el botón derecho del ratón en el nodo en la vista de editor y seleccione Propiedades. Se visualizan las propiedades básicas de nodo.
Todas las propiedades obligatorias para las que se debe entrar un valor (las que no tienen definido un valor por omisión) se marcan con un asterisco en el diálogo de propiedades.
Configure el nodo Trace como se describe a continuación:
La información que se incluye en el registro de rastreo se guarda en las siguientes ubicaciones:
Si selecciona esta opción, debe indicar el número del mensaje de rastreo que debe grabarse y el catálogo de mensajes en el que se define el mensaje.
También debe entrar el número de error del registro en Número de mensaje. Los números entre 3051 y 3099 se reservan en el catálogo (por omisión) de WebSphere Business Integration Message Broker para este uso. El texto de cada uno de estos mensajes del catálogo de mensajes por omisión es idéntico, aunque si utiliza un número distinto de este rango para cada situación que rastrea, puede identificar la causa exacta del error. El número de mensaje por omisión es 3051.
En Número de mensaje también debe especificar el número adecuado para el mensaje del catálogo que desea grabar en las anotaciones de error locales. En algunas plataformas, los números de mensaje que terminan en 00 están reservados para el sistema; no incluya mensajes con números como 3100 en el catálogo de mensajes.
Estos registros se graban sin tener en cuenta el valor de la propiedad Rastreo de usuario para el flujo de mensajes difundido.
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 Business Integration Message Broker). El nombre de archivo está compuesto 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 ver las anotaciones de rastreo de usuario.
Si selecciona esta opción, también debe establecer Vía de acceso a archivo con el nombre de vía de acceso completa 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 del intermediario.
Puede utilizar cualquier nombre para el archivo de rastreo. Por ejemplo, c:\$user\trace\trace.log.
Si especifica un archivo que no existe, éste se crea. Sin embargo, este proceso no crea los directorios, lo que significa que ya deben existir.
El patrón siguiente muestra 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 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 tienda es 'SRUCorporation' El total de ventas es '34.98' La hora es: 11:19
Un patrón que contiene errores de sintaxis no impide la difusión del flujo de mensajes que contenga un nodo Trace, aunque el nodo no grabará ningún registro de rastreo.
Pulse Cancelar para cerrar el diálogo y descartar todos los cambios realizados en las propiedades.
Los terminales de nodo Trace se describen en la tabla siguiente.
Terminal | Descripción |
---|---|
Terminal de entrada | Terminal de entrada que acepta un mensaje para que el nodo lo procese. |
Terminal de salida | Terminal de salida a través del que se propaga el mensaje. |
En las siguientes tablas se 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 se debe entrar un valor cuando no se ha definido ningún valor por omisión), la columna con la cabecera C indica si la propiedad es configurable (se puede cambiar el valor cuando se añade el flujo de mensajes al archivo bar para difundirlo).
Las propiedades básicas del nodo Trace se describen en la siguiente tabla.
Propiedad | O | C | Valor por omisión | Descripción |
---|---|---|---|---|
Destination | Sí | No | Rastreo de usuario | El destino del registro de rastreo grabado por el nodo. Las opciones válidas son Rastreo de usuario, Archivo, Anotaciones de error locales y Ninguno. |
Vía de acceso a archivo | No | Sí | Nombre completo del archivo en el que se graban los registros. Sólo es válido si Destino se establece en Archivo. | |
Patrón | No | No | Datos que deben incluirse en el registro de rastreo. | |
Catálogo de mensajes | No | No | Nombre del catálogo de mensajes del que se extrae el texto del error para el número de error de la excepción. El valor por omisión (blanco) indica que el mensaje se extrae del catálogo de mensajes proporcionado con WebSphere Business Integration Message Broker. | |
Número de mensaje | No | No | 3051 | Número de error del mensaje que se escribe. |
Las propiedades de descripción del nodo Trace se describen en la siguiente tabla.
Propiedad | O | C | Valor por omisión | Descripción |
---|---|---|---|---|
Descripción corta | No | No | Breve descripción del nodo. | |
Descripción larga | No | No | Texto que describe la utilidad del nodo en el flujo de mensajes. |
Conceptos relacionados
Flujos de mensajes
Depurador de flujos
Tareas relacionadas
Cómo decidir los nodos que utilizar
Manejo de errores en flujos de mensajes
Edición de propiedades configurables
Diagnóstico de errores
Referencia relacionada
Nodo Throw
Nodo TryCatch
Anotaciones de error locales
Rastreo de usuario
Avisos |
Marcas registradas |
Descargas |
Biblioteca |
Soporte |
Información de retorno (feedback)
![]() ![]() |
ac04840_ |