Modifying Instrumentation Level

You can change the default instrumentation level for the modules you analyze. Higher levels of instrumentation result in more information in the call graph but slower execution. The following levels of instrumentation are available:

Instrumentation Level	Description
All Functions	The VTune(TM) Performance Analyzer collects call graph data on every function in the module. This instrumentation level provides the most information. However, it also causes the most performance degradation. All Functions instrumentation is possible only if the selected module has line and symbol information.
Custom (not supported from vtl)	You can specify functions you want the VTune analyzer to instrument. Custom instrumentation is available if All Functions and/or Exports instrumentation is available. When you select Custom instrumentation, the Function Selection - [module path] dialog box opens and you can select functions to instrument.
Exports	The VTune analyzer collects call graph data on the functions that are in the module's export table. Exports instrumentation is possible only if the selected module exports some functions.
Minimal	The VTune analyzer instruments the module you selected but does not collect data. Select this instrumentation level if you are not interested in data on this module but want to get data on calls from this "unimportant" module to other "important" modules.

The VTune analyzer determines the type of module (User or System) according to attributes recorded in the module header.

For User modules, all levels of instrumentation are available. Though All Functions mode can be applied only to modules with line and symbol information.
For System modules, only three levels are available: Exports, Custom, and Minimal.

To modify the instrumentation level for the current Activity with a call graph data collector:

Click the cell in the Instrumentation level column of the instrumented modules table in the Configure Call Graph dialog box. In the Module information section, select the level from the drop-down list in the Requested instrumentation level field and click OK.

To modify the default call graph data collection configuration:

Click Window > Preferences to open the Preferences dialog box. Double click the VTune(TM) Performance Tools.

From the left panel, choose Call Graph > Collector.
Select the required level for each type of module.

To modify the instrumentation level for an existing Activity launched via script:

Before the first run of the Activity, set the default instrumentation level to minimal.

To modify the default instrumentation level when working from command line:

Edit values in the Default Instrumentation Levels section of the configuration file.

To locate the call graph configuration .ini files, enter:

vtl query -activity | -a [<name>]

Note

The VTune analyzer may not accept the modified option value if it cannot be applicable to the modules. For example, full instrumentation cannot be provided for a module without debug information.