Documentation

Unity Engine

User Manual

Script Reference

Unity Engine

Collect performance data on a target platform

Connect the Profiler to a device that's running your application.
Read time 2 minutesLast updated 17 days ago
Record performance data with the Unity Profiler on a target platform.
You can record the performance of your application on your chosen release platform to discover realistic performance metrics about your application. The Profiler can connect to your application when it's running on a target device in the following ways:
  • Via the local network
  • Directly via cable
  • Via IP address
Note
The Web platform supports profiling only for projects built with Autoconnect Profiler enabled and doesn't support connections via IP address. For background information, refer to Web performance considerations.

Connect your application to the Profiler

To connect your application to the Profiler:
  1. Open the Build Profiles window (menu: File > Build Profiles)
  2. Select your application’s target platform
  3. Enable the
    Development Build

    ?

    setting
    1. Optionally enable the Autoconnect Profiler setting to automatically connect to the Profiler
    2. Optionally enable Deep Profiling Support to use Deep Profiling
  4. Select Build and Run, and make sure your application is running on your target device.
  5. Open the Profiler window (menu: Window > Analysis > Profiler). If you enabled the Autoconnect Profiler setting, the Profiler automatically collects data.
  6. If the Autoconnect Profiler setting is disabled, Select the Target Selection dropdown menu, next to the Record icon (⏺), and select the target player from the list.
  7. Select the Record icon

Profiler window's Target Selection dropdown

If you’ve enabled the Autoconnect Profiler setting, the Profiler collects data as soon as you open the Profiler window, as long as your application is running. Otherwise, the Profiler window collects data when you select the target from the Target Selection dropdown and select Record.

Connect to an application via IP address

To connect via IP address:
  1. Open the Profiler window (menu: Window > Analysis > Profiler)
  2. Select the Target Selection dropdown menu, next to the Record icon (⏺)
  3. Select <Enter IP> in the dropdown.
  4. Enter the IP address in the dialog that appears, and optionally the port of the player you want to connect to.
  5. Select the Record icon

Continuously collect data

To continuously collect data while your application runs:
  1. Open Player Settings (menu: Edit > Project Settings > Player)
  2. Under Resolution and Presentation, enable Run In Background

Additional resources