import

Import one or more collection data files/directories.

GUI Equivalent

VTune Amplifier menu > Import Result...

Syntax

-import <PATH>

Arguments

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.

Description

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.

    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 a csv file , 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 data collection. VTune Amplifier adds the externally collected statistics to the result and provides integrated data in the Timeline pane.

    Note

    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.

  • *.pwr processed Intel SoC Watch files with energy analysis data

Example

This example imports the sample_data.tb7 file into a VTune Amplifier project and creates the result directory r000hs:

$ amplxe-cl –import sample_data.tb7 –result-dir r000hs 

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 
For more complete information about compiler optimizations, see our Optimization Notice.
Select sticky button color: 
Orange (only for download buttons)