Knowledge Base: Unreal Insights - Automated Trace Analysis and CSV export

General Tutorial & Course Discussions
1

Documentation on the command-line exporters supported in Unreal Insights.
This provides all parameters and output examples for the built-in exporters that export various information from a .utrace file to CSV files.

https://dev.epicgames.com/community/learning/knowledge-base/lwx6/unreal-engine-unreal-insights-automated-trace-analysis-and-csv-export

1 Like
2

This is a fantastic start.

Are there any export options for:

  • Memory leaks.
  • Average Fps. - provided a given time segment to evaluate
3

I’m trying to follow the CLI examplese and can’t get the CSV export to fire when I run Insights head-less.

UnrealInsights.exe -OpenTraceFile=file.utrace -ABSLOG="cmd1.log" -AutoQuit -NoUI -ExecOnAnalysisCompleteCmd="TimingInsights.ExportThreads ./CSV/Threads.csv"

Here’s a concise repro of what I’m doing and what I’ve tried so far.

Environment:

  • Windows 11 (23H2, 10.0.22631.5335)
  • Unreal Engine 5.6.0-43139311 (stock UnrealInsights.exe from the launcher build)
  • Trace file: trace.utrace in the working directory
  • Target folder .\CSV exists and is writable

Observations

  • In all cases Insights parses the command line, analyses the trace in ~1.5 s and then exits because of -AutoQuit.
  • The log never mentions TimingInsights.ExportCounterValues being executed and no CSV is created.
  • Running without -AutoQuit -NoUI shows the analysis correctly in the UI and the manual Export Counter Values action works, so the trace itself is fine.
  • There are a lot of [MemAlloc] Invalid Tag on Thread messages, but those don’t seem fatal—Insights still finishes the analysis.