Importing Results from the Command Line

You can collect performance data remotely with the Intel® VTune™ Amplifier collectors (for example, SEP collector or Intel SoC Watch collector) or Linux* Perf* collector, import this data to the VTune Amplifier project, and view the data in the graphical or command line interface. Use the import action to import data collection files. Currently the following data formats are supported:

• *.tb6/*.tb7 (sampling raw data files collected with the low-level SEP collector)
• *.perf (Perf data files)
• *.csv ( External Data Import files in the predefined format)
• *.pwr (processed Intel SoC Watch files with Energy Analysis Workflow With Intel® Energy Profiler data collected on Android or Chrome* OS)
• *.sww1 (Intel SoC Watch files with Energy Analysis Workflow With Intel® Energy Profiler data collected on Windows* OS)

• Prerequisites for Importing a *.perf File
• Importing Performance Profiler results and viewing data
• Importing Intel Energy Profiler results and view data

Prerequisites for Importing a *.perf File with Event-Based Sampling Data Collected by the Linux* Perf Tool

Run the Perf collection with the predefined command line options:

• For application analysis:

  >perf record -o <trace_file_name>.perf -call-graph dwarf -e cpu-cycles,instructions <application_to_launch>

• For process analysis:

  >perf record -o <trace_file_name>.perf -call-graph dwarf -e cpu-cycles,instructions <application_to_launch> -p <PID> sleep 15

where the -e option is used to specify a list of events to collect as -e <list of events>; -call-graph option (optional) configures samples to be collected together with the thread call stack at the moment a sample is taken. See Linux Perf documentation on possible call stack collection options (for example, dwarf) and its availability in different OS kernel versions.

Importing Performance Profiler results and viewing data

1. Copy the result directory to your local system.
2. Use the import action to import the required file, setting the imported result directory as a search directory:

   amplxe-cl -import <result_path> -source-search-dir <search_path> -r <result_dir>

   If you do not use the result-dir option, the VTune Amplifier creates a new directory with the default name in the current working directory.

   Note

   To Creating a CSV File with External Data, use the -result-dir option and specify the name of an existing directory of the result that was collected by the VTune Amplifier in parallel with the external collection. VTune Amplifier adds the externally collected statistics to the result and provides integrated data in the Timeline pane.

3. You can use the command line to display the imported result in the VTune Amplifier GUI, or generate a report to view it.

   • In the GUI:

     amplxe-gui <result_dir>/<result>.amplxe

   • In the CLI:

     amplxe-cl -report <report_type> -result-dir <result_dir>/<result>.amplxe

   Note

   • Use the search-dir action-option to specify symbol and binary files locations for module resolution.

   • Make sure to generate the debug information for your binary files using the -g option for compiling and linking. This enables the VTune Amplifier to collect accurate performance data.

   • To minimize the size of the result, you may use the discard-raw-data action-option, but this will prevent re-finalizing the result.

   • Imported result files may not have all the fields that are present in the VTune Amplifier result files, so some types of data may be missing from the report.

Importing Intel Energy Profiler results and viewing data

Run the following command to create a VTune Amplifier project with the Intel SoC Watch trace data:

amplxe-cl –import <path_to_file> -result-dir <project_folder>

where <project_folder> is the VTune Amplifier project directory, for example, r001, or the full path to the result directory, for example: /root/intel/amplsys/projects/my_project/r001

You may include a path with the project name to create the project in a directory other than the current directory.

VTune Amplifier should start up and automatically open your project in the Platform Power Analysis viewpoint.