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

[アーティクル]
04/01/2024

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

トレースツールとは何か?
どのような場合に、WPP ソフトウェアトレースや Windows イベントトレーシング (ETW) API を使用する必要がありますか?
このセクションの内容

トレースツールとは何か?

このツールには、トレースセッションを設定、開始、更新、停止するトレースコントローラーと、セッション中に生成されたトレースメッセージを受け取り、バイナリデータをファイルや表示用に人間が読める形式に変換するトレースコンシューマーが含まれています。

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

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

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

どのような場合に、WPP ソフトウェアトレースや Windows イベントトレーシング (ETW) API を使用する必要がありますか?

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

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

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

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

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

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