Intel® VTune™ Amplifier 2018 Help

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.

You may want to re-finalize a result to:

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.

Re-Finalizing Results

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 Target or Analysis Type tab.

  4. Click the Re-resolve button on the right 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.

Note

To speed up the analysis process (for example, for the analysis on the Intel® Xeon Phi™ processor), you may choose to use a deferred finalization command line option, -finalization-mode=deferred, when the VTune Amplifier calculates the binary check sum for proper symbol resolution on the target system but finalizes the result on the host system. You can also configure an arbitrary target from the GUI to select a system for result finalization and automatically generate a command line to be launched from the target system.

See Also