Set Up Analysis Target
Specify Your Target
- Click theNew Projectbutton on the toolbar to create a new project.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 theHotspotsanalysis in theuser-mode samplingmode with theLaunch Applicationtarget type on theLocal Hosttarget system.
- If you do not run an analysis on the local host, click the Browse button from 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.
- 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.