VSPerfReportVSPerfReport

VSPerfReport コマンド ライン ツールは、Visual StudioVisual Studio プロファイリング ツールのプロファイル データ ファイルを使用してレポートを作成するために使用されます。VSPerfReport command line tool is used to create reports using Visual StudioVisual Studio Profiling Tools profiling data files. 既定のレポート形式は .csv ファイルです。The default report format is a .csv file.

VSPerfReport では次の構文が使用されます。VSPerfReport uses the following syntax:

VSPerfReport [/U] vspfilename [/options]  

filename は有効な .vsp ファイルまたは .vsps ファイルである必要があることに注意してください。Note that filename must be a valid .vsp or .vsps file.

.vsp ファイルまたは .vsps ファイルの比較には、VSPerfReport コマンド ライン ツールも使用されます。The VSPerfReport command line tool is also used to compare .vsp or .vsps files. 相違点 ("diff") レポートを生成するには、次の構文を使用します。To generate a difference ("diff") report, use the following syntax:

VSPerfReport [/U] /diff vspfilename1 vspfilename2 [/options]  

vspfilename1 and vspfilename2 は有効な .vsp ファイルまたは .vsps ファイルである必要があります。vspfilename1 and vspfilename2 must be valid .vsp or .vsps files.

シンボル ファイルSymbol Files

関数名や行番号などのシンボル情報を表示するには、VSPerfReport が、プロファイルしたコンポーネントのシンボル (.pdb) ファイルおよび Windows シンボル ファイルにアクセスできる必要があります。To display symbol information such as function names and line numbers, VSPerfReport requires access to the symbol (.PDB) files of the profiled components and to Windows symbol files. 詳細については、「方法: コマンド ラインからシンボル ファイルの場所を指定する」を参照してください。For more information, see How to: Specify Symbol File Locations from the Command Line.

一般的なレポート オプションGeneral Report Options

次の表では、一般的なレポートの書式指定オプションと、報告対象のデータを選択するためのオプションについて説明します。The following table describes the general report formatting options and the options that select the data to be reported.

オプションOptions 説明Description
UU レポート出力とリダイレクトされたコンソール出力は Unicode として書き込まれます。Report output and redirected console output are written as Unicode. このオプションは最初に指定する必要があります。Must be the first option specified.
Summary:[types]Summary:[types] 1 つ以上の種類のレポートを作成します。Creates one or more types of reports.

- All - すべての種類のレポートが生成されます。- All - all report types are generated.
- CallerCallee - 関数間の親子関係。- CallerCallee - parent/child relationships between functions.
- Function - 呼び出された関数。- Function - functions called.
- CallTree - 呼び出された関数の階層。- CallTree - hierarchy of functions called.
- Counter - すべてのマークと Windows パフォーマンス カウンター値。- Counter - all marks together with Windows performance counter values.
- Ip - プロファイルされた命令。- Ip - instructions profiled.
- Life - (割り当てデータが収集されたときに使用可能な) 割り当てられたオブジェクトの有効期間。- Life - lifetime of allocated objects (available when allocation data has been collected.)
- Line - ソース コード行のプロファイル データ。- Line source code line profile data.
- Header - レポートにファイル ヘッダー情報が含まれます。- Header - report contains file header information.
- Mark - すべてのマーク。- Mark all marks.
- Module - プロファイルされたモジュール。- Module - modules profiled.
- Process - プロファイルされたプロセス。- Process - processes profiled.
- Thread - プロファイルされたスレッド。- Thread - threads profiled.
- Type - 割り当てられた型。- Type - allocated types.
- Contention - リソースの競合。- Contention - resource contentions.
- RuleWarnings - パフォーマンス規則の問題- RuleWarnings - performance rule issues
- ETW - プロファイル実行で収集されたすべての Windows イベント トレーシング (ETW) イベント。- ETW - all Event Tracing for Windows (ETW) events collected in the profiling run. .etl データ ファイルは、その元の場所か、.vsp または .vsps ファイルを含むディレクトリにある必要があります。The .etl data file must be in its original location or in the directory containing the .vsp or .vsps file.
XmlXml レポートを XML 形式で出力します。Output report in XML format.
CallTraceCallTrace 関数の開始と終了、ETW イベント、およびマークのリストを作成します。Creates a list of function entry and exits, ETW events, and marks.
ClearPackedSymbolsClearPackedSymbols プロファイラー データ ファイルから以前に埋め込まれたシンボルを削除します。Removes previously embedded symbols from a profiler data file. PackSymbols を 2 回目に実行する前にこのコマンドを実行します。Run this command before running PackSymbols a second time.
SymbolPath: pathSymbolPath: path プロファイラー データ ファイルのシンボルを含む 1 つ以上の検索パスまたはシンボル サーバーを指定します。Specifies one or more search paths or symbol servers that contain symbols for the profiler data file.
DebugSymPathDebugSymPath シンボルが検索された場所、およびシンボルが見つかったかどうかを示します。Lists the locations that are searched for symbols and whether they are found. このオプションは、シンボル解決の問題を解決するのに便利です。This option is useful to resolve symbol resolution issues.
PackSymbolsPackSymbols シンボルをプロファイル データ (.vsp) ファイルに保存して、シンボル (.pdb) ファイルが分析に不要になるようにします。Saves symbols into the profiling data (.vsp) file so that symbol (.pdb) files are not required for analysis.
Output: path|filenameOutput: path|filename 生成されたレポート ファイルの代替の場所を指定します。Specifies an alternate location for the generated report files. 既定では、レポートは現在のディレクトリに作成されます。By default, reports are created in the current directory.
SummaryFileSummaryFile 分析を行い、分析情報を .vsps 概要ファイルに保存します。Analyze and save the analyzed information in a .vsps summary file.
PrintMarksPrintMarks 指定されたレポート ファイル内のすべてのマークについて、名前とタイムスタンプを表示します。Show the names and timestamps for all marks in the specified report file.
?? 使用情報を表示します。Displays usage information.
NoLogoNoLogo レポートの実行時にバージョン情報を非表示にします。Hides version information when the report is running.
UserRulesDirectoryUserRulesDirectory ユーザー定義のパフォーマンス規則を含むディレクトリを指定します (まだ実装されていません)。Specifies directory containing user-defined performance rules [Not yet implemented].

