Events (VSPerfCmd)

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

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.

See also