Windows のイベント トレースを使用する
Microsoft BizTalk Adapter for TIBCO Rendezvous は、エラー、警告、および情報メッセージを Windows イベント ビューアーに記録します。 Windows イベント トレーシング (ETW) ツールを使用すると、追加のトレース メッセージを表示できます。 ETW がアクティブになると、メッセージを受信する *.etl ファイルが作成されます。 このファイルはバイナリ形式であり、読み取るために変換する必要があります。 これを行うには、tracerpt.exe や tracedmp.exeなど、*.etl ファイルを解釈できるコンシューマー アプリケーションが必要です。 たとえば、tracerpt.exe アプリケーションは、*.etl ファイルを summary.txt と dumpfile.csvの 2 つのテキスト ファイルに変換します。
ETW コンポーネント
Windows イベント トレーシングには、次の 3 つのコンポーネントがあります。
コントローラー アプリケーション: プロバイダーをアクティブ化および非アクティブ化します (たとえば、tracelog.exe や logman.exe)。
PATH 環境変数は、tracelog.exeの場所を指すよう設定します。 これにより、BTATIBCO RendezvousTrace 呼び出しでシステム内の tracelog.exe を見つけることができます。 既定では、BTATIBCO RendezvousTrace は現在のパスを検索します。
注
tracelog.exe は Microsoft SDK から入手でき、Microsoft BizTalk Adapter for TIBCO Rendezvous によって提供されるコマンドと互換性があります。 logman.exeを使用するには、logman のドキュメントを参照してください。
コンシューマー アプリケーション: ログに記録されたイベントを読み取ります。
コンシューマー アプリケーションが etl ファイル内のイベントを読み取ることができるようにするには、Windows イベント トレーシングがそのファイルにイベントをダンプする必要があります。 通常、これはコントローラーがトレースを非アクティブ化するときに行われます。
トレースを非アクティブ化せずにコンシューマー アプリケーションを使用するには、コントローラーはリアルタイム オプション <Real time> = -rt を使用してトレースをアクティブ化する必要があります。
プロバイダー: イベントを提供します。
BizTalk Adapter for TIBCO Rendezvous には、3 つの異なるプロバイダーが含まれています。 これらは Windows Management Instrumentation (WMI) に登録されます。 ルート\WMI\EventTrace パスで登録済みプロバイダーを検索するには、WMI CIM Studio などのツールを使用できます。
BizTalk Adapter for TIBCO Rendezvous には 3 つのプロバイダーがあります。 これにより、さまざまな種類のメッセージをログに記録できます。
受信側ログ プロバイダー: <Trace 要素> スイッチは -receiver です。
-receiver を使用して、実行時にアダプターによって受信されたログからメッセージを取得します。
送信機ロギング プロバイダー: <Trace要素>のスイッチは-transmitterです。
-transmitter を使用して、実行時にアダプターによって送信されたメッセージをログから取得します。
管理ログプロバイダー—<Trace 要素>のスイッチは-managementです。
サーバー システムの参照中に生成されたログからメッセージを取得するには、 -managementを使用します。
BTATIBCORVTrace コマンド
ETW を使用するには、BizTalk Adapter for TIBCO Rendezvous コマンドを実行BTATIBCORVTrace.cmd。 このコマンドは次のように使用します。
BTATIBCORVTrace <Trace element> -start [-cir <MB>|
-seq <MB>] [-rt] logfile
BTATIBCORVTrace <Trace element> -stop
Where: <Trace 要素> (必須) はプロバイダーの種類です。
そのオプションは次のとおりです。
-トランスミッター
-受話器
-管理
-start、-stop: プロバイダーをアクティブ化または非アクティブ化します。
-cir <MB>: ファイルのサイズと種類。 -cir は循環ファイルです。 <MB>: サイズ (メガバイト単位)。
-seq <MB>: ファイルのサイズと種類。 -seq はシーケンシャル ファイルです。 <MB>: サイズ (メガバイト単位)。
-rt: リアルタイム モードをオンに設定します。
ログ ファイル: ログ ファイルの名前 (c:\rtlog.etl が既定です)。
例えば次が挙げられます。
BTATIBCORVTrace -transmitter -start -cir 10 -rt c:\log\mylog.etl
BTATIBCORVTrace -transmitter -stop