Getting Started with Intel® VTune™ Amplifier 2016 for Systems (Linux* Host)

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.

Image may be NSFW.
Clik here to view.

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 Image may be NSFW.
      Clik here to view. 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).

Image may be NSFW.
Clik here to view.

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.

Image may be NSFW.
Clik here to view.

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.

Image may be NSFW.
Clik here to view.

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 system.

3. 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.

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

5. Open/create a VTune Amplifier project and click the Image may be NSFW.
   Clik here to view.Import toolbar button to import the energy analysis result file into the project.

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

Linux* Targets:

1. Load 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 Image may be NSFW.
   Clik here to view.Import toolbar button to import the energy analysis result file into the project.

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