TraceView の制御コマンド

  • [アーティクル]

Note

TraceView コマンド ライン オプションは非推奨です。 tracepdb.exe と tracefmt.exe を使用して PDB を TMF ファイルに解析し、.etl ファイルをテキストに解析します (respectively.content)。

Traceview コントロール コマンドを使用して、セッションの開始と停止、プロバイダーの有効化と無効化、トレース セッションのプロパティの更新、トレース バッファーのフラッシュなど、トレース セッションを管理します。

    traceview {-start | -stop | -update | -enable | -disable | -flush | -q} SessionName [Parameters]

    traceview {-enumguid | -l | -h | -x}

コマンド パラメーター

アクション

操作​​ 説明
-start 指定したトレース セッションを開始します。
- 中止 指定したトレース セッションを停止します。
-update 指定したトレース セッションのプロパティを更新します。
-enable 指定したトレース セッションのプロバイダーを有効にします。
-disable 指定したセッションのプロバイダーを無効にします。
-flush 指定したトレース セッションのアクティブ バッファーをフラッシュします。 この強制フラッシュは、バッファーがいっぱいになったときやトレース セッションが停止する際に発生する自動フラッシュに加えて行われます。
-q 指定したトレース セッションの状態を照会します。
-enumguid Windows イベント トレーシング (ETW) に登録されているシステム上のプロバイダーを一覧表示します。
-l コンピューターで実行されているすべてのトレース セッションを一覧表示します。
-x すべてのトレース セッションを停止します。

パラメーター

SessionName
-start と共に使用する場合、SessionName はトレース セッションを表すために選択した名前です。 その他すべてのコマンドを使用して、 SessionName はトレース セッションを識別します。

-f [LogFile]
-start と共に使用すると、-f はトレース ログ セッションを開始します。 LogFile は、イベント トレース ログ (.etl) ファイルのパス (省略可能) とファイル名を指定します。 既定値は C:\LogFile.etl です。

-update と共に使用すると、-f はすべての新しいトレース メッセージを指定されたトレース ログにのみ送信します。 このパラメーターを使用して、リアルタイム トレース セッションをトレース ログ セッションに変換するか、既存のトレース ログ セッションの新しいトレース ログを開始します。 トレース メッセージをリアルタイム トレース コンシューマーとトレース ログに送信するには、-update コマンドで -rt パラメーターと -f パラメーターの両方を使用します。

-rt
-start と共に使用すると、-rt はリアルタイム トレース セッションを開始します (トレース ログ セッション (-f) が既定です)。 -start コマンドで -rt および -f を使用すると、トレース・メッセージはトレース・コンシューマーおよびイベント・トレース・ログ・ファイルに送信されます。

update と共に使用すると、-rt はトレース ログ セッションにリアルタイムメッセージ配信を追加します。 すべての新しいトレース メッセージは、トレース ログに加えて、(リアルタイム トレース セッションのように) トレース コンシューマーに 直接送信されます。

