Events (VSPerfCmd)
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
The VSPerfCmd.exe Events option controls Event Tracing for Windows (ETW) logging. ETW data is saved to an .etl file that is separate from the profiler data file. The data can be viewed in a report using the VSPerfReport /summary:etw command.
The Events option can be called at any time before the VSPerfCmd Shutdown command is called to stop profiling.
Syntax
VSPerfCmd.exe /events {On|Off} {Guid|ProviderName} [,Flags[,Level]
Parameters
On|Off Starts or stops collecting event data.
Guid
The GUID of the provider control.
ProviderName
The name of the provider that is registered with Windows Management Instrumentation (WMI).
Flags
A "0x"-prefixed hexadecimal flags value that is defined by the event provider.
Level
Specifies the amount of data collected. Level
is defined by the event provider.
The Events option understands the following kernel keywords as provider names:
Process Process events
Thread Thread events
Image Image load and unload events
Disk Disk I/O events
File File I/O events
Hardfault Hard page faults
Pagefault Soft page faults
Network Network events
Registry Registry access events
Note that the Kernel Provider can only be enabled. It cannot be disabled, nor can its flags be modified, until the monitor shuts down.
Remarks
Note
When CLR ETW events are enabled, additional startup data is also collected in the Trace View report. To exclude startup events from appearing in the report, use the following command:
C:\<path>VSPerfCmd -events on, \".NET Common Language Runtime\", 0x7fffffff, 5
Important
If you do not exclude the startup events, then because these events are not listed in the Managed Object Format (MOF) file, they appear as GUIDs in the report. For more information, see this page on the Microsoft Web site: Sample Managed Object Format (MOF) file.