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

Collecting Data Remotely from the VTune Amplifier GUI

Use the Intel® VTune™ Amplifier graphical interface running on the host system to configure and run performance analysis on a remote regular or embedded Linux* system or Android* device.

Note

Remote analysis on embedded Linux and Android systems is supported by the VTune Amplifier for Systems, part of the Intel System Studio.

Prerequisites:

  1. Your remote Linux or Android system is configured for analysis with the VTune Amplifier.

  2. Your application is built with debug information enabled.

To collect performance data remotely from the graphical interface of the VTune Amplifier:

  1. Create a project in the VTune Amplifier.

    The Choose Target and Analysis Type window opens with the Analysis Target tab active.

  2. From the left pane, under the Accessible Targets select the type of your remote system.
    • Choose remote Linux (SSH) for an embedded or regular Linux system.

    • Choose Android device (ADB) for an Android system.

    Note

    If you do not have a connection to your remote system, you may select the Arbitrary Targets group and create a command line configuration for the required hardware platform and operating system. This command line can be launched later on the intended host.

  3. From the right pane, specify connection details:
    • For the Android ADB connection, select a device from the via ADB on device drop-down menu.

    • For the Linux SSH connection, in the via SSH field enter the username and hostname for your remote machine in the username@hostname format.

  4. From the target type drop-down menu, select your profiling target:
    • For Linux systems, you may select any type of the profiling target: application, process, or system analysis.

    • For Android systems, select any of the following targets:

      • Launch Application to specify an Android binary as a target (not supported for the Basic Hotspots analysis)

      • Launch Android Package to specify an apk file as a target. To see a list of available packages, click the Browse button and select the required package from the Select Package dialog box.

      • Attach to Process to specify a PID or name of the Android process to analyze. Click the Browse button and select the required process in the Select Process dialog box.

      • Profile System for system-wide analysis. System-wide analysis on Android is possible on rooted devices only. To run the event-based sampling collection system-wide, makes sure to disable the call stack analysis.

    When you select a target, the configuration pane is updated with the corresponding target properties.

  5. Specify the target and configure target properties, if required.

    Note

    • If you installed the VTune Amplifier to a non-default directory on the remote system, make sure to specify this path using the VTune Amplifier installation directory on the remote system option.

    • VTune Amplifier temporarily stores data collection results in the /tmp directory on the remote system. If you use a different temporary directory, make sure to specify it with the Temporary directory on the remote system option.
  6. Optionally, click the Binary/Symbol Search or Source Search buttons on the right to specify search directories required for proper symbol resolution.
  7. Switch to the Analysis Type tab and choose an analysis type for your remote collection from the analysis tree.

    The right pane is updated with the configuration options for the selected analysis type.

    Note

    For remote analysis on Android systems, the VTune Amplifier for Systems supports only Basic Hotspots and hardware event-based sampling analysis types. You may analyze power consumption on your Android, Windows or Linux system using the Energy analysis collector, Intel SoC Watch.

  8. Configure the analysis options and click the Start button on the right to run the analysis.
    VTune Amplifier connects to the remote system via SSH (Linux) or ADB (Android), launches your analysis target remotely, collects the performance data on the remote system, copies the collected result to the host machine, and opens it in the default VTune Amplifier viewpoint.

See Also