Set Up Analysis Target
When you create a project for the
Intel® VTune™
performance analysis, you have to specify what you want to profile - your
Profiler
analysis target
, which could be an executable file, a process, or a whole system.
Supported Targets
Before starting an analysis, make sure your target and system are compiled/configured properly for performance profiling.
VTune
supports analysis targets that you can run in these environments:
Profiler
Development Environment Integration | |
Target Platform | |
Programming Language | |
Programming Model |
|
Virtual Environment | |
Containers |
Specify Your Target
To specify your target for analysis:
- If you need to re-configure the target for an existing project, click theConfigure Analysistoolbar button.TheConfigure Analysiswindow opens. By default, the project is pre-configured to run the Performance Snapshot analysis.
- If you do not run an analysis on the local host, expand theWHEREpane and select an appropriate target system.The target system can be the same as thehost system, which is a system where theVTuneGUI is installed. If you run an analysis on the same system where theProfilerVTuneis installed (i.e. target system=host system), such a target system is calledProfilerlocal. Target systems other than local are calledremote systems. But both local and remote systems areaccessibletargets, which means you can access them either directly (local) or via a connection (for example, SSH connection to a remote target).Local HostRun an analysis on the local host system.This type of the target system is not available for macOS*.Remote Linux (SSH)Run an analysis on a remote regular or embedded Linux* system.VTuneuses the SSH protocol to connect to your remote system. Make sure to fill in theProfilerSSH Destinationfield with the username, hostname, and port (if required) for your remote Linux target system asusername@hostname[:port].Android Device (ADB)Run an analysis on an Android device.VTuneuses the Android Debug Bridge* (adb) to connect to your Android device. Make sure to specify an Android device targeted for analysis in theProfilerADB Destinationfield. When the ADB connection is set up, theVTuneautomatically detects available devices and displays them in the menu.ProfilerArbitrary Host (not connected)Create a command line configuration for a platform NOT accessible from the current host, which is called anarbitrary target.
- From theWHATpane, specify an application to launch or click the
Browse button to select a different target type:
Launch Application(pre-selected)Enable theLaunch Applicationpane and choose and configure an application to analyze, which can be either a binary file or a script.This target type is not supported for the Hotspots analysis of Android applications. Use theAttach to ProcessorLaunch Android Packagetypes instead.Attach to ProcessEnable theAttach to Processpane and choose and configure a process to analyze.Profile SystemEnable theProfile Systempane and configure the system-wide analysis that monitors all the software executing on your system.Launch Android PackageEnable theLaunch Android Packagepane to specify the name of the Android* package to analyze and configure target options.
- If you use VTune Profiler as a web server, the list of available targets and target systems differs.
- For driverless event-based sampling data collection,VTunesupports local and remote Launch Application, Attach to Process and Profile System target types but their support fully depends on the Linux Perf profiling credentials specified in theProfiler/proc/sys/kernel/perf_event_paranoidfile and managed by the administrator of your system using root credentials. For more information see theperf_event related configuration filestopic at http://man7.org/linux/man-pages/man2/perf_event_open.2.html. By default, only user processes profiling at the both user and kernel spaces is permitted, so you need granting wider profiling credentials via theperf_event_paranoidfile to employ the Profile System target type.
What's Next
As soon as you specified the analysis system and target, you may either click the
Start
button to run
Performance Snapshot or click the analysis name in the analysis header to choose a different analysis type.