Vtune

Introduction

VTune is Intel's Performance Analysis tool for applications and systems. It is capable of Analyzing both OpenMP and MPI based applications.

Software Module

To load the module on any Compute Canada cluster run:

[name@server ~]$ module load vtune

Tool Re-Naming

The content of this wiki is mostly discussed in terms of the legacy named Intel® VTune™ Amplifier. Please note the tool has been renamed throughout Intels documentation in latest versions (newer than the latest vtune module versions presently available on Compute Canada systems) from Intel® VTune™ Amplifier too Intel® VTune™ Profiler. Likewise the application commands amplxe-cl and amplxe-gui have been renamed too vtune and vtune-gui for both the command line and gui tools respectively. Once a version with the newer naming convention is available as a loadable module in the forthcoming default StdEnv/2020 environment this wiki page will be updated accordingly. Further information can be found here.

Collect Analysis

To collect analysis information run:

[name@server ~]$ amplxe-cl -collect <analysis-type> <target_exe> <exe_arguments>

where <analysis-type> should be replaced by one of the available analysis, e.g. hotspots, and <target_exe> is the path to the executable you would like to analyze. It is recommended to compile your executable with the "-g" option and to use the same optimization level as normal so as to obtain accurate results. A listing of version specific argument options and several usage examples maybe displayed on the command line by running amplxe-cl -help, after loading the vtune module. Complete downloadable documentation for Parallel Studio XE (including VTune) for all recent versions can be found here. The latest version of the Intel VTune Profiler User Guide may be found here.

Create Report

To create a report run this command:

[name@server ~]$ amplxe-cl -report <report-type>

where <report-type> is the type of the report to generate, e.g. hotspots. See also:

• https://software.intel.com/en-us/vtune-amplifier-help-generating-command-line-reports

Matrix Example

Analyze and generate a summary report for the Intel Matrix Sample Project run from the command line with 4 cores:

salloc --time=1:00:00 --cpus-per-task=4 --ntasks=1 --mem=16G --account=def-yours
module load StdEnv/2016.4 *OR* StdEnv/2018.3
module load intel/2019.3 (optional)
module load vtune/2019.3
cp -a $EBROOTVTUNE/vtune_amplifier/samples/en/C++/matrix .
cd matrix/linux
make icc
amplxe-cl -collect hotspots ../matrix
amplxe-cl -report summary 

The latest version of matrix_multiply (uses cmake to build) can be found here.

Graphical Use

The Intel Matrix Sample Project an also be run using Vtune in GUI mode as explored here [1]. To run VTune over VNC follow the below directions depending on which system you wish to use. Running VTune graphically can be useful to generate command line configurations as discussed in [2].

Cluster Nodes

1. Connect to a cluster compute or login node with TigerVNC
2. module load StdEnv/2016.4 *OR* StdEnv/2018.3
3. module load intel/2019.3 (optional)
4. module load vtune/2019.3
5. amplxe-gui
   

VDI Nodes

1. Connect to gra-vdi.computecanada.ca with TigerVNC
2. module load CcEnv StdEnv/2016.4 *OR* StdEnv/2018.3
3. module load intel/2019.3 (optional)
4. module load vtune/2019.3
5. amplxe-gui