# 📊 Auto-Profiler

<a href="https://flow.letsterra.com/" class="button primary">Visit Website</a> <a href="https://cal.com/terra-demo/30min?overlayCalendar=true" class="button secondary">Schedule a demo</a>

Auto Profiler is an intelligent performance analysis tool designed to reduce the complexity of Unity profiling. While Unity’s built-in Profiler is powerful, it often requires expert knowledge to interpret correctly, and sifting through performance logs can be time‑consuming. Auto Profiler streamlines this process by capturing performance data automatically and using AI‑powered analysis to highlight the most likely performance bottlenecks.

{% hint style="success" %}
Type: *“The frame rate drops in the boss fight — find the issue and suggest fixes.”*\
Profiler pinpoints the costly calls, highlights oversized assets, and proposes optimizations — from code tweaks to asset compression.

**Integrated with Hot Deploy:** Once you implement optimizations, deploy them to 100% of players without app updates. Performance improvements reach everyone—including the 20-30% of players on older devices who normally never update their apps.
{% endhint %}

***

### Feature Overview

In Unity, diagnosing performance issues typically means:

* Running the project in the Editor or on a target device.
* Attaching the Profiler and recording frame-by-frame data.
* Sorting through long lists of CPU, GPU, and memory samples.
* Manually identifying which spike or allocation is causing slowdowns.

This workflow is effective but requires specialized experience and can take hours of digging through logs. The problem is rarely fixing the issue itself—rather, it’s identifying what the issue actually is.

Auto Profiler addresses this by:

* **Capturing profiler snapshots automatically** from Play mode sessions in the Editor or during live tests.
* **Analyzing logs with AI** to flag the most probable root causes of performance issues, such as spikes in draw calls, CPU usage, RAM leaks, or FPS drops.

Instead of parsing hundreds of log entries, developers get a concise shortlist of actionable issues.

### Setting up the Auto-Profiler

{% stepper %}
{% step %}

#### Ask any question &#x20;

<figure><img src="/files/z1ftR8nSVNDPoOnVDV3v" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Auto-profiler is auto-selected for the task

Flow routes to Auto Profiler Assistant based on performance-related keywords

<figure><img src="/files/ZJwPkuZyEeElfjm7n7sa" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

### The Two Profiling Modes&#x20;

Auto-Profiler offers two ways to hunt down performance issues:

#### Live Profiling Mode

**What it does:** Connects directly to your game while you're playing and catches performance problems in real-time.

**Best for:**

* Active development and testing
* When you can reproduce a specific issue
* Getting immediate feedback on performance changes

#### Player Data Mode

**What it does:** Analyzes your existing telemetry data to find patterns in what real players experienced.

**Best for:**

* Understanding what's happening to live players
* Investigating performance complaints you can't reproduce
* Analyzing trends across many player sessions
* When you have telemetry data but can't test locally

### Live Profiling Mode

{% stepper %}
{% step %}

### Choose Live Profiling&#x20;

Select the Live Profiling option if you want to live run the profiler

<figure><img src="/files/BwQlF9ON15I6JOoPnJaY" alt="" width="375"><figcaption></figcaption></figure>

{% endstep %}

{% step %}

### System scans for devices on same network&#x20;

* Scans network for devices with debugging enabled
* Tries to establishes profiling connection

<figure><img src="/files/8rv40taREPowM1iunkZ4" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Device detected

* Reads device specs (build version, available memory, connection status)
* Analytics Ninja monitors for gameplay event patterns

<figure><img src="/files/AACVZkyYMMqdRH7ut76s" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### **Detects FPS Issue**

* Hooks into Unity's profiler
* Monitors frame rate, memory allocation, asset loading in real-time
* Detects performance-critical events automatically
* Captures FPS metrics during detected events, records drop severity, duration, memory spikes.

<figure><img src="/files/y6BnxmEmLF9QRVc4d99F" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Culprits analyzed by AI&#x20;

* Cross-references loaded assets with performance drop timing
* Identifies scripts with high call counts during drops
* Ranks assets by performance impact (CPU/GPU/memory)

<figure><img src="/files/JgtkyXhZUB4aULxLyBOu" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### Player Data Mode&#x20;

{% stepper %}
{% step %}

### Select Real Player Data&#x20;

Analytics Ninja searches telemetry database for recent player sessions matching criteria

<figure><img src="/files/9ZencH1axJFys7BZhOoD" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Let the system go through logs&#x20;

* Filters sessions by time window (last 3 hours)
* Extracts performance events from session logs
* Counts total sessions and relevant events

<figure><img src="/files/xCrfS5VMVIgT0rhi8vF8" alt="" width="375"><figcaption></figcaption></figure>

{% endstep %}

{% step %}

### Auto-shortlist most likely root cause&#x20;

<div><figure><img src="/files/Vb719fRLFNOzN5Pgr44O" alt="" width="375"><figcaption></figcaption></figure> <figure><img src="/files/CdG4bT6cNjzF5kMLa5bC" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Get a ready-made shortlist of potential rot causes

<figure><img src="/files/Ou5zqOPEaxV8CI4sUFD3" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### What Auto-Profiler Does Behind the Scenes

* **Profiling Recorder:** Hooks into Unity’s ProfilerRecorder API to capture CPU, GPU, memory, and rendering metrics in the background.
* **Snapshot Management:** Organizes captured frames and stores representative samples for spikes.
* **AI Analysis Layer:** Runs models trained to detect anomalies such as sudden increases in draw calls, frame hitches, or repeated GC allocs.
* **Issue Mapping:** Connects anomalies to Unity objects (scripts, prefabs, or assets) for actionable debugging.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.letsterra.com/product-features/auto-profiler.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.