フィルター オプションFilter Options

次の表では、使用できるデータをフィルター処理するためのオプションについて説明します。The following table describes the options to filter the available data.

オプションOptions 説明Description
JustMyCode[:[caller][,callee]]JustMyCode[:[caller][,callee]] ユーザー アプリケーションの関数呼び出しのみを表示し、システム呼び出しは非表示にします。Only show user application function calls; hide system calls.

- パラメーターなし - すべてのシステム関数を非表示にします。- No parameters - hide all system functions.
- caller - アプリケーション関数を呼び出すシステム関数の 1 つのレベルを表示します。- caller - show one level of system functions that call application functions.
- callee - ユーザー アプリケーション関数で呼び出されるシステム関数の 1 つのレベルを表示します。- callee - show one level of system functions that are called by user application functions.
StartTime:[value]StartTime:[value] ミリ秒単位の時間 (value) よりも後に収集されたデータのみを表示します。Only show data collected after value (in milliseconds.)
EndTime:[value]EndTime:[value] ミリ秒単位の時間 (value) よりも前に収集されたデータのみを表示します。Only show data collected before value (in milliseconds.)
FilterFile: VSPFFileFilterFile: VSPFFile Visual Studio の [パフォーマンス レポート] ウィンドウから生成されたフィルター ファイルの場所を指定します。Specifies the location of a filter file that was generated from the Visual Studio Performance Report window.
MsFilter:[starttime,duration]MsFilter:[starttime,duration] 開始時刻 (starttime) からミリ秒単位の時間 (duration) 内のみのデータを表示します。Only show data from starttime until the length of duration (in milliseconds.)
Process:[pid]Process:[pid] 指定されたプロセスのデータのみを表示します。Only show data from the specified process.
Thread:[threadid]Thread:[threadid] 指定されたスレッドのデータのみを表示します。Only show data from the specified thread.
Thread:[threadid,processid]Thread:[threadid,processid] 指定されたプロセスに関連付けられている指定されたスレッドのデータのみを表示します。Only show data from the specified thread associated with the specified process.

相違点レポートのオプションDifference Report Options

次の表では、レポート ファイルを比較するためのオプションについて説明します。The following table describes the options for comparing report files.

オプションOptions 説明Description
Diff vspfile1 vspfile2Diff vspfile1 vspfile2 2 つレポート ファイル (.vsp または .vsps) を比較します。Compare two report files (.vsp or .vsps) files. diff オプションを使用すると Summary オプションは無視されます。Summary options will be ignored using the diff option.
Diff:[value]Diff:[value] このしきい値を下回ると、2 つの値の相違は無視されます。Below this threshold value the difference between two values will be disregarded. また、値がこのしきい値を下回る新しいデータは表示されません。Also, new data with values under this threshold will not be shown.
DiffTable:[tablename]DiffTable:[tablename] このテーブルを使用して、ファイルを比較します。Use this specific table to compare files. 既定では関数テーブルが使用されます。The default is the functions table.
DiffColumn:[columnname]DiffColumn:[columnname] この列を使用して、値を比較します。Use this specific column compare values. 既定では排他サンプルのパーセント列が使用されます。The default is the exclusive samples percent column.
QueryDiffTablesQueryDiffTables 指定された 2 つのレポート ファイルに関する有効なテーブルおよび列をリストします。List the valid tables and columns for the two report files provided.

関連項目See Also

パフォーマンス レポートのビューPerformance Report Views