Getting Started with Intel® VTune™ Amplifier

Step 1: Start the VTune Amplifier

1. Set up the environment variables:

   • csh/tcsh users: source <install_dir>/amplxe-vars.csh

   • bash users: source <install_dir>/amplxe-vars.sh

   By default, the <install_dir> is:

   • For root users: /opt/intel/system_studio_<version>/vtune_amplifier_for_systems

   • For non-root users: $HOME/intel/system_studio_<version>/vtune_amplifier_for_systems

2. Launch the VTune Amplifier:

   • For standalone GUI interface, run the amplxe-gui command.

   • For command line interface, run the amplxe-cl command.

Step 2: Set Up the Analysis Target

1. Build your target application in the Release mode with all optimizations enabled.

2. Create a VTune Amplifier project:

   1. Click the menu button in the right corner and go to New > Project... .

   2. Specify the project name and location in the Create Project dialog box.

3. In the Analysis Target tab, select a target system from the left pane and select an analysis target type from the right pane.

4. Configure your target: application location, parameters and search directories (if required).

   

   NEW: Select Arbitrary Targets to analyze a target that is not currently accessible from this host system. You can select a hardware platform and operating system from the list, create a command line analysis configuration, save it to the buffer, and run it later on the intended host. For more information, see Analysis Target Setup.For more information, see Analysis Target Setup.

Step 3: Configure Analysis

1. Switch to the Analysis Type tab.

2. From the left pane, select an analysis type applicable to your platform and configure analysis options in the right pane.

3. Click the Start button on the right to launch the analysis.

Step 4: View and Analyze Performance Data

When data collection completes, the VTune Amplifier opens the result in the default viewpoint, which is a preset configuration of windows for an analysis result. You may switch between different viewpoints to analyze the data from different perspectives using different sets of performance metrics.

Start your analysis with the Summary window to get an overview of the application performance and then switch to other windows to explore the performance deeper at the granularity of function, source line and so on.

Android* Targets:

1. Connect to the target Android system via an adb shell command.

2. Load device drivers and install the Intel SoC Watch collector on the target Android systemLoad device drivers and install the Intel SoC Watch collector on the target Android system.

3. Run the data collection on the targetRun the data collection on the target. For example:

   >./socwatch -t 60 -f cpu-cstate -m -r vtune -o ./results/test

   where: -t 60 specifies collection duration in seconds, -f cpu-cstate enables C-state and wakeups analysis, -m specifies the maximum level of detail, and -r vtune creates a *.pwr file that can be imported into VTune Amplifier. The analysis result *.pwr file will be located in the ./results/test directory.

4. Copy the result file (*.pwr) to the host.

5. Open/create a VTune Amplifier project and click the Import toolbar button to import the energy analysis result file into the project.

6. Explore the Platform Power Analysis viewpoint to view the collected dataview the collected data.

Linux* Targets:

1. Load device drivers and install the Intel SoC Watch collector on the target Linux systemLoad device drivers and install the Intel SoC Watch collector on the target Linux system.

2. Run the data collection on the target. For example:

   >./socwatch -t 60 -f cpu-cstate -m -r vtune -o ./results/test

   where: -t 60 specifies collection duration in seconds, -f cpu-cstate enables C-state and wakeups analysis, -m specifies the maximum level of detail, and -r vtune creates a *.pwr file that can be imported into VTune Amplifier. The analysis result *.pwr file will be located in the ./results/test directory.

3. Copy the result file (*.pwr) to the host.

4. Open/create a VTune Amplifier project and click the Import toolbar button to import the energy analysis result file into the project.

5. Explore the Platform Power Analysis viewpoint to view the collected dataview the collected data.