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