User Guide

Intel® VTune™ Profiler User Guide

ID 766319
Date 11/07/2023
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of 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.

    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 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.

    NOTE:

    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