Create basic profiling reports from the command line

Applies to: yesVisual Studio noVisual Studio for Mac

Note

This article applies to Visual Studio 2017. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here

This article 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.

Report commands

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.

Summary report type parameters

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 Parameter Report Description Report Reference
CallerCallee Represents parent/child relationships between functions. - Sampling data
- Instrumentation data
- .NET memory sampling data
- .NET memory instrumentation data
- Contention data
Function Lists profiling data by function. - Sampling data
- Instrumentation data
- .NET memory sampling data
- .NET memory instrumentation data
- Contention data
CallTree Represents 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
Counter Lists profiling marks and Windows performance counter values that were collected during the profiling run. - Marks View
Ip Lists profiling data by instruction. - Sampling data
- .NET memory sampling data
- Contention data
Life Lists the lifetime of allocated objects. - Object Lifetime View
Line Lists profiling data by source code line. - Sampling data
- .NET memory sampling data
- Contention Data
Header Profiling data file header information. Specific to file.
Mark Profiling marks collected in the profiling run. - Marks View
Module Lists profiling data for modules. - Sampling data
- Instrumentation data
- .NET memory sampling data
- .NET Memory Instrumentation Data
- Contention data
Process Lists profiling data for processes. - Process View
- Contention data
Thread Lists profiling data for threads. - Process View
Type Lists allocation profiling data by type. - Allocations View
Contention Resource contentions. - Resource contentions
RuleWarnings Lists performance rule issues. - Lists the CheckId, description, and source code location of the rule issue.
ETW Lists Event Tracing for Windows (ETW) events collected in the profiling run. - ETW report