WDTF トレースの有効化と表示

  • [アーティクル]

WDTF トレースは、WDTF オブジェクト内で内部的に発生するレポート イベントを指します。 WDTF は頻繁にインストルメント化されているため、すべての WDTF オブジェクトは、実行時にトレース情報を提供します。 WDTF は、WPP ソフトウェア トレースを使用 してトレースを処理します。 この種類のトレースは、TraceView などの WDK ツールを使用して読み取ることができる標準化された形式です。 このトピックでは、Logman と Tracefmt を使用して WDTF ランタイム トレースを表示する方法について説明します。 このトピックでは、WDTF トレース レベルをプログラムで構成する方法についても説明します。

WDTFトレースを収集して保存する方法

WDTF トレースの収集を開始するには

  1. テスト コンピューターで、管理者特権 (管理者として実行) を使用してコマンド プロンプト ウィンドウを開き、次のコマンドを入力します。

    logman.exe create trace "autosession\WDTF" -p {6210f559-c7f7-4d2f-b674-4bc9315cecc7} 0xffffffff 0xff -o c:\WDTF_Traces\TraceFile.etl
reg add HKLM\SYSTEM\CurrentControlSet\Control\WMI\Autologger\WDTF /v LogFileMode /t REG_DWORD /d 1 /f
reg add HKLM\SYSTEM\CurrentControlSet\Control\WMI\Autologger\WDTF /v FileMax /t REG_DWORD /d 16 /f
reg add HKLM\SYSTEM\CurrentControlSet\Control\WMI\Autologger\WDTF /v MaxFileSize /t REG_DWORD /d 0 /f

  2. コンピューターを再起動します。

その他のオプションについては、Logman (Logman.exe) をご参照ください。 トレースシーズンの作成については、「AutoLogger セッションの設定と開始」をご参照ください。

WDTF トレースの収集を停止し、ログ ファイルを保存するには

  1. WDTF トレースの収集を停止し、次のコマンドを使用してデータ コレクターを削除できます。

    logman.exe -stop -ets WDTF
logman.exe delete "autosession\WDTF"

  2. コンピューターを再起動します。

  3. 後で分析するために、テスト コンピューターから別のコンピューターにログ ファイルをコピーします。

    収集されるETL ログ ファイルのサイズは非常に大きくなる可能性があります。 最良の結果を得るには、テスト コンピューター (c:\WDTF_Traces\TraceFile.etl など) から別のコンピューターにログ ファイルをコピーします。 その後、テスト コンピューターからログ ファイルを削除できます。

WDTF トレースを表示する方法

WDTF トレースを表示するには、ETL ファイルを書式設定する必要があります。 次の手順では、Tracefmt.exe を使用して ETL ファイルをテキストまたは CSV ファイルに変換する方法を示します。

WDTF トレースを表示するには

  1. たとえば、次のコマンドは、c:\WDTF_Traces\TraceFile.etl として保存された ETL ファイルをテキストに変換します。

    Tracefmt.exe –r http://msdl.microsoft.com/download/symbols c:\WDTF_Traces\TraceFile.etl -o OutputTxtFile.txt

  2. 次のコマンドは、c:\WDTF_Traces\TraceFile.etl として保存された ETL ファイルをコンマ区切りファイル (CSV) に変換します。

    Tracefmt.exe –r http://msdl.microsoft.com/download/symbols c:\WDTF_Traces\TraceFile.etl -csv –o OutputCsvFile.csv

  3. Excel のフィルター機能を使用して収集されたトレースをフィルター処理できるように、Microsoft Excel で CSV ファイルを開きます。 特定の期間のトレースをフィルター処理できます。 トレースをフィルター処理して、特定の WDTF コンポーネントによってログに記録されたトレースを調べることができます。

プログラムによる WDTF トレース レベルの構成

すべての WDTF オブジェクトは、実行時にトレース情報を提供します。

WDTF には、構成可能な TTraceLevel レベルのセットが用意されています。 実行時に特定のオブジェクト インスタンスの TTraceLevel を設定する方法については、ITracing::SetTraceLevel メソッドをご参照ください。

インターフェイスの既定の TTraceLevel を設定する方法については、「Windows デバイス テスト フレームワーク リファレンス」を参照してください。

各 TTraceLevel に含まれるトレースの種類の詳細については、「ITracer インターフェイス」をご参照ください。 ITracer のレジストリ TraceLevel パスを使用して、これらのレベルを自分でグローバルに構成できます。

次の表では、設定できるトレース レベルについて説明します。

Level 説明
0 オフ。 トレースは行われません。
1 低
2 中間。 このレベルは、トレースの既定のレベルです。
3 高
4 フル。 すべてのトレース情報が報告されます。
5-8 カスタム レベル。
9 オブジェクトを初期トレース レベルに戻します。

トレース コンテンツを使用してデバッグする場合は、すべてのオブジェクトに対してトレース レベルを 1 に設定し、調べるオブジェクトに対してトレース レベルをはるかに高く設定することを検討してください。

トレース レベルの詳細については、ITracer インターフェイスをご参照ください。

AutoLogger セッションの構成と開始
Logman
Tracefmt
TraceView
WPP ソフトウェア トレース