Intel® VTune™ Profiler User Guide

User Guide

Contents

import

Import one or more collection data files/directories.
GUI Equivalent
VTune
Profiler
 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
Profiler
. 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
    Profiler
     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
    Profiler
    , 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.
  • 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
    Profiler
     in parallel with the external data collection.
    VTune
    Profiler
     adds the externally collected statistics to the result and provides integrated data in the
    Timeline
     pane.
    Importing a
    csv
     file to the
    VTune
    Profiler
     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
Profiler
 project and creates the result directory
r000hs
: 
vtune –import sample_data.tb7 –result-dir r000hs
This example imports a trace file collected with the Linux Perf tool into a
VTune
Profiler
 project and creates a default result directory
r000
 (since no result directory is specified from the command line): 
vtune -import perf_trace.perf

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.