target-system

Collect data on a remote machine using SSH/ADB connection.

GUI Equivalent

Analysis Target Setup

Syntax

-target-system=<string>

Arguments

<string>

Target system for remote collection. Supported values are:

ssh:username@hostname[:port] - for Linux* systems, where you specify a user name, network name of the remote system accessed via SSH (usually IP address), and a port to connect (if required).
android:deviceName - for Android* systems, where deviceName is the name of an Android device connected via ADB.
mic-native[:card] - for a native Intel® Xeon Phi™ coprocessor application or a launching script on the card, where card is any of the following identifiers of the Intel Xeon Phi coprocessor card: card number, device name, or card host name. By default, the data is collected on card 0.
mic-host-launch[:card] - for any task launched from the host system (a host script, offload application, MPI rank, OpenCL™ application) where card is any of the following identifiers of the Intel Xeon Phi coprocessor card: a card number, device name or card host name. By default, the data is collected on card 0.

Actions Modified

collect, collect-with

Description

Intel® VTune™ Amplifier enables you to analyze applications running on a remote system or coprocessor (target system) using the VTune Amplifier command line interface (amplxe-cl) installed on the host system (remote usage mode). Use the target-system option to specify your target system and enable remote data collection.

For details, see Preparing a Target Linux* System for Remote Analysis and Preparing a Target Android* System for Remote Analysis.

Note

Remote analysis on Linux embedded systems and Android systems is supported by the Intel® VTune™ Amplifier for Systems, part of the Intel® System Studio. Analysis on the Intel Xeon Phi coprocessor is supported by the VTune Amplifier XE.

Example

This command runs Advanced Hotspots analysis and collects stacks for the application on a Linux embedded system:

host>./amplxe-cl --target-system=ssh:user1@172.16.254.1 –collect advanced-hotspots -knob collection-detail=stack-sampling -- <path to the application on the target>

This command runs Basic Hotspots analysis and collects stacks for the application on an Android system:

host>./amplxe-cl –-collect hotspots –-target-system=android -r quadrant_r@@@ --target-process com.intel.fluid

This command runs Advanced Hotspots analysis and collects stacks for the application on an Android system:

host>./amplxe-cl --collect advanced-hotspots --knob collection-detail=stack-sampling --target-system=android -r quadrant_r000 --target-process com.intel.fluid

This command runs Advanced Hotspots analysis with stack collection on the native Intel Xeon Phi coprocessor application:

host>./amplxe-cl --collect advanced-hotspots --knob collection-detail=stack-sampling --target-system=mic-native:myhost-knc0 -r matrix_r001 --search-dir /opt/mpss/3.2.1/sysroots/k1om-mpss-linux/boot  -- /tmp/matrix.mic

Note

Call count collection is not supported for Intel Xeon Phi coprocessor analysis.

This command runs General Exploration analysis with stack collection on an offload application:

host>./amplxe-cl --collect general-exploration --knob=enable-cache-metrics --target-system=mic-host-launch -r matrix_r002 --search-dir sym:p=/opt/mpss/3.2.1/sysroots/k1om-mpss-linux/boot  -- /home/samples/matrix

target-system

GUI Equivalent

Syntax

Arguments

Actions Modified

Description

Note

Example

Note

See Also