How to: Specify Additional Instrumentation Options


The new home for Visual Studio documentation is Visual Studio 2017 Documentation on

The latest version of this topic can be found at How to: Specify Additional Instrumentation Options.

You can instrument binaries from the Visual Studio integrated development environment (IDE) or by using command line tools. If you instrument a binary from within the IDE, you can control the volume of data that is collected during instrumentation by specifying additional instrumentation options to the VSInstr tool. These options are available at the session or the target level. For example, to include or exclude specific functions during the instrumentation process, use the additional instrumentation option at the target level.


  • Visual Studio Ultimate, Visual Studio Premium, Visual Studio Professional
System_CAPS_ICON_important.jpg Important

Every probe that is inserted modifies the behavior of the original program slightly. This modification causes overhead at analysis time. Even though an approximation of this overhead is subtracted, it still has subtle timing effects on multithreaded applications. The VSInstr tool options help control data collection during profiling.

To specify additional instrumentation option

  1. In Performance Explorer, select the Performance Session and then right-click and select Properties.

  2. In the Properties Pages, click the Advanced properties.

  3. Type options in the Additional instrumentation options box.

    For example, use /CONTROL:THREAD to specify the profiling level. For a complete list of options, see VSInstr.

  4. Click OK.

Configuring Performance Sessions
Profiling from the Command-Line