Intel® VTune™ Amplifier XE and Intel® VTune™ Amplifier for Systems Help
Import one or more collection data files/directories.
-import <PATH> |
A string containing the PATH of the data files to import. To import several files, make sure to use the import option for each path.
Use the import action to import one or more collection data files into the VTune Amplifier. You may import the following formats:
.tb6 or .tb7 with event-based sampling data. To import the files, use the -result-dir option and specify the name for a new directory you want to create for the imported data. If you do not use the -result-dir option, the VTune Amplifier creates a new directory with the default name.
.perf files with event-based sampling data collected by Linux* Perf tool. To ensure accurate data representation in the VTune Amplifier, make sure to 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.
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.
csv files with the External Data Import, for example, target application log files converted to a csv file with the Creating a CSV File with External Data. To import the 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.
Importing a csv file to the VTune Amplifier result does not affect symbol resolution in the result. For example, you can safely import a csv file to a result located on a system where module and debug information is not available.
This example imports the sample_data.tb7 file into a VTune Amplifier project and creates the result directory r000ah:
$ amplxe-cl –import sample_data.tb7 –result-dir r000ah This example imports a trace file collected with the Linux Perf tool into a VTune Amplifier project and creates a default result directory r000 (since no result directory is specified from the command line):
$ amplxe-cl -import perf_trace.perf