リファレンス: vcperf コマンド

この記事では、vcperf.exe で使用できるコマンドと、それらの使用方法について説明します。

トレースを開始および停止するコマンド

重要

/noadminを指定しない限り、次のコマンドには管理特権が必要です。

オプション	引数と説明
/start	[/noadmin] [/nocpusampling] [/level1 | /level2 | /level3] <sessionName>
	指定されたセッション名でトレースを開始します。 /noadmin オプションは管理者特権なしでvcperf.exe実行され、/nocpusampling オプションは無視されます。 管理者特権なしで vcperf を実行すると、特定のマシンに複数のアクティブなセッションが存在する可能性があります。 /nocpusampling オプションは、CPU サンプルを収集しないvcperf.exeを指定します。 Windows Performance Analyzer で CPU 使用率 (サンプリング) ビューを使用できなくなりますが、収集されるトレースは小さくなります。 /level1、/level2、または/level3オプションでは、収集する MSVC イベントを、情報のレベルを上げて指定します。 レベル 3 には、すべてのイベントが含まれます。 レベル 2 には、テンプレートインスタンス化イベントを除くすべてのイベントが含まれます。 レベル 1 には、テンプレートのインスタンス化、関数、ファイルのイベントを除くすべてのイベントが含まれます。 指定しない場合、 /level2 は既定で選択されます。 トレース vcperf.exe 開始すると、すぐに戻ります。 トレースは、コンピューター上で実行されているすべてのプロセスのイベントをシステム全体で収集します。 つまり、 vcperf.exeの実行に使用するのと同じコマンド プロンプト ウィンドウでプロジェクトをビルドする必要はありません。 たとえば、Visual Studio でプロジェクトをビルドできます。
/stop	(1) [/templates] <sessionName> <outputFile.etl> (2) [/templates] <sessionName> /timetrace <outputFile.json>
	指定したセッション名によって識別されるトレースを停止します。 トレースで後処理ステップを実行して、 <outputFile> パラメーターで指定されたファイルを生成します。 /templates オプションには、テンプレートインスタンス化イベントがファイルに含まれています。 (1) Windows パフォーマンス アナライザー (WPA) で表示可能なファイルを生成します。 出力ファイルには、 .etl 拡張子が必要です。 (2) Microsoft Edge トレース ビューアー (edge://tracing) で表示可能なファイルを生成します。 出力ファイルには、 .json 拡張子が必要です。
/stopnoanalyze	<sessionName> <rawOutputFile.etl>
	指定したセッション名によって識別されるトレースを停止し、生の処理されていないデータを指定した出力ファイルに書き込みます。 結果のファイルは、WPA での表示を目的としていません。 /stop コマンドに伴う後処理の手順には、時間がかかることがあります。 /stopnoanalyze コマンドを使用すると、この後処理の手順を遅らせることができます。 Windows パフォーマンス アナライザー または Microsoft Edge トレース ビューアーで表示可能なファイルを生成する準備ができたら、/analyze コマンドを使用します。

その他のコマンド

オプション	引数と説明
/analyze	(1) [/templates] <rawInputFile.etl> <outputFile.etl> (2) [/templates] <rawInputFile.etl> /timetrace <outputFile.json>
	/stopnoanalyze コマンドによって生成された生のトレース ファイルを受け取ります。 このトレースで後処理ステップを実行して、 <outputFile> パラメーターで指定されたファイルを生成します。 /templates オプションには、テンプレートインスタンス化イベントがファイルに含まれています。 (1) Windows パフォーマンス アナライザー (WPA) で表示可能なファイルを生成します。 出力ファイルには、 .etl 拡張子が必要です。 (2) Microsoft Edge トレース ビューアー (edge://tracing) で表示可能なファイルを生成します。 出力ファイルには、 .json 拡張子が必要です。

関連項目

C++ Build Insights を使ってみる
チュートリアル: Windows パフォーマンス アナライザーの基本
リファレンス: Windows パフォーマンス アナライザー ビュー
Windows Performance Analyzer