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

6

Hello, I have two questions:

  1. All commands work for me except TimingInsights.ExportCounters. It always returns the error “Failed to open file for write.” I tried both letting Insights create the output file and creating the file manually beforehand, but neither worked. I also tested this in UE 5.5 and UE 5.7. Manual export via UI works fine.

  2. What is the intended purpose of TimingInsights.ExportCounters? Exporting Timers makes sense because Timing Events include a TimerId column. However, the CounterValues export does not include CounterId column, and there is also no option to export all counters into a single file. Because of this, it is not possible to match CounterValues with their corresponding Counters.