Generating Command Line Configuration from GUI

Intel® VTune™ Amplifier can 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.

You can generate a command line for:

• Predefined analysis type configuration

• Custom analysis type configuration

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

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

1. Run the VTune Amplifier graphical interface.

2. Click the New Analysis toolbar button to choose and configure an analysis type.

   The Analysis Type window opens.

3. Right-click the Custom Analysis node in the analysis tree on the right and choose a data collection type.

   VTune Amplifier provides an option to create a custom analysis type based on the hardware event-based sampling collection or user-mode sampling and tracing collection.

   Note

   You can also choose an existing predefined configuration in the analysis tree, right-click it, and select Copy from Current, or click the Copy button in the predefined analysis configuration pane.

4. Edit the default configuration as required.

5. Click the Command Line... button on the command toolbar.

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

6. Click the Copy button in the Custom analysis file location field to copy the path to your custom configuration file to the clipboard.

7. Locate the custom configuration file and copy it to the clipboard.

8. Paste the configuration file to a directory of your choice.

9. Click the Copy button in the Command line field to copy the command line to the clipboard.

10. Paste the copied command line to the shell.

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

    • Enable the Use -collect-with option check box to add your custom settings to the command line. Alternatively, you may disable this option and copy the path to the custom configuration file to the command line launching your analysis.

    • 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-with runss -knob sampling-interval=12 -knob cpu-samples-mode=stack -knob signals-mode=stack -knob waits-mode=stack -app-working-dir myapp_dir -- myapp

12. Press Enter to launch the analysis.

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

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