Import External Data
Correlate interval or discrete data provided by an external collector with the regular data provided by the
Intel® VTune™
.
Profiler
For example, you can see how the data captured from SoCs or peripheral devices (camera, touch screen, sensors, and so on) correlate with
VTune
metrics collected for your analysis target.
Profiler
VTune
can load and process the following data types:
Profiler
- Interval data with start time and end time
- Samples with a set of counters
Data may be optionally bound to process and thread ID.
To add external performance statistics to a
VTune
result: Profiler
Launch a Custom Data Collector
Collect custom performance data using one of the following modes:
- Application mode:You can leverage the statistics collected by your target application to enhance theVTuneanalysis. For example, a part of your application has many instances executed many times in one run and some of these instances exhibit a performance problem. You can retrieve time frames where problems occur from your application log file and supply this data to theProfilerVTune.Profiler
- Custom collector mode:If you cannot/do not want to collect statistics directly by your application during theVTuneanalysis, you may either create a custom collector or use an existing external collector (for example, ftrace, ETW, logcatthat ) and launch it from theProfilerVTune. To enable this mode, configure aProfilerVTuneanalysis type to use the Custom collector option and specify a command starting your external collector.Profiler
Convert Custom Data to the CSV Format and Import It to
VTune
Profiler
VTune
Profiler
To import the externally collected data to the
VTune
:
Profiler
- Convert the collected custom data to acsvfile with a predefined structure.To do this for the custom collector mode, you need to configure the collector to output the data in the required CSV format using theenvironment variable that identifies the name of the current host required for theVTUNE_HOSTNAMEcsvfile format. For the application mode, you may identify the hostname from theComputer namefield provided in theSummarywindow for your result, or from thesummarycommand line report.
- Import thecsvfile to theVTuneresult using any of the following options:Profilerin GUI:
- Open theVTuneresult that was launched in parallel with the external data collection.Profiler
- Open theAnalysis Targettab, orAnalysis Typetab.
- Click theImport from CSVbutton on the command toolbar on the left.TheChoose a File to Importdialog box opens.
- Navigate to the requiredcsvfile and clickOpen. You may import severalcsvfiles at a time.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.
in CLI: use the option as follows:-r <vtuneexisting result dir> -import <path to csv file>VTuneprocesses the data gathered by its own collectors and the external application and provides an integrated picture of your code performance in its standard data views, such as theProfilerTimelinepane,Bottom-uppane and others.
If you develop a custom collector yourself, you may use the
environment variable to make your collector identify the
VTUNE
_DATA_DIRVTune
result directory and automatically save the custom collection result (in the CSV format) to this directory. In this case, external statistics will be imported to the
Profiler
VTune
result automatically.
Profiler