共用方式為


如何使用 Windows 的事件追蹤

Microsoft BizTalk Adapter for TIBCO Enterprise Message Service 會將錯誤、警告與資訊訊息記錄到 Windows 事件檢視器中。 您可以使用「Windows 事件追蹤」工具來查看其他追蹤訊息。 啟動 ETW 時,它會建立一個 *.etl 檔案來接收訊息。 這個檔案是二進位格式,必須經過轉換才能讀取。 若要這樣做,您必須有取用者應用程式可用來解譯 *.etl 檔案,例如 tracerpt.exe 或 tracedmp.exe。 例如,tracerpt.exe 應用程式會將 *.etl 檔案轉換成兩個文字檔:summary.txt 和 dumpfile.csv。

ETW 元件

「Windows 事件追蹤」有三個元件:

  • 控制器應用程式:啟動和停用提供者 (,例如 tracelog.exe 或 logman.exe) 。

    您會將 PATH 環境變數設定成指向 tracelog.exe 的位置。 這可確保 BTATIBCO EMSTrace 呼叫可以在系統中找到 tracelog.exe。 依照預設,BTATIBCO EMSTrace 會搜尋目前的路徑。

    注意

    tracelog.exe 可以從 Microsoft SDK 取得,且和 Microsoft BizTalk Adapter for TIBCO Enterprise Message Service 提供的命令相容。 如果要使用 logman.exe,請參閱 logman 文件。

  • 取用者應用程式:讀取記錄的事件。

    為了讓消費者應用程式能夠讀取 etl 檔案中的事件,Windows 事件追蹤必須將事件傾印到該檔案中。 此動作通常是在控制器停用追蹤後完成的。

    若要使用取用者應用程式而不停用追蹤,控制器必須使用即時選項 < [即時 > = -rt] 來啟動追蹤。

  • 提供者:提供 事件。

    BizTalk Adapter for TIBCO Enterprise Message Service 包含三種不同的提供者。 它們是在 Windows Management Instrumentation (WMI) 中註冊的。 若要在 root\WMI\EventTrace 路經中尋找已登錄的提供者,您可以使用諸如 WMI CIM Studio 這類的工具。

    BizTalk Adapter for TIBCO Enterprise Message Service 有五個提供者,可讓您記錄不同種類的訊息:

  • 接收者記錄提供者: < 追蹤元素 > 參數為 -receiver

    使用 -receiver 從配接器在執行時間收到的記錄檔中取得任何訊息。

  • 傳輸器記錄提供者: < 追蹤元素 > 參數為 -傳送器

    使用 -傳送器,從配接器在執行時間傳輸的記錄檔中取得任何訊息。

BTATIBCOEMSTrace 命令

若要使用 ETW,請執行 BizTalk Adapter for TIBCO Enterprise Message Service 命令 BTATIBCOEMSTrace.cmd。 您可以下列方式使用此命令:

BTATIBCOEMSTrace <Trace element> -start [-cir <MB>|   
    -seq <MB>] [-rt] logfile  
BTA TIBCOEMSTrace <Trace element> -stop  

其中:

  • < 需要追蹤元素 > () 是提供者的類型。

    可用選項如下:

  • -發射機

  • -接收機

  • -start、-stop:啟動或停用提供者。

  • -cir <MB >:檔案的大小和種類。 -cir 是迴圈檔案。 < MB >:大小以 MB 為單位。

  • -seq <MB >:檔案的大小和種類。 -seq 是循序檔案。 < MB >:大小以 MB 為單位。

  • -rt:設定的即時模式。

  • Logfile:c:\rtlog.etl (記錄檔的名稱是預設) 。

    例如:

BTATIBCOEMSTrace -transmitter -start -cir 10 -rt c:\log\mylog.etl  
BTATIBCOEMSTrace -transmitter -stop  

另請參閱

針對 TIBCO Enterprise Message Service 進行疑難排解