Tracefmt のコマンド

  • [アーティクル]

Tracefmt を使用するには、コマンド プロンプト ウィンドウにコマンドを入力します。 次の構文は、Tracefmt コマンドの要素を表示します。

トレース メッセージを読み取り可能な形式で表示するには、Tracefmt でトレース メッセージ形式ファイルの書式設定命令をトレース メッセージに適用してください。 使用する構文は、トレース プロバイダー用の TMF ファイルがあるかどうか、または Tracefmt で TMF ファイルを作成するかどうかによって異なります。

TMF ファイルまたは TMF ファイルのディレクトリへのパスを指定するには:

    tracefmt [EtlFile | -rt SessionName][-tmf TMFFile | -p TMFPath ] [Options]

TMF ファイルを作成するには:

    tracefmt [EtlFile | -rt SessionName]-i ImageFiles [-r SymbolPath ] [-p TmfPath ] [Options]

コマンド ラインに構文を表示します。

    tracefmt -h | /?

パラメーター

EtlFile
トレース メッセージを含むイベント トレース ログ (.etl) ファイルを指定します。 パスとファイル名を入力します (省略可能)。 既定値は c:\logfile.etl です。

-rt SessionName
リアル タイム。 トレース ログではなく、指定されたリアルタイム トレース セッションからのトレース メッセージをフォーマットします。

SessionName はトレース セッションの名前です。 既定値は、NT カーネル ロガーです。

-tmf TMFFile
トレース メッセージのトレース メッセージ形式 (.tmf) ファイルのパス (省略可能) とファイル名を指定します。 既定値は、WDK に含まれるファイルである Default.tmf です。

-i ImageFiles
Tracefmt に指示し、指定されたイメージ ファイルの PDB シンボル ファイルを検索し、PDB ファイル内のフォーマット命令から TMF ファイルを作成します。

ImageFiles は、 トレース プロバイダーの 1 つ以上のバイナリ ファイル (.exe、.dll、または.sys) のパスとファイル名を表します。 イメージ ファイル名を区切るには、セミコロン (;) を使用します。

-r SymbolPaths
-i で指定されたイメージ ファイルのプライベート PDB シンボル ファイルの場所を指定します。

SymbolPaths は、 プライベート シンボルまたはシンボル サーバー パスを格納するディレクトリへの 1 つ以上のパスを表します。 パス名を区切るには、セミコロン (;) を使用します。 SymbolPaths のパス名には、複数の文字を表すアスタリスク (*) や 1 文字を表す疑問符 (?) など、ワイルドカード文字を含めることができます。

コマンドに -i を含めるものの、-r を省略すると、Tracepdb は%_NT_SYMBOL_PATH% 環境変数で指定されたパス内の指定されたイメージの PDB ファイルを検索します。 環境変数が設定されていない場合、Tracepdb は既定のシンボル パス srv*\\\symbols\\symbols を検索します。

-p TMFPath
TMF ファイルを格納するディレクトリへのパスを指定します。

-i を指定せずに -p を使用すると、Tracefmt は -p で指定されたパス内で既存の TMF ファイルを検索します。 p を省略した場合、Tracefmt は、%TRACE_FORMAT_SEARCH_PATH% 環境変数の値で TMF ファイルを検索します (設定されている場合)。 それ以外の場合、Tracefmt は Default.tmf ファイルに書式設定命令を適用しようとします。

-p を -i と共に使用すると、Tracefmt は作成する TMF ファイルを -p で指定されたディレクトリに配置します。 p を省略すると、TMF ファイルが設定されている場合、%TRACE_FORMAT_Standard Edition ARCH_PATH% 環境変数の値で指定されたディレクトリに TMF ファイルが配置されます。 それ以外の場合、Tracefmt はローカル ディレクトリにファイルを配置します。

-h | /?
ヘルプを表示します。

-o OutputFile
Tracefmt 出力ファイルと Tracefmt 要約メッセージ ファイルの代替名を指定します。 既定値は、ローカル ディレクトリのFmfFile.txt (出力ファイルの場合) と FmtSum.txt.sum (概要ファイルの場合) です。

OutputFile は、c:\traces\trace.txt などの.txtファイル名拡張子を持つパスとファイル名です。

このパラメーターを -displayonly オプションまたは -summaryonly オプションと共に使用すると、要約メッセージ・ファイルにのみ影響します。

-csv
Tracefmt 出力ファイルをコンマ区切りの可変長 (.csv) ファイルとしてフォーマットします。 この形式では、標準のトレース メッセージ プレフィックスに加え、各メッセージに詳細で構造化されたプレフィックスが追加されます。

このオプションは、出力ファイルに影響を与え、コマンド プロンプト ウィンドウにトレース メッセージが表示されます (存在する場合)。

-csvheader
CSV ファイルに説明的な列見出しの行を追加します。 このヘッダーは、Tracefmt が CSV ファイルに追加する構造化プレフィックスを解釈する場合に特に便利です。 既定では、Tracefmt CSV ファイルには列見出しはありません。

