Profiling & Tracing

Blueprint AI drives Unreal’s profiling stack: capture .utrace traces, the CSV profiler and stat files, take a live performance snapshot, and analyze a trace headless — no Unreal Insights UI required.

Trace capture

Start a trace capturing the default channels Add a bookmark called WaveStart to the active trace Stop the trace and tell me the file size

Live snapshot

Take a live performance snapshot

This returns fps, frame and GPU time, draw calls, primitives, and memory in one call.

Headless analysis

Point the AI at a .utrace and it reads it without opening Insights.

Analyze the trace at Saved/Profiling/run.utrace — give me the frame stats and percentiles Show the top 20 CPU timers in that trace, sorted by total time Show the worst 10 game-thread frames List the trace counters matching “draw”

Tip

The bottleneck report (top timers) and the worst-frames list are the fastest way to ask “what made this frame slow?” — the AI can capture a trace during PIE, stop it, and analyze it in the same chat turn.