次の方法で共有

TraceView の概念

  • [アーティクル]

このトピックでは、TraceView で使用される概念について説明します。

WDK のトレース ツールに共通する概念については、「トレース ツールの概念」を参照してください。

トレース セッション グループ

TraceView を使用すると、トレース ログの表示またはリアルタイムのトレース セッションをトレース セッション グループに結合し、単一のセッションであるかのように管理できます。 トレース ログまたはセッションが同じトレース セッション グループ内にある場合、それらのメッセージは 1 つのトレース メッセージ リストに結合されます。

既定では、各トレース セッションは、そのトレース セッションのみで構成されるトレース セッション グループのメンバーです。

トレース セッション グループの作成の詳細については、「トレース セッションのグループ化」を参照してください。

ワークスペース

TraceView では、ワークスペースはトレース セッション プロパティとトレース ログ表示プロパティのセットであり、保存して再利用できます。 ワークスペースを使用すると、頻繁に使用されるログを表示したり、慎重に構成されたトレース セッションを 1 つの簡単な手順で開始したりできます。

ワークスペースには次のものが含まれます。

リアルタイム トレース セッションのワークスペースを開くと、TraceView は保存されたプロパティと構成設定を使用して新しいトレース セッションを開始します。 トレース ログの表示用にワークスペースを開くと、ログは構成したとおりに表示されます。

詳細については、「TraceView ワークスペースの使用」を参照してください。

トレース プロバイダーの指定

トレース セッションを作成するには、トレース プロバイダーを識別し、プロバイダーが生成するバイナリ トレース メッセージの書式設定手順を見つける必要があります。 この操作は次のいずれかの方法で行うことができます。

  • プロバイダーに行くソース コードの実行可能バイナリを見つけます。 TraceView では、TraceLogging イベントとマニフェスト ETW イベントを有効にして書式設定するために必要なすべての情報を抽出できます。 また、PDB シンボル ファイルの検索を試み、WPP ソフトウェア トレース プロバイダーを有効にします。

  • WPP ソフトウェア トレース プロバイダーを含むソース コードの PDB シンボル ファイルを見つけます。 TraceView は、プロバイダーを識別し、トレース メッセージを書式設定するために必要なすべての情報を PDB ファイルから抽出できます。

  • プロバイダーのコントロール GUID (.ctl) ファイルを見つけ、TMF ファイルまたは TMF ファイルが格納されているディレクトリへのパスを指定します。

  • プロバイダーの 制御 GUID を 入力し、TMF ファイルまたは TMF ファイルが格納されているディレクトリへのパスを指定します。

    プロバイダー名の前にアスタリスク (例: *SampleProvider) を入力すると、TraceView は標準アルゴリズムを使用して自動的に名前を GUID に変換します。 すべてのプロバイダーがこの標準に従っているわけではありませんが、多くのプロバイダー (例: . NET の EventSource クラスです。

  • TraceView がアセンブルする登録済みプロバイダーを一覧から選択し、TMF ファイルまたは TMF ファイルが格納されているディレクトリへのパスを指定します。

  • カーネルNT カーネル ロガー トレース セッションを選択し、トレースする 1 つ以上のオペレーティング システム イベントを選択します。

TMF 検索パスを設定し、TMF ファイル オプションを選択する

WPP プロバイダーを有効にする場合、プロバイダーの PDB シンボル ファイルがない限り、TraceView が TMF ファイルを検索できるディレクトリを指定するか、プロバイダーのトレース メッセージの TMF ファイルを検索する必要があります。

TraceView では、次の 2 つのメソッドがサポートされています。

  • トレース プロバイダーに使用する TMF ファイルがわからない場合は、[TMF 検索パスの設定] オプションを使用します。 TraceView は、指定されたディレクトリ内のすべての TMF ファイルを検索し、生成されたメッセージのメッセージ GUID を TMF ファイルの名前に一致させます。 TMF ファイルは、指定したディレクトリに配置する必要があります。 TraceView は再帰的に検索しません。

  • トレース プロバイダーに使用する TMF ファイルがわかっている場合、または必要な TMF ファイルが異なるディレクトリにある場合は、[TMF ファイルの選択] オプションを使用します。 TraceView がディレクトリ内で見つけられないため、TMF ファイルの名前がメッセージ GUID でない場合も、このオプションを使用する必要があります。

指定された TMF ファイル、または TraceView が指定したディレクトリ内で検出した TMF ファイルが、トレース プロバイダーによって生成されたトレース メッセージと一致しない場合、TraceView はメッセージの書式を設定できません。 代わりに、トレース メッセージ GUID と次のエラー メッセージが表示されます。

No Format Information found.

PDB シンボル ファイルから TMF ファイルを作成するには、コマンド プロンプト ウィンドウで Tracepdb を使用します。