-csvquote
CSV ファイル内のすべての引用符 (") を二重にします。 この機能は、引用符で囲まれている場合にのみ引用符を表示するアプリケーション向けに設計されています。

表示
出力ファイルへの書き込みに加えて、コマンド プロンプト ウィンドウにトレース メッセージを表示します。

-displayonly
コマンド プロンプト ウィンドウにのみトレース メッセージを表示し、出力ファイルは作成しません。

-nosummary
概要メッセージ ファイルは作成しません。

-summaryonly
概要メッセージ ファイルのみを作成します。 Tracefmt は出力ファイルを作成しません。

-noprefix
トレース メッセージ プレフィックスを 省略します。 このオプションは、出力ファイルおよび Tracefmt 表示内のトレース・メッセージに影響します。

採用者
高解像度。 トレース メッセージのタイム スタンプ内のマイクロ秒とナノ秒の数を表示します。 既定では、ミリ秒のみが表示されます。

Tracelog -UsePerfCounter パラメーターを使用する場合など、システム タイマーではなく、パフォーマンス カウンターのクロック値をトレース メッセージのタイム スタンプに使用する場合、このオプションを使用します。 Tracelog コマンドの詳細については、「Tracelog コマンドの構文」を参照してください 。

-seq
トレース メッセージ プレフィックスのローカルまたはグローバル シーケンス番号を表示します。 シーケンス番号がメッセージに記録されなかった場合、フィールドは初期化されないか、ゼロまたは "f" で入力されます。

ods
書式設定されたトレース メッセージをデバッガーに送信して表示します。

-gmt
グリニッジ標準時 (GMT) の各トレース メッセージにタイム スタンプを表示します。

このオプションは Tracefmt 出力ファイルにのみ影響します。 イベント トレース ログ (.etl) ファイルのタイム スタンプは変換されません。 Tracefmt コマンドを送信すると、トレース ログのタイム ゾーンが表示されます。

-utc
各トレース メッセージのタイム スタンプを世界協定時刻 (UTC) で表示します。 UTC は GMT とほぼ同じですが、午前 0 時をゼロとして表します。

このオプションは Tracefmt 出力ファイルにのみ影響します。 イベント トレース ログ (.etl) ファイルのタイム スタンプは変換されません。 Tracefmt コマンドを送信すると、トレース ログ ファイルのタイム ゾーンが表示されます。

トレース
Tracefmt アクションが発生したときに表示されます。 この情報は、書式設定が正しくない場合、または Tracefmt がエラーまたは例外を報告する場合に役立ちます。

トレース表示は広範囲に及ぶ場合があります。 後で確認するために、Tracefmt 出力をテキスト ファイルにリダイレクトすることを検討してください。

-v
詳細。 Tracefmt がトレース メッセージの各ブロックまたはバッファーを処理する場合に、コマンド プロンプト ウィンドウに詳細情報を表示します。 ファイルの破損や不整合が疑われる場合は、このオプションを使用します。

コメント

TMFファイルの検索

-i パラメーターを省略すると、Tracefmt は次のメソッドを使用して TMF ファイルを検索します。 メソッドは、Tracefmt が使用する順序で一覧表示されます。

  • -tmf パラメータを使用します。

  • -p パラメーター。

  • %TRACE_FORMAT_Standard Edition ARCH_PATH% 環境変数。

  • WDK に含まれるファイルである、Default.tmf。

Tracefmt で TMF ファイルが見つからない場合、または TMF ファイルにトレース メッセージの書式設定情報が含まれていない場合、Tracefmt はメッセージを表示できません。 代わりに、トレース メッセージの代わりに次のエラー メッセージを書き込みます

No Format Information found.

例外発生報告

Tracefmt がトレース メッセージ パラメーターの書式を設定できない場合は、例外が発生し、次のようなメッセージが表示されます。

*****FormatMessage Header(Header) of EventTrace, parameter 23 raised an exception*****

同様の例外が発生した場合、ユーザー指定の変数型に特に注意して、ソース コードのメッセージ定義を確認します。 詳細については、「DoTraceMessage」を参照してください。

GUID 以外のファイル名を持つ TMF ファイル

TMF ファイル名がメッセージ GUID でない場合は、-tmf パラメーターを使用してファイルを識別し、ファイルへの完全修飾パスを入力する必要があります。

NT カーネル ロガー トレース メッセージの書式設定

NT カーネル ロガー トレース セッションまたはグローバル ロガー トレース セッションからのメッセージを書式設定するには、-tmf パラメーターを使用して system.tmf ファイル (WDK に含まれるトレース メッセージ形式ファイル) を指定します。

リアルタイム トレース セッションからのトレース メッセージの書式設定

-rt (リアルタイム) パラメーターを使用すると、Tracefmt はリアルタイム モードであることを確認するメッセージを表示し、指定されたトレース プロバイダーからのトレース メッセージを待機します。 トレース セッションが停止するまで、コマンド プロンプトに戻りません。

QPC タイム スタンプのフォーマット

Tracefmt では、システム パフォーマンス カウンター クロック (QueryPerformanceCounter) の値が正しくフォーマットされません。 この高解像度時間を使用している場合、Windows に含まれるツールである Tracerpt を使用してトレース メッセージをフォーマットします。 詳細については、Tracelog コマンド構文の -UsePerfCounter パラメーターの説明を参照してください。

シーケンス外のトレース メッセージ

Windows XP で稼働しているコンピューターでトレース メッセージ ファイルを表示すると、順序が正しくないトレース メッセージが表示されることがあります。 この問題を解決するには、トレース セッションを開始し、Tracefmt を使用してトレースを表示するときにシーケンス番号オプションを使用してください。 トレースビューを使用してトレースを表示し、シーケンス番号に従って並べ替えられます。 Windows Server 2003 以降のバージョンの Windows で稼働しているコンピューターでトレースを表示することもできます。