Connect Streamline to devices using TCP

The Android connection mode, which is accessed from the Start view, allows the Streamline daemon, gatord, to connect and capture data of installed applications running on Android devices. For users profiling executables running on Android shell, gatord runs manually using adb shell.

Procedure

  1. On your host machine, navigate to the Streamline installation directory, <install_directory>/streamline/.

  2. Push the suitable gatord binary for the Android device in use.

    Your installation directory contains two versions of gatord , one version for 32-bit architecture, and one version for 64-bit architecture:

    • <install_directory>/streamline/bin/android/arm/ for 32-bit architectures.

    • <install_directory>/streamline/bin/android/arm64/ for 64-bit architectures.

  3. Run gatord with the --allow-command option.

    For example:

    adb push bin/android/arm64/gatord /data/local/tmp
adb shell
cd /data/local/tmp
./gatord --allow-command

  4. Launch Streamline:

    • On Windows, go to the Start menu, search for Streamline, and then select the Streamline shortcut.

    • On macOS, go to the <install_directory>/streamline folder, and double-click the Streamline.app file.

    • On Linux, navigate to the <install_directory>/streamline folder and run the Streamline file:

      cd <install_directory>/streamline
./Streamline

  5. Open Start → Select device type , and choose TCP.

  6. To select your target, enter the TCP address or the adb <serial-number>. Alternatively, select your target from the list of detected targets.

  7. Enter the details for any command you want to run on the application.

    Image from TCP view with example command

Next steps

Choose a counter template. For more information about how to find and select a counter template, see Choose a counter template.