Create basic profiling reports from the command line
Applies to: Visual Studio Visual 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 |