Creating Basic Profiling Reports from the Command Line

 

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at Creating Basic Profiling Reports from the Command Line.

This topic describes the basic VSPerfReport commands that generate comma-separated value (.csv) reports from a .vsp or .vsps profiling data file. For a description of all report options, see VSPerfReport.

Use one of the following commands to create a report for a specified profiling data file.

VSPerfReport VSPFile /Summary:All
Generates all reports available for the .vsp or .vsps file.

VSPerfReport VSPFile /Summary:ReportType[,ReportType...]
Generates the specified report types.

VSPerfReport VSPFile /CallTrace
Generates a report that lists each data collection event. Instrumentation only.

The following table describes the reports that are generated by the specified report type option. The columns of a report depend on the profiling method that was used to collect the data.

Summary ParameterReport DescriptionReport Reference
CallerCalleeRepresents parent/child relationships between functions.- Sampling Data
- Instrumentation Data
- .NET Memory Sampling Data
- .NET Memory Instrumentation Data
- Contention Data
FunctionLists profiling data by function.- Sampling Data
- Instrumentation Data
- .NET Memory Sampling Data
- .NET Memory Instrumentation Data
- Contention Data
CallTreeRepresents the execution paths and profiling data of functions in the profiling run.- Instrumentation Data
- Sampling Data
- .NET Memory Sampling Data
- .NET Memory Instrumentation Data
- Contention Data
CounterLists profiling marks and Windows performance counter values that were collected during the profiling run.- Marks View
IpLists profiling data by instruction.- Sampling Data
- .NET Memory Sampling Data
- Contention Data
LifeLists the lifetime of allocated objects.- Object Lifetime View
LineLists profiling data by source code line.- Sampling Data
- .NET Memory Sampling Data
- Contention Data
HeaderProfiling data file header information.Specific to file.
MarkProfiling marks collected in the profiling run.- Marks View
ModuleLists profiling data for modules.- Sampling Data
- Instrumentation Data
- .NET Memory Sampling Data
- .NET Memory Instrumentation Data
- Contention Data
ProcessLists profiling data for processes.- Process View
- Contention Data
ThreadLists profiling data for threads.- Process View
TypeLists allocation profiling data by type.- Allocations View
ContentionResource contentions.- Resource Contentions
RuleWarningsLists performance rule issues.- Lists the CheckId, description, and source code location of the rule issue.
ETWLists Event Tracing for Windows (ETW) events collected in the profiling run.- ETW Report
Show: