Windows のイベント トレーシングの使用

  • [アーティクル]

Microsoft BizTalk Adapter for JD Edwards OneWorld ではエラー、警告、および情報のメッセージを Windows イベント ビューアーに記録します。 その他のトレース メッセージを表示するには、Event Tracing for Windows (ETW) ツールを使用します。 ETW をアクティブにすると、メッセージ受信用の *.etl ファイルが作成されます。 このファイルはバイナリ形式であり、読み取るには変換する必要があります。 これを行うには、*.etl ファイルを解釈するために使用できるコンシューマー アプリケーションが必要です(たとえば、tracerpt.exe や tracedmp.exe)。

ETW コンポーネント

Windows イベント トレーシングには 3 つのコンポーネントがあります。

  • コントローラー アプリケーション。 プロバイダー (たとえば、tracelog.exe や logman.exe) のアクティブ化と非アクティブ化を行います。

    PATH 環境変数を、tracelog.exe の場所を指すように設定します。 これにより、BTAJDEdwardsOneWorldTrace 呼び出しでシステム内の tracelog.exe を見つけることができます。 既定では、BTAJDEdwardsOneWorldTrace は現在のパスを検索します。

    Note

    tracelog.exe は Microsoft SDK に含まれており、BizTalk Adapter for JD Edwards OneWorld で提供されるコマンドと互換性があります。 logman.exe を使用するには、logman のドキュメントを参照してください。

  • コンシューマー アプリケーション。 記録されたイベントを読み取ります。

    コンシューマー アプリケーションで .etl ファイル内のイベントを読み取るには、Windows イベント トレーシングでそれらのイベントを .etl ファイルにダンプする必要があります。 通常、これはトレースが非アクティブ化されたときに実行されます。

    トレースを非アクティブ化せずにコンシューマー アプリケーションを使用するには、コントローラーでリアルタイム オプション <Real time> = -rt を使用してトレースをアクティブ化する必要があります。

  • プロバイダー。 イベントを提供します。

    BizTalk Adapter for JD Edwards OneWorld には 5 つの異なるプロバイダーがあります。 これらは Windows Management Instrumentation (WMI) に登録されます。 root\WMI\EventTrace パス内で登録プロバイダーを検索するには、WMI CIM Studio などのツールを使用します。

    BizTalk Adapter for JD Edwards OneWorld には 5 つのプロバイダーがあり、さまざまな種類のメッセージを記録できます。

  • 受信元ログ プロバイダー: <Trace 要素>スイッチは -receiver です。

  • 受信元 CastDetails プロバイダー: <Trace 要素>スイッチは -castDetailsReceive です。

  • 送信元ログ プロバイダー: <Trace 要素>スイッチは -transmitter です。

  • 送信元 CastDetails プロバイダー: <Trace 要素>スイッチは -castDetailsTransmit です。

  • 管理ログ プロバイダー: <Trace 要素>スイッチは -management です。

    BTAJDEOneWorldTrace コマンド

    ETW を使用するには、BizTalk Adapter for JD Edwards OneWorld コマンド BTAJDEOneWorldTrace.cmd を実行します。 このコマンドは次のように使用します。

BTAJDEOneWorldTrace <Trace element> -start [-cir <MB>|   
      -seq <MB>] [-rt] logfile  
BTAJDEOneWorldTrace <Trace element> -stop

各値の説明:

  • <Trace 要素> (必須) はプロバイダーの種類です。

  • そのオプションは次のとおりです。

    • -castDetailsTransmit

    • -transmitter

    • -castDetailsReceive

    • -受信 機

    • -管理

    • -start、-stop: プロバイダーをアクティブ化または非アクティブ化します。

    • -Cir <MB>: ファイルのサイズと種類。 -cir は循環ファイルです。 <MB>: サイズ (meg 単位)。

    • -Seq <MB>: ファイルのサイズと種類。 -seq はシーケンシャル ファイルです。 <MB>: サイズ (meg 単位)。

    • -rt: リアルタイム モードをオンに設定します。

    • Logfile: ログ ファイルの名前 (c:\rtlog.etl が既定です)。

    次に例を示します。

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

参照

JD Edwards OneWorld のトラブルシューティング