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