Skip to content
Vadim edited this page May 3, 2026 · 6 revisions

Performance Analyzer

image

Performance Analyzer is an Unreal Engine editor plugin for turning CSV performance captures into readable HTML reports.

It is designed for teams that want to:

  • generate a first report in a few minutes
  • compare multiple captures side by side
  • review frame time, thread time, GPU, memory, draw call, tick, and subsystem metrics
  • highlight regressions with threshold-based filtering
  • share browser-friendly reports with non-programmers

Supported engine versions: Unreal Engine 5.0 and newer

What the Plugin Does

Performance Analyzer reads one or more Unreal CSV capture files and generates:

  • a single-run HTML report when you provide one CSV
  • a comparison HTML report when you provide two or more CSVs

The generated report can include:

  • key summary metrics
  • grouped graphs
  • per-metric descriptions
  • budget-aware highlighting
  • optimization guidance
  • optional event markers
  • optional interactive graphs

Intended Workflow

If this is your first time using the plugin, follow the pages in this order:

  1. Getting Started
  2. Recording CSV Captures
  3. Creating Your First Report
  4. Understanding the Report
  5. Settings and Advanced Options
  6. Commandlet and CI
  7. Troubleshooting

Quick Start

If you only want the shortest possible path to your first report:

  1. Install the plugin through Epic Games Launcher.
  2. Enable the plugin in Unreal Editor if needed and restart the editor.
  3. Launch your game or PIE session.
  4. Open the in-game console with the ~ key.
  5. Record a CSV capture with:
    • csvprofile start
    • reproduce gameplay
    • csvprofile stop
  6. Find the generated CSV in your project's Saved/Profiling/CSV folder.
  7. In the editor, open Tools > PerformanceAnalyzer.
  8. Add the CSV file, choose an output folder, and click Generate Single Report.
  9. The plugin writes a timestamped HTML report and opens it in an embedded browser window.

Notes Before You Begin

  • Performance Analyzer works with CSV captures, not Unreal Insights trace files.
  • The default report output folder is:
    • <Project>/Saved/PerformanceReports

Wiki Pages

Clone this wiki locally