Intel® VTune™ Amplifier XE and Intel® VTune™ Amplifier for Systems Help

Collecting Data on Remote Linux* Systems from the Command Line

Intel® VTune™ Amplifier enables you to collect data on a remote application from the host system (Remote Performance Analysis Workflow for Linux* Systems) via command line interface (amplxe-cl) and view the analysis result locally in the GUI. Remote data collection using the amplxe-cl command running on the host is similar to the native collection on the target except that the target-system option is added to the command line.

Prerequisites:

Note

If you plan to collect data in the Remote Performance Analysis Workflow for Linux* Systems using the full-scale command line interface of the VTune Amplifier installed on your target Linux system, see the topic Running Command Line Analysis. You may use the Command Line option in the VTune Amplifier graphical interface to automatically generate a command line for an analysis configuration selected in the GUI. Make sure to edit the generated command line for remote collection as described in the Generating Command Line Configuration from GUI topic.

Use the following command line syntax to run the analysis on remote Linux system:

host>./amplxe-cl -target-system=ssh:user@target <-action> <-analysis_type> [<-knob> [knobName=knobValue]] [-target-tmp-dir=PATH] [-target-install-dir=PATH][--] <target>

where

Examples

Example 1: Event-based System-wide Sampling Collection

The command line below collects system-wide Advanced Hotspots Analysis information without call stacks. This command automatically pulls in modules required for viewing results from the device and caches them in the temp directory on the host. This happens only on the first collection, all subsequent collections reuse modules from the cache.

host>./amplxe-cl -target-system=ssh:user1@172.16.254.1 –collect advanced-hotspots -duration 10

For system-wide collection, a lot of modules running in the system during collection are copied from the target to the host, which may take a while. However, this happens only once since amplxe-cl caches target system modules on the host for faster access on the next collection. If you do not want the command to take the modules from the device, you can specify a local directory where modules will be searched first, for example:

host>./amplxe-cl -target-system=ssh:user1@172.16.254.1 –collect advanced-hotspots -duration 10 -search-dir <PATH>

In the case above, <PATH> can be either a directory where modules are located, or it can be a pointer to the root file system of the target device. For example, when the collector searches for the /usr/lib64/libstdc++.so.6.0.16 file from the target device, it first tries <PATH>/usr/lib64/libstdc++.so.6.0.16, then it tries <PATH>/libstdc++.so.6.0.16, and only after that it attempts to copy the file from the target device.

Example 2: Event-based Sampling Collection

This example shows hot to attach the analysis to a running application by its PID.

host>./amplxe-cl -target-system=ssh:user1@172.16.254.1 –collect advanced-hotspots -target-pid 333

Example 3: Advanced Event-based Sampling Collection

You can take any event supported by the Performance Monitoring Unit (PMU). Additionally, you can enable multiple event collection at a time.

The following example identifies potential latency or responsiveness issues:

host>./amplxe-cl -target=ssh:user1@172.16.254.1 -duration 10 -collect-with runsa -knob event-config="CPU_CLK_UNHALTED.REF:sa=20000”

This command line takes samples at ~2x the rate of a context switch, which gives you an approximately 20% performance hit.

See Also