-guid {#GUID | GUIDFile}
1 つ以上のトレース プロバイダーを指定します。 トレース セッションのプロバイダーを有効にするには、-start と共に使用します。 プロバイダーを有効にしたり、-flag または -level 値を変更したりするには、-enable と共に使用します。 無効にするプロバイダーを指定するには、-disable と共に使用します。

GUID では、1 つ以上のトレース プロバイダーのコントロール GUID を含む 1 つの コントロール GUID (番号記号 (#)) またはテキスト ファイルのパス (省略可能) とファイル名 (コントロール GUID (.ctl) ファイルなど) を指定できます。

-start コマンドから -guid パラメーターを省略すると、TraceView は NT カーネル ロガー トレース セッションを開始します。

TraceView は、指定されたプロバイダーに次のサブパラメーターの値を渡します。

パラメーター 説明
SessionName -start と共に使用する場合、SessionName はトレース セッションを表すために選択した名前です。 その他すべてのコマンドを使用して、 SessionName はトレース セッションを識別します。
-f \[LogFile\]

-start と共に使用すると、-f はトレース ログ セッションを開始します。 LogFile は、イベント トレース ログ (.etl) ファイルのパス (省略可能) とファイル名を指定します。 既定値は C:\\LogFile.etl です。

-update と共に使用すると、-f はすべての新しいトレース メッセージを指定された [トレース ログ](trace-log.md) にのみ送信します。 このパラメーターを使用して、リアルタイム トレース セッションをトレース ログ セッションに変換するか、既存のトレース ログ セッションの新しいトレース ログを開始します。 トレース メッセージをリアルタイム トレース コンシューマーとトレース ログに送信するには、-update コマンドで -rt パラメーターと -f パラメーターの両方を使用します。
-rt

-start と共に使用すると、-rt はリアルタイム トレース セッションを開始します (トレース ログ セッション (-f) が既定です)。 -start コマンドで -rt および -f を使用すると、トレース・メッセージはトレース・コンシューマーおよびイベント・トレース・ログ・ファイルに送信されます。

update と共に使用すると、-rt はトレース ログ セッションにリアルタイムメッセージ配信を追加します。 すべての新しいトレース メッセージは、[trace log](trace-log.md)に加えて、(リアルタイム トレース セッションのように) トレース コンシューマーに 直接送信されます。
-guid {\#GUID | GUIDFile}

1 つ以上のトレース プロバイダーを指定します。 トレース セッションのプロバイダーを有効にするには、-start と共に使用します。 プロバイダーを有効にしたり、-flag または -level 値を変更したりするには、-enable と共に使用します。 無効にするプロバイダーを指定するには、-disable と共に使用します。

GUID では、1 つ以上のトレース プロバイダーのコントロール GUID を含む 1 つの コントロール GUID (番号記号 (\#)) またはテキスト ファイルのパス (省略可能) とファイル名 (コントロール GUID (.ctl) ファイルなど) を指定できます。

-start コマンドから -guid パラメーターを省略すると、TraceView は [NT カーネル ロガー トレース セッション](nt-kernel-logger-trace-session.md) を開始します。

TraceView は、指定されたプロバイダーに次のサブパラメーターの値を渡します。

-b BufferSize
トレース セッションに割り当てられた各バッファーのサイズを KB (キロバイト)で指定します。 -start との併用でのみ使用します。

既定値は、プロセッサの数、物理メモリの量、使用中のオペレーティング システムによって決まります。

分 NumberOfBuffers
トレース メッセージを格納するために最初に割り当てられるバッファーの数を指定します。 -start との併用でのみ使用します。

既定値は、プロセッサの数、物理メモリの量、使用中のオペレーティング システムによって決まります。

-max NumberOfBuffers
-start と共に使用する場合、-max はトレース セッションに割り当てられるバッファーの最大数を指定します。 既定値は、プロセッサの数、物理メモリの量、使用中のオペレーティング システムによって決まります。

-update と共に使用する場合、-max はトレース セッションに割り当てられるバッファーの最大数を変更します。

-ft FlushTime
-start と共に使用する場合、-ft はトレース メッセージ バッファーをフラッシュする頻度を秒単位で指定します。 -update と共に使用すると、-ft はフラッシュ時間を指定された時刻に変更します。

最小フラッシュ時間は 1 秒です。 既定値は 0 (強制フラッシュなし) です。

この強制フラッシュは、トレース メッセージ バッファーがいっぱいになったときやトレース セッションが停止するたびに自動的に行われるフラッシュに加えて行われます。

「-flush」も参照してください。

ページ
トレース メッセージ バッファーにページング可能なメモリを使用します。 既定では、イベント トレースではバッファーに非ページ メモリが使用されます。 -start との併用でのみ使用します。

プロバイダーが、DISPATCH_LEVELより大きい IRQL でトレース メッセージを生成する可能性があるドライバーである場合は、このパラメーターを使用しないでください。

このパラメーターは Windows 2000 でサポートされていません。

-seq MaxFileSize
イベント トレース ログ (.etl) ファイルへの順次ログ記録 (ファイルの末尾でイベントの記録を停止) を指定します。 -start との併用でのみ使用します。

MaxFileSize は、ファイルの最大サイズを MB 単位で指定します。 MaxFileSize 値がない場合、このパラメーターは無視されます。

シーケンシャル ログは既定ですが、このパラメーターを使用して最大ファイル サイズを設定したり、-prealloc を使用 したりできます。 このパラメーターがないと、ファイル サイズの制限はありません。

-cir MaxFileSize
イベント トレース ログ (.etl) ファイルの循環ログ (ファイルの末尾で、最も古いメッセージに新しいメッセージを記録する) を指定します。 -start との併用でのみ使用します。

MaxFileSize は、ファイルの最大サイズを MB 単位で指定します。 MaxFileSize 値がない場合、このパラメーターは無視されます。

既定では、ファイル サイズ制限のないシーケンシャル ログです。

-prealloc
イベント トレース ログ (.etl) ファイルを割り当てる前に、そのファイルの領域を予約します。 -start との併用でのみ使用します。

このパラメーターには、MaxFileSize で -seq または -cir が必要です。 -newfile では無効です。

フラグ は、トレース プロバイダーで定義されているフラグ値を 10 進数または 16 進数の形式で表します。 既定値は0です。 0x01000000 から 0xFF000000 までの値は、将来使用するために予約されています。

フラグの意味は、各トレース プロバイダーによって個別に決定されます。 通常、フラグは、段階的に詳細になるレポート レベルを表します。

-start コマンドでは、フラグ値はトレース セッション内のすべてのトレース プロバイダーに適用されます。 トレース プロバイダーごとに異なるフラグを設定するには、トレース プロバイダーごとに個別の -enable コマンドを使用します。

-guid のサブパラメーター 説明

-flag Flag

-level Level

トレース セッション内のプロバイダーのトレース レベルを指定します。 レベルは、トレース プロバイダーが生成するイベントを決定します。

Level は、レベル値を 10 進数または 16 進数の形式で表します。 既定値は0です。

レベル 値の意味は、各トレース プロバイダーによって個別に決定されます。 通常、トレース レベルはイベントの重大度 (情報、警告、またはエラー) を表します。

-start コマンドでは、レベル値はトレース セッション内のすべてのトレース プロバイダーに適用されます。 トレース プロバイダーごとに異なるレベルを設定するには、トレース プロバイダーごとに個別の -enable コマンドを使用します。
パラメーター説明
-b BufferSize トレース セッションに割り当てられた各バッファーのサイズを KB (キロバイト)で指定します。 -start との併用でのみ使用します。

既定値は、プロセッサの数、物理メモリの量、使用中のオペレーティング システムによって決まります。
-min NumberOfBuffers トレース メッセージを格納するために最初に割り当てられるバッファーの数を指定します。 -start との併用でのみ使用します。

既定値は、プロセッサの数、物理メモリの量、使用中のオペレーティング システムによって決まります。
-max NumberOfBuffers -start と共に使用する場合、-max はトレース セッションに割り当てられるバッファーの最大数を指定します。 既定値は、プロセッサの数、物理メモリの量、使用中のオペレーティング システムによって決まります。

-update と共に使用する場合、-max はトレース セッションに割り当てられるバッファーの最大数を変更します。
-ft FlushTime -start と共に使用する場合、-ft はトレース メッセージ バッファーをフラッシュする頻度を秒単位で指定します。 -update と共に使用すると、-ft はフラッシュ時間を指定された時刻に変更します。

最小フラッシュ時間は 1 秒です。 既定値は 0 (強制フラッシュなし) です。

この強制フラッシュは、トレース メッセージ バッファーがいっぱいになったときやトレース セッションが停止するたびに自動的に行われるフラッシュに加えて行われます。

「-flush」も参照してください。
-age AgeLimit -start と共に使用する場合、-age は、未使用のトレース バッファーが解放されるまでの保持時間 (分単位) を指定します。 -update と共に使用すると、-age によって年齢制限が指定された値に変更されます。

Age Limit は、未使用のトレース バッファーが解放されるまでの保持期間 (分単位) を指定します。 既定では 15 分です。

このパラメーターは、Windows 2000 でのみ有効です。
-paged トレース メッセージ バッファーにページング可能なメモリを使用します。 既定では、イベント トレースではバッファーに非ページ メモリが使用されます。 -start との併用でのみ使用します。

プロバイダーが、DISPATCH\_LEVELより大きい IRQL でトレース メッセージを生成する可能性があるドライバーである場合は、このパラメーターを使用しないでください。

このパラメーターは Windows 2000 でサポートされていません。
-seq MaxFileSize イベント トレース ログ (.etl) ファイルへの順次ログ記録 (ファイルの末尾でイベントの記録を停止) を指定します。 -start との併用でのみ使用します。

MaxFileSize は、ファイルの最大サイズを MB 単位で指定します。 MaxFileSize 値がない場合、このパラメーターは無視されます。

シーケンシャル ログは既定ですが、このパラメーターを使用して最大ファイル サイズを設定したり、-prealloc を使用 したりできます。 このパラメーターがないと、ファイル サイズの制限はありません。
-cir MaxFileSize イベント トレース ログ (.etl) ファイルの循環ログ (ファイルの末尾で、最も古いメッセージに新しいメッセージを記録する) を指定します。 -start との併用でのみ使用します。

MaxFileSize は、ファイルの最大サイズを MB 単位で指定します。 MaxFileSize 値がない場合、このパラメーターは無視されます。

既定では、ファイル サイズ制限のないシーケンシャル ログです。
-prealloc イベント トレース ログ (.etl) ファイルを割り当てる前に、そのファイルの領域を予約します。 -start との併用でのみ使用します。

このパラメーターには、MaxFileSize で -seq または -cir が必要です。 -newfile では無効です。

システムは、-seq パラメーターまたは -cir パラメーターを使用して指定された MaxFileSize 値と等しいサイズのイベント トレース ログ (.etl) ファイルを作成します。 セッションを停止すると、ログ ファイルの内容のサイズが小さくなります。
-newfile MaxFileSize 既存のファイルが MaxFileSize に達するたびに、新しいイベント トレース ログ (.etl) ファイルを作成します。 -start との併用でのみ使用します。

MaxFileSize は、各ログ ファイルの最大サイズを MB 単位で指定します。 MaxFileSize 値がない場合、このパラメーターは無視されます。

-newfile を使用する場合は、-f LogFile パラメーターも使用する必要があります。また、LogFile の値は、10 進数のパターン (trace%d.etl など) を示%dを含む名前にする必要があります。 それ以外の場合、コマンドは ERROR\_INVALID\_NAME で失敗します。 Windows は、新しいファイルを作成するたびに、ファイル名の 10 進値をインクリメントします。

このパラメーターは、事前割り当て (-prealloc) ログ (-cir)、NT カーネル ロガー セッション、またはプライベート トレース セッションでは無効です。 Windows 2000 ではサポートされていません。
-append トレース メッセージを既存のイベント トレース ログ (.etl) ファイルに追加します。 既定では、新しいファイルが作成されます。 -start との併用でのみ使用します。

このパラメーターは、順次ファイルでのみ有効であり、-f が使用され、-rt が使用されない場合にのみ有効です。 Windows 2000 ではサポートされていません。
-kd トレース メッセージは、KD または Windbg の接続されている方にリダイレクトします。 また、このパラメーターは、トレース バッファー サイズをデバッガーの最大バッファー サイズである 3 KB (キロバイト)に設定し、コマンド内の -b パラメーターを無視します。 -start との併用でのみ使用します。

Comments

パラメーターを指定しない -traceview コマンドを実行すると、TraceView ウィンドウが開きます。

TraceView -start コマンドを使用して、グローバル ロガー トレース セッションを開始できます。 そのためには、次のコマンド形式を使用します。 他のコマンドとは異なり、このコマンド形式の "GlobalLogger" という単語では大文字と小文字が区別されます。

traceview -start GlobalLogger [parameters]