Intel® VTune™ Amplifier

Generating Command Line Configuration from GUI

Use the Intel® VTune™ Amplifier to automatically generate a command line for an analysis configuration and copy this line to the buffer for running from a terminal window. You can use this approach to run the generated command line configuration on a different system.

To generate and apply a command line configuration:

Prerequisites:Set up your project.

  1. Run the VTune Amplifier graphical interface.
  2. Click the (standalone GUI)/ (Visual Studio IDE)Configure Analysis toolbar button to choose and configure an analysis type.

    The Configure Analysis window opens.

  3. From the HOW pane, choose a predefined or custom analysis type and configure the required settings.
  4. Click the Command Line button at the bottom of the window.

    The Copy Command Line to Clipboard dialog box opens providing the command line required to launch the selected analysis type configuration.

    Note

    To reuse an analysis configuration on a different system, select the Use -collect-with action option that replaces the displayed command line with the corresponding custom configuration (-collect-with runsa | runss). This option makes your configuration self-contained and runnable on other systems with no dependencies.

  5. Click the Copy button to copy the command line to the clipboard.

    You may select the Hide knobs with default values option to make the command line shorter and easier to read (recommended). Including default knob values makes the command line more self-contained and informative.

  6. Paste the copied command line to the shell.
  7. Optionally, edit the application data in the command line as required.

    If you analyze a remote application from the local host, make sure to:

    • Set up your remote Linux or Android target system for data collection.

    • Specify the correct path to the remote application in the command line.

    • Use the -target-system=<system_details> option to specify your remote target address (for Linux) or device name (for Android). For example:

      host>./amplxe-cl -target-system=ssh:user@hostName -collect hotspots -- myapp

  8. Press Enter to launch the analysis from the command line.

    VTune Amplifier collects the data and saves the result to the analysis result directory under your working directory.

  9. Open your data collection result file in the GUI or as a text-based command line report.

    Note

    To enable analyzing the source code, make sure to copy the required symbol/source files from your remote machine and update the search directories in the Binary/Symbol Search or Source Search dialog boxes.

Example: Command Line for a Custom Configuration

Create a custom configuration based on the Hotspots analysis, enable the Analyze OpenMP regions option, and click the Command Line button:

VTune Amplifier saves your changes for the current custom configuration (note that the option for OpenMP analysis does not show up in the command line explicitly). But if you copy this command line and run on a different machine, the OpenMP region analysis will not be applied. To make this configuration reusable with all necessary options visible, select the Use -collect-with action option and click Copy:

See Also