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.
1 Like
4

I’m trying to export Log message. The Log view of insights UI provide a Menu Option “Save All As…“. It can save all the (filtered) logs to a text file (tab-separated values or comma separated values)

Is there a CLI to achieve the above function?

5

were you able to solve this issue?

I have the same problem. I tried every combination of parameters and also tried using an RSP script.

The trace is loaded, the analysis is completed, but I never see the execution of the commands to export the traces.
The log file is generated in the correct folder where the trace should be, so no folder access problem

If I execute without the -NoUI , I can see that Insights loaded the correct trace, and I can export it manually.

I tried many different paths, including my user’s document folder, and no luck.

I’m also on Windows 11, but Unreal 5.5