import
import
Import
one or more collection data files/directories.
GUI Equivalent
VTune
menu >
Profiler
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
.
You may import the following formats:
Profiler
- .tb6or.tb7with event-based sampling data. To import the files, use the-result-diroption and specify the name for a new directory you want to create for the imported data. If you do not use the-result-diroption, theVTunecreates a new directory with the default name.Profiler
- .perffiles with event-based sampling data collected by Linux* Perf tool. To ensure accurate data representation in theVTune, make sure to run the Perf collection with the predefined command line options:Profiler
- 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-eoption is used to specify a list of events to collect as-e <;list of events>--call-graphoption (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 acsvfile , use the-result-diroption and specify the name of an existing directory of the result that was collected by theVTunein parallel with the external data collection.ProfilerVTuneadds the externally collected statistics to the result and provides integrated data in theProfilerTimelinepane.Importing acsvfile to theVTuneresult does not affect symbol resolution in the result. For example, you can safely import aProfilercsvfile to a result located on a system where module and debug information is not available.
- *.pwrprocessed Intel SoC Watch files with energy analysis data
Example
This example imports the
sample_data.tb7
file into
a
VTune
project and creates the result directory
Profiler
r000hs
:
vtune –import sample_data.tb7 –result-dir r000hs
This example imports a trace file collected with the
Linux Perf tool into a
VTune
project and creates a default result directory
Profiler
r000
(since no result directory is specified from the
command line):
vtune -import perf_trace.perf