WebSphere Message Broker, Versión 8.0.0.5 Sistemas operativos: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte la información sobre la última versión del producto en IBM Integration Bus, Versión 9.0

Nodo Trace

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:

Finalidad

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 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 el registro 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 WebSphere Message Broker Toolkit por el siguiente icono:

Icono de nodo Trace

Utilización de este nodo en un flujo de mensajes

Consulte los ejemplos siguientes para ver cómo se debe utilizar este nodo:

Puede ver información sobre los ejemplos sólo cuando utilice el Information Center que está integrado en WebSphere Message Broker Toolkit o el Information Center en línea. Puede ejecutar ejemplos sólo cuando utilice el Information Center que está integrado en WebSphere Message Broker Toolkit.

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.

Cuando haya probado el flujo de mensajes y comprobado que su funcionamiento es correcto, elimine los nodos Trace del flujo de mensajes o desactívelos.

Terminales y propiedades

Cuando haya colocado una instancia del nodo Trace en un flujo de mensajes, podrá configurarlo; consulte el tema Configurar un nodo de flujo de mensajes. Las propiedades del nodo se visualizan en la vista 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 Propiedad de mandato mqsiapplybaroverride
Destino 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:
  • Para grabar el registro de rastreo en las anotaciones de error del sistema local, seleccione Anotaciones de error locales.

    La información que incluya en el registro de rastreo se graba en una de las siguientes ubicaciones:

    • Windows platformEn sistemas Windows, los datos se graban en el Registro de sucesos (vista Aplicación)
    • Linux platformUNIX platformEn sistemas Linux y UNIX, los datos se graban en syslog
    • z/OS platformEn sistemas z/OS, los datos se graban en la consola del operador

    UNIX platformEn los sistemas UNIX, las entradas de anotaciones cronológicas de sistema tienen la longitud restringida y los mensajes se truncan por el carácter de nueva línea. Para grabar una gran cantidad de datos en un registro, establezca el destino en Archivo o Rastreo de usuario.

    Si selecciona Anotaciones de error locales, indique el número del mensaje de rastreo a grabar y el catálogo de mensajes en el que está definido el mensaje.

    • Si deja Catálogo de mensajes en blanco, se utilizará el catálogo de mensajes predeterminado como origen del mensaje que se va a grabar.

      También debe entrar el número de error del registro en Número de mensaje. Los números del 3051 al 3099 están reservados para este uso en el catálogo predeterminado. En el catálogo de mensajes predeterminado, 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 exacta del error. El número de mensaje predeterminado es 3051.

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

      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 algunos sistemas, 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.

 
       
  • Para grabar el registro de rastreo en el registro de rastreo de usuario generadas por el sistema, seleccione Rastreo de usuario.

    Estos registros se graban independientemente del valor de la propiedad Rastreo de usuario para el flujo de mensajes desplegado.

    La ubicación de los registros de rastreo dependen del entorno:
    Windows platformWindows
    Si se establece la vía de acceso de trabajo mediante el parámetro -w del mandato mqsicreatebroker, la ubicación es workpath\log.
    Si no ha especificado la vía de acceso de trabajo del intermediario, la ubicación es: %ALLUSERSPROFILE%\IBM\MQSI\common\log donde %ALLUSERSPROFILE% es la variable de entorno que define el directorio de trabajo del sistema. El directorio predeterminado depende del sistema operativo.
    • En Windows XP y Windows Server 2003: C:\Documents and Settings\All Users\IBM\MQSI\common\log
    • En Windows Vista y Windows Server 2008: C:\ProgramData\IBM\MQSI\common\log
    Puede que el sistema no utilice el valor estándar; utilice %ALLUSERSPROFILE% para asegurarse de que accede a la ubicación correcta.
    Linux platformUNIX platformLinux y UNIX
    /var/mqsi/common/log
    z/OS platformz/OS
    /sistemaarchivos_componente/log

    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 el registro de rastreo.

 
       
  • Para grabar el registro del rastreo en un archivo determinado, seleccione Archivo.

    Si selecciona esta opción, también debe establecer Vía de acceso a archivo en el nombre de 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 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, el archivo se creará. No obstante, como este proceso no crea directorios, debe existir la vía de acceso completa.

    El archivo se graba como texto, en el formato especificado por la propiedad Patrón. No necesita ejecutar los mandatos mqsireadlog o mqsiformatlog en el archivo.

    Si se produce un error de escritura de archivo durante el proceso (debido, por ejemplo, a una condición de falta de espacio), se escribe un único mensaje de aviso, BIP4065, en el registro de errores del sistema local y el flujo de mensajes continua procesando mensajes sin registrar más errores. Consulte el registro de errores para obtener información sobre dicho mensaje.

  • Si no desea grabar ningún registro de rastreo, seleccione Ninguno. También puede desactivar nodos Trace.
 
Vía de acceso a archivo No   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. filePath
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.
  • Puede escribir texto sin formato que se copiará en el registro de rastreo exactamente tal como se ha entrado.
  • Puede identificar partes del mensaje para que se graben en el registro de rastreo, especificando los identificadores de campo completos entre los caracteres ${ y }. Para registrar todo el mensaje, especifique ${Root}. Otros patrones comunes son ${LocalEnvironment} ${Environment} y ${ExceptionList}. Para obtener más información, consulte Ver el árbol lógico de mensaje en la salida de rastreo.
  • Utilice las funciones de ESQL para proporcionar información adicional; por ejemplo, utilice la función CURRENT_DATE de ESQL para registrar la fecha, la hora, o ambas cosas, en que se graba el registro de rastreo.
El patrón mostrado aquí incluye algunas de las opciones que están 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. Consulte Creación de catálogos de mensajes para obtener más información.  
Número de mensaje No No 3051 Número de error del mensaje que se graba.  
Las propiedades de supervisión del nodo se describen en la siguiente tabla.
Propiedad O C Valor predeterminado Descripción
Sucesos No No Ninguno Los sucesos que se han definido para el nodo se visualizan en este separador. De forma predeterminada, no se define ningún suceso de supervisión en ningún nodo en un flujo de mensajes. Utilice Añadir, Editar y Suprimir para crear, cambiar o suprimir sucesos de supervisión para el nodo; consulte Configuración de orígenes de sucesos de supervisión utilizando propiedades de supervisión para obtener detalles.

Puede habilitar e inhabilitar sucesos que se muestran aquí seleccionando o deseleccionando el recuadro Habilitado.

Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última actualización:
        
        Última actualización: 2015-02-28 16:58:22


Tema de referenciaTema de referencia | Versión 8.0.0.5 | ac04840_