ソフトウェアトレース用ツール

2025-07-18

Microsoft Windows Driver Kit (WDK) には、ソフトウェアトレース用の一連のアプリケーションとコマンドラインツールが含まれています。これらのツールは、Windows イベントトレーシング (ETW) をサポートし、Windows に含まれるトレースツールを補完するように設計されています。

トレースツールとは
WPP ソフトウェアトレースまたは Event Tracing for Windows (ETW) API を使用する必要がある場合
このセクションの内容

トレースツールとは何ですか？

ツールには、トレースセッションを構成、開始、更新、および停止するトレースコントローラーと、セッション中に生成されたトレースメッセージを受信し、バイナリデータをファイルまたは表示用の人間が判読できる形式に変換するトレースコンシューマーが含まれます。

このツールは、ユーザーモードアプリケーションやカーネルモードドライバーなど、さまざまなトレースプロバイダーをサポートします。このドライバーは、 WPP ソフトウェアトレースまたは Event Tracing for Windows (ETW) を使用してソフトウェアトレース用にインストルメント化されます。コードをインストルメント化する 2 つの方法の比較については、「 Windows 用 WPP ソフトウェアトレースとイベントトレース (ETW) を使用する場合」を参照してください。

ツールは、グローバルロガートレースセッション / NT カーネルロガートレースセッションなど、Windows に組み込まれている予約済みトレースセッションにもアクセスできます。

これらのツールの一部は、Windows Driver Kit (WDK) の tools\<Platform> サブディレクトリにあります。ここで、 <Platform> は x86 または x64 です。その他のツールは、Windows に含まれているか、WDK の bin\<Platform> サブディレクトリにあります。

WPP ソフトウェアトレースまたは Event Tracing for Windows (ETW) API を使用する必要がある場合

開発とデバッグの目的でトレースデータを主に収集する場合は、 WPP ソフトウェアトレースを使用します。他の種類のトレースには、Windows イベントトレーシング (ETW) を使用します。

WPP ソフトウェアトレース	マニフェスト/トレースロギング ETW
Windows 2000 以降でサポートされています。	Windows Vista 以降でサポートされています。
開発とデバッグのためのイベントのトレース。内部開発者を主な対象としています。	管理、運用、分析、デバッグを目的としたイベントのトレース。
ログバイナリの PDB から抽出されるイベントをデコードするために TMF ファイルが必要です。	イベントをデコードするメタデータは、ローカルバイナリまたはイベントペイロードに含まれます。
トレースプロバイダーごとにアクティブなセッションを 1 つだけ指定できます。	イベントは複数のコンシューマーに多重化できます。
メッセージ文字列はローカライズできません。	文字列はローカライズできます。
プロバイダーのセキュリティは、イベントを有効にしてデコードするために必要なコントロール GUID または TMF ファイルをそれぞれ共有しないように制限されます。	プロバイダーは ACL を適用して、そこからイベントを収集できるユーザーを制限できます。

Windows ソフトウェアトレースプリプロセッサ (WPP) マクロを使用してソフトウェアトレースをドライバーまたはアプリケーションに追加する方法については、「 WPP ソフトウェアトレース」を参照してください。

ドライバーにカーネルモード ETW API を使用する方法の詳細については、「 Windows イベントトレーシング (ETW)」を参照してください。

Windows ドライバーモデル (WDM) に Windows Management Instrumentation (WMI) 拡張機能を使用してソフトウェアトレースを任意のドライバーに追加する方法については、「 WMI イベントトレース」を参照してください。

手記 ETW と WPP では、ほとんどの種類のカーネルモードドライバーとユーザーモードアプリケーションがサポートされています。ただし、ETW と WPP は、ミニポートドライバーなど、特定の種類のドライバーでは使用できない型を使用します。特定のドライバーの種類がサポートされているかどうかを確認するには、ドライバーに基本的な WPP マクロ ( WPP_INIT_TRACING や WPP_CLEANUPなど) を追加します。使用されている型が定義されていないためにコードがコンパイルされない場合、ETW と WPP はドライバーの種類をサポートできません。