Intel® VTune™ Amplifier 201

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.

Intel VTune Amplifier provides options to:

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 (standalone GUI)/ (Visual Studio IDE)New Analysis toolbar button to choose and configure an analysis type.

    The Analysis Type tab opens.

  3. From the left pane, 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 analyze_locks application, the following command line is available:

    Copy Command Line to Clipboard Dialog Box

    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, click the Arbitrary Targets button 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, 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 left pane, 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