How to: Specify Additional Instrumentation Options


This article applies to Visual Studio 2015. If you're looking for the latest Visual Studio documentation, use the version selector at the top left. We recommend upgrading to Visual Studio 2019. Download it here

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


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.

See Also

Configuring Performance Sessions
Profiling from the Command-Line