Importing Results from the Command Line

You can use the import action to import VTune Amplifier *.tb5/*.tb6*/*.perf/*.csv/*.sw1/*.sww1/*.ww1 data collection files and convert them into a result.

Note

Import of Energy analysis files (*.sw1/*.sww1/*.ww1) is supported by the VTune Amplifier for Systems only.

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.

Note

The Linux* kernel exposes Perf API to the Perf tool starting from version 2.6.31. Any attempts to run the Perf tool on kernels prior to this version lead to undefined results or even crashes. See Linux Perf documentation for more details.

To import Performance Profiler results and view data:

Copy the result directory to your local system.
Use the import action to import the required file, setting the imported result directory as a search directory:
amplxe-cl -import <PATH> -source-search-dir <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 import csv files, 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.
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 <path_to_result>/<result>.amplxe
- In the CLI:
  
  amplxe-cl -report <report_type> -result-dir <path_to_result>/<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.

To import Intel Energy Profiler results and view 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

Note

<project_folder> must be a non-existing folder, or you will get an error.
The Energy analysis data file has an extension of .sw1 on an Android* target, .sww1 on a Windows* target, and .ww1 on an Android or Linux target.

You may include a path with the project name in order 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.

Example

This command imports the /home/import/r001.tb6 data collection file, searching the same directory for binary and symbol information. The result is output to the current working directory.

$ amplxe-cl -import /home/Import\r001.tb6 -search-dir /home/import/r001hs

Generate the callstacks report from the imported r001hs Basic Hotspots result, searching the /home/import/r001hs directory for binary and symbol information.

$ amplxe-cl -report callstacks -result-dir /home/import/r001hs -search-dir /home/import/binaries

Importing Results from the Command Line

Note

Note

Note

Note

Note

Example

See Also