Finalization

Finalization is the process by which Intel® VTune™ Amplifier converts the collected data to a database, resolving symbol information, and pre-computes data to make further analysis more efficient and responsive. VTune Amplifier finalizes data automatically when data collection completes.

VTune Amplifier provides three basic finalization modes:

  • Full mode provides maximum precision but incurs more post-processing overhead.

  • Fast (default) mode limits the number of loaded samples to speed up post-processing if the number of collected samples exceeds the threshold.

  • Deferred mode is useful for an analysis result collected on a target system that is not powerful enough for finalization. In this mode, the VTune Amplifier calculates the binary check sum for proper symbol resolution on the target system but finalizes the result on the host system. The deferred finalization mode is only available for the an Arbitrary Host target system.

Modify the Finalization Mode

By default, the Fast finalization mode is used for any analysis configuration. If you need to change it, do the following:

  1. Click the Configure Analysis button.

  2. From the WHERE pane, click the Browse button, choose a target system and specify required details.

  3. From the WHAT pane, click the Browse to choose an appropriate target type.

  4. Expand the Advanced section on the WHAT pane and scroll down to select the required finalization mode, for example: Deferred to use another system.

Note

When the analysis result is collected and open, you can always check the used finalization mode in the Summary view > Collection and Platform Info section.

Re-Finalize Results

You may want to re-finalize a result to:

  • update symbol information after changes in the search directories settings

  • resolve the number of [Unknown]-s in the results

Beware that re-finalization can lead to wrong results if you do not have the original binaries for your target on the machine performing the re-finalization; for example, if you recompiled the target. The re-finalization deletes the old database and then picks up the newer versions of the binaries. Since the collector raw data does not contain a binary checksum, the VTune Amplifier does not know when a binary has changed and attempts to resolve the symbols matching the old addresses against the new binary. As a result, the VTune Amplifier may unwind stacks incorrectly and resolve samples to the wrong functions. To avoid this, make sure you configured the search directories to use the correct files.

By default, the VTune Amplifier saves the raw collector data after finalization. You may choose to remove these data to reduce the size of the result file if you do not plan to re-finalize this result in the future. To remove the raw collector data, from the Microsoft Visual Studio* menu go to Tools > Options > Intel VTune Amplifier <version> > General pane and select the Remove raw collector data after result finalization option. To remove the raw collector data in the standalone interface, click the menu button and select Options... > General.

To re-finalize a result in the Microsoft Visual Studio* IDE, select the result in the Solution Explorer, right-click and select Re-resolve and Open.

To re-finalize a result in the standalone VTune Amplifier interface:

  1. Click the menu button and select Open > Result....

    The Select Result dialog box opens.

  2. Navigate to the required result *.amplxe file you want to re-finalize and click OK.

    The selected result opens in the default viewpoint.

  3. Click the Analysis Configuration tab.

  4. Click the Re-resolve button on the command bar.

Intel® VTune™ Amplifier repeats result finalization. If you updated the list of search directories in the Binary/Symbol Search or Source Search dialog boxes, the VTune Amplifier uses the latest version of these directories to search for supporting binary/source/symbol files.

See Also

For more complete information about compiler optimizations, see our Optimization Notice.
Select sticky button color: 
Orange (only for download buttons)