Quantcast
Viewing all articles
Browse latest Browse all 1853

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

Intel® VTune™ Amplifier for Systems Performance Profiler with Intel® Energy Profiler helps you speed up and optimize execution of your code on Linux* embedded platforms, Android* or Windows* systems providing the following types of analysis:

  • Performance analysis: Find serial and parallel code bottlenecks, analyze algorithm choices, GPU engines usage, and understand where and how your application can benefit from available hardware resources.

  • Intel Energy Profiler analysis: Analyze power events and identify those that waste energy.

VTune Amplifier for Systems is available as part of the Intel System Studio.

Select Your Host System to Get Started

Prerequisites

  • For remote performance analysis, set up your target Linux* | Android* system.

  • For hardware event-based sampling analysis, make sure you have the sampling driver installed.

    Note that for Linux targets the sampling driver detects the kernel update and automatically attempts to rebuild and load the driver at the boot time. If, for some reasons, the sampling driver cannot be installed, the VTune Amplifier automatically enables driverless Perf*-based collection providing limited event-based sampling analysis options.

  • For Intel Energy Profiler analysis, make sure to have the appropriate drivers installed for your target system.

For system requirements, see the product Release Notes.

Get Started with Performance Analysis

Step 1: Start the VTune Amplifier

  1. Set up the environment variables with the amplxe-vars batch file. For example, if you installed the VTune Amplifier using the default directory, type: C:[Program Files]\IntelSWTools\system_studio_2016.0.<package_num>\VTune Amplifier for Systems\amplxe-vars.bat. Batch file displays the product name and the build number.

  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.

Get Started with Energy Analysis

Depending on your target system, the VTune Amplifier uses different collectors for energy and power analysis.

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 using an adb pull command on the host: adb pull <*.pwr_file>

  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.

Windows* Targets:

  1. Install the Intel SoC Watch collector on the Windows system. VTune Amplifier provides two instances of the Intel SoC Watch collector for Windows targets:

    • For host-based collection, the Intel SoC Watch collector is installed by default with the Intel System Studio and available from the [Program Files]\IntelSWTools\system_studio_for_windows_<version>\VTune Amplifier <version> for Systems\target\windows_socwatch directory.

    • For remote Windows targets, install the Intel SoC Watch collector.

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

    > socwatch -t 60 -f cpu-cstates -m -r sww -o results/test

    where: -t 60 specifies collection duration in seconds, -f cpu-cstates requests C-state and wakeup analysis, -m specifies the maximum level of detail, and -r sww creates a *.sww1 file that can be imported into VTune Amplifier. The output files will be named test and be located in the results directory.

  3. Copy the result file (*.sww1) 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.

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.

Documentation and Resources

Note

If you have problems viewing VTune Amplifier documentation on the Microsoft Windows Server* 2012 system, adjusting a security setting for the Microsoft Internet Explorer* browser usually corrects the problem. From Tools > Internet Options > Security, add about:internet to the list of trusted sites. Optionally, you can remove about:internet from the list of trusted sites after you are finished viewing the documentation.

Document

Description

Intel VTune Amplifier Tutorials

Tutorials show you how to configure remote collection with the VTune Amplifier and use basic product features. VTune Amplifier tutorials guide a new user through basic walkthrough operations with a short sample. The tutorials provide an excellent foundation before you read the VTune Amplifier help.

The default installation location for the VTune Amplifier tutorials is <install-dir>\documentation\<locale>\tutorials\index.htm.

To open the VTune Amplifier tutorials from the Microsoft Windows* OS Start menu, choose Intel System Studio 2016 > Documentation > Intel VTune Amplifier for Systems Documentation

Sample code is typically installed to <install-dir>\samples\<locale>\<programming_language>.

Release Notes

The Release Notes contain the most up-to-date information about the product, including a product description, technical support, and known limitations and issues.

This document also contains system requirements for installing the product. Before installation, the Release Notes document is located at the root level (same level as the installation script/executable) of the installation download package.

The Release Notes document is installed at: <install-dir>\documentation\<locale>\release_notes_amplifier_for_systems_windows.pdf

Installation Guide

The Installation Guide contains basic installation instructions for VTune Amplifier and post-installation configuration instructions for the various drivers and collectors.

The latest Installation Guide can be found on the Intel Developer Zone website.

Intel VTune Amplifier Help

The help is the primary documentation for the VTune Amplifier:

  • To view VTune Amplifier help from the standalone VTune Amplifier GUI Help menu: Choose Intel VTune Amplifier 2016 for Systems Help

  • To view VTune Amplifier help outside the VTune Amplifier GUI: Open the index.htm file installed at <install-dir>\documentation\<locale>\help.

Intel SoC Watch User's Guide (Android* | Windows* | target system)

This document provides detailed instructions on using the Intel Energy Profiler command line data collector, Intel SoC Watch, for power and energy analysis on Android, Windows and Linux target systems. For information on viewing and interpreting energy analysis data, see Intel VTune Amplifier Help > Energy Analysis User's Guide chapter.

SEP User's Guide

This document provides instructions on using the VTune Amplifier sampling collector (SEP) targeted for hardware event-based sampling analysis on resource-restricted systems.

Intel Processor Event Reference

This help provides reference information for Intel processor events used by the VTune Amplifier for hardware event-based sampling analysis. Most of this information is drawn from Intel processor information sources on the web. To access the Event Reference:

  • From the Visual Studio: Choose Help > Intel VTune Amplifier 2016 for Systems > Intel Processor Event Reference from the Help menu, or click the Image may be NSFW.
    Clik here to view.
    Help icon on the toolbar.
  • From the standalone VTune Amplifier GUI: Choose Intel Processor Event Reference from the Help menu, or click the Help icon on the toolbar.

Command line help

You can access general help for VTune Amplifier command line interface by entering the following command line:

  • amplxe-cl -help for help on basic action options

  • amplxe-cl -help <action-option> for help on a particular action option and its knobs

Web Resources

Legal Information

Intel, VTune and the Intel logo are trademarks of Intel Corporation in the U.S. and/or other countries.

* Other names and brands may be claimed as the property of others.

Microsoft, Windows, and the Windows logo are trademarks, or registered trademarks of Microsoft Corporation in the United States and/or other countries.

Copyright © 2013-2015, Intel Corporation. All rights reserved.


Viewing all articles
Browse latest Browse all 1853

Trending Articles