Nodo Trace

Este tema contiene las siguientes secciones:

Finalidad

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:

Icono de nodo Trace

Utilización de este nodo en un flujo de mensajes

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.

Configuración del nodo Trace

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:

  1. Establezca la propiedad Destino de modo que indique dónde escribir la salida del nodo Trace:
    • Para grabar el registro de rastreo en las anotaciones de error del sistema local, seleccione Anotaciones de error locales.

      La información que se incluye en el registro de rastreo se guarda en las siguientes ubicaciones:

      • En Windows, el registro de sucesos (vista de aplicación).
      • En UNIX, el archivo syslog.
      • En z/OS, la consola del operador.

      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.

      • Si deja Catálogo de mensajes en blanco, el catálogo de mensajes por omisión que proporciona WebSphere Business Integration Message Broker se utiliza como origen del mensaje que va a grabarse.

        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.

      • Si crea su propio catálogo de mensajes, entre el nombre de archivo completo para el catálogo en Catálogo de mensajes.

        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.

    • Si desea grabar el registro de rastreo en las anotaciones de rastreo del usuario generadas por el sistema, seleccione Rastreo de usuario.

      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 desea grabar el registro de rastreo en el archivo que desee, seleccione Archivo.

      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.

    • Si no desea crear ningún registro de rastreo, seleccione Ninguno.
  2. En Patrón, cree un patrón ESQL para especificar qué información quiere que se grabe. Si graba el registro de rastreo en las anotaciones de error locales, el patrón controla la información que se incluye en el texto del número de mensaje seleccionado. Si utiliza el catálogo de mensajes por omisión y un número entre 3051 y 3099, la información de patrón se inserta como &1 en el texto del mensaje.
    • Puede escribir texto sin formato, que se copia en el registro de rastreo exactamente a como se especifica.
    • Puede identificar las partes del mensaje que se escriben en el registro de rastreo y especificar los identificadores completos del campo entre los caracteres ${ y }. Para anotar todo el mensaje, especifique ${Root}.
    • Puede utilizar las funciones ESQL para proporcionar información adicional. Por ejemplo, puede utilizar la función CURRENT_DATE de ESQL para anotar la fecha, la hora o ambas, en el que se escribe el registro de rastreo.

    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.

  3. Seleccione Descripción en el navegador del diálogo de propiedades para entrar una descripción breve, una descripción larga o ambas.
  4. Pulse Aplicar para realizar los cambios en el nodo Trace sin cerrar el diálogo de propiedades. Pulse Aceptar para aplicar los cambios y cerrar el diálogo de propiedades.

    Pulse Cancelar para cerrar el diálogo y descartar todos los cambios realizados en las propiedades.

Terminales y 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 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   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