Intel® VTune™ Amplifier XE and Intel® VTune™ Amplifier for Systems Help

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 configure and run your remote application analysis.

Note

Remote performance analysis on embedded Linux* and Android* target systems and remote energy analysis is supported by the Intel® VTune™ Amplifier for Systems, part of the Intel® System Studio.

To generate a command line for a predefined or custom analysis configuration and collect data:

  1. Run the VTune Amplifier graphical interface.
  2. Set up your project and target and click the New Analysis toolbar button to choose and configure an analysis type.

    The Analysis Type tab opens.

  3. From the analysis tree on the left, choose a predefined or custom analysis type and configure the required settings.
  4. Click the Command Line... button at the bottom of the command toolbar.

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

  5. Click the Copy button to copy the command line to the clipboard. For example, for the predefined Concurrency analysis type and the matrix application, the following command line is available:

    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.

    If you need to run a custom configuration, consider using these options:

    • To run the custom analysis on a remote target, select the Use -collect-with action option and click Copy:

    • To save the custom configuration locally and run it regularly from the command line, de-select the Use -collect-with action option and click the Copy button in the Custom analysis type file location field:

  6. Paste the copied command line to the shell.

    The copied *.cfg file location for a custom configuration can be used for your analysis scripts launched from the command line.

  7. Edit the application data in the command line as required.

    If you analyze a remote application, 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.

    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.

To generate a command line for an arbitrary target:
  1. In the Analysis Target window, expand the Arbitrary Targets group in the left pane and select a required type of the target system.

  2. For the selected target system, specify an intended hardware platform (for local analysis), operating system, coprocessor card (for Intel Xeon Phi™ coprocessor analysis), target type (application, process, or a system), and its configuration options.

  3. Click the Choose Analysis button on the right to switch to the Analysis Type window.

  4. In the analysis tree on the left, select a predefined or custom analysis type for your arbitrary target and configure analysis options on the right pane. For example, for a custom microarchitecture analysis you can select hardware events for any of the hardware platforms in the list.

    Note

    The Start button is disabled since you cannot launch an analysis for an arbitrary (that is, not accessible locally or via a remote connection) target from the GUI.

  5. Click the Command Line... button to generate a command line for the selected configuration.

    By default, the VTune Amplifier creates a custom configuration that uses the collect-with option. For example, you are working on the Intel microarchitecture code name Skylake but want to generate a command line analysis configuration for the Intel microarchitecture code name Anniedale running the Microsoft Windows* OS. When you select this platform from the list and select a custom hardware event-based sampling configuration, the VTune Amplifier enables you to add hardware events available on the Intel microarchitecture code name Anniedale:

  6. Click Copy to copy the command line to the buffer and later use it on the intended host (a processor based on the Intel microarchitecture code name Anniedale in the example above).

See Also