Cómo usar el seguimiento de eventos para Windows
Microsoft BizTalk Adapter para TIBCO Enterprise Message Service registra los mensajes de error, de advertencia e informativos en el Visor de eventos de Windows. Puede ver mensajes de seguimiento adicionales mediante la herramienta de seguimiento de eventos para Windows (ETW). Cuando se activa ETW, crea un archivo *.etl para recibir los mensajes. Este archivo está en formato binario y se debe convertir para poder leerse. Para ello, debe tener una aplicación de consumidor disponible para interpretar el archivo *.etl, por ejemplo, tracerpt.exe o tracedmp.exe. Por ejemplo, la aplicación tracerpt.exe convierte el archivo *.etl en dos archivos de texto: summary.txt y dumpfile.csv.
Componentes de ETW
Seguimiento de eventos para Windows tiene tres componentes:
Aplicación de controlador: activa y desactiva un proveedor (por ejemplo, tracelog.exe o logman.exe).
Configure su variable de entorno PATH para que señale la ubicación de tracelog.exe. Esto garantiza que las llamadas a BTATIBCO EMSTrace puedan localizar tracelog.exe en el sistema. De forma predeterminada, BTATIBCO EMSTrace busca la ruta de acceso actual.
Nota
tracelog.exe está disponible en el Microsoft SDK y es compatible con los comandos proporcionados por Microsoft BizTalk Adapter para TIBCO Enterprise Message Service. Para usar logman.exe, consulte la documentación de Logman.
Aplicación de consumidor: lee los eventos registrados.
Para que la aplicación de consumidor pueda leer el evento en el archivo etl, Seguimiento de eventos para Windows debe volcarlos en dicho archivo. Normalmente, esto se hace cuando el controlador desactiva el seguimiento.
Para usar la aplicación consumidor sin desactivar el seguimiento, el controlador debe activar el seguimiento con la opción en tiempo real, <Tiempo> real = -rt.
Proveedor: proporciona el evento .
BizTalk Adapter para TIBCO Enterprise Message Service incluye tres proveedores diferentes. Están registrados en el Instrumental de administración de Windows (WMI). Para encontrar los proveedores registrados en la ruta root\WMI\EventTrace, puede usar herramientas tales como WMI CIM Studio.
BizTalk Adapter para TIBCO Enterprise Message Service tiene proveedores que permiten registrar diferentes clases de mensajes:
Proveedor de registro del receptor: el <modificador del elemento> Trace es -receiver.
Use -receiver para obtener los mensajes del registro recibidos por el adaptador en tiempo de ejecución.
Proveedor de registro del transmisor: el <modificador del elemento> Trace es -transmisor.
Utilice -transmisorpara obtener los mensajes del registro transmitidos por el adaptador en tiempo de ejecución.
Comando BTATIBCOEMSTrace
Para usar ETW, ejecute el comando Adaptador de BizTalk para TIBCO Enterprise Message Service, BTATIBCOEMSTrace.cmd. Use este comando como sigue:
BTATIBCOEMSTrace <Trace element> -start [-cir <MB>|
-seq <MB>] [-rt] logfile
BTA TIBCOEMSTrace <Trace element> -stop
Donde:
<El elemento> Trace (obligatorio) es el tipo de proveedor.
Sus opciones son:
-transmitter
-Receptor
-start, -stop: active o desactive el proveedor.
-Cir <MB>: tamaño y tipo de archivo. -cir es un archivo circular. <MB>: tamaño en megabytes.
-Seq <MB>: tamaño y tipo de archivo. -seq es un archivo secuencial. <MB>: tamaño en megabytes.
-rt: establezca el modo en tiempo real activado.
Logfile: nombre del archivo de registro (c:\rtlog.etl es el valor predeterminado).
Por ejemplo:
BTATIBCOEMSTrace -transmitter -start -cir 10 -rt c:\log\mylog.etl
BTATIBCOEMSTrace -transmitter -stop