1. 项目概述为什么我们需要UE4 Insights如果你在UE4项目开发中遇到过“游戏卡顿”、“加载缓慢”或者“内存莫名飙升”这类问题并且对着性能分析器Profiler里密密麻麻的线程和函数调用感到无从下手那么UE4 Insights就是你一直在找的那把“手术刀”。它不是一个简单的帧率监视器而是一个由Epic官方提供的、深度集成在引擎内部的高性能遥测捕获与分析套件。简单来说它能把游戏运行时引擎内部发生的几乎所有重要事件——从CPU线程的每一毫秒执行到GPU的渲染指令再到内存的分配释放、网络包的收发、甚至UI元素的更新——都像飞机黑匣子一样以极低的性能开销记录下来并生成一份结构化的、可视化的“体检报告”。与传统的采样分析器不同Insights采用的是事件追踪Event Tracing技术。这意味着它记录的是带有精确时间戳和上下文信息的“事件”比如“BeginRenderViewFamily”、“LoadPackage ‘/Game/Maps/Start’”、“NetSendBunch”等。这种基于事件的追踪方式让我们能够精确地重现问题发生的完整上下文而不是仅仅看到一个统计上的热点函数。对于解决那些偶发的、难以复现的性能问题或者优化复杂系统的交互逻辑Insights的价值是无可替代的。2. 核心需求解析谁需要它以及它能解决什么问题2.1 目标用户画像技术美术TA与图形程序员需要分析GPU渲染管线瓶颈定位特定Pass如BasePass、ShadowDepth的耗时优化材质复杂度或Draw Call数量。Gameplay程序员与系统架构师需要分析游戏逻辑帧耗时排查蓝图或C代码中的性能热点优化Tick开销分析网络同步效率。UI/UX开发人员使用Slate Insights分析UMG/Slate界面的构建、布局和渲染性能解决界面卡顿问题。关卡设计师与场景构建师通过Asset Loading Insights分析场景流送Level Streaming和资产加载的耗时与顺序优化关卡打开速度和内存使用。项目负责人与制作人通过宏观的Timing视图了解游戏整体性能基线监控各模块耗时趋势为性能预算Performance Budget的制定和验收提供数据支持。2.2 核心解决场景定位偶发性卡顿Hitch游戏运行流畅但每隔几十秒会突然卡一下。传统Profiler可能抓不到瞬间的峰值而Insights的Timing视图可以精确捕捉到卡顿发生的那一帧并展开该帧内所有线程的活动快速定位是物理计算、GC垃圾回收还是某个资产的同步加载导致了卡顿。内存泄漏与不合理分配游戏运行一段时间后内存持续增长。Memory Insights可以追踪每一次内存分配和释放的调用栈让你清晰地看到是哪些资产、哪些代码路径导致了内存没有被正确释放或者存在大量的碎片化小对象分配。网络同步性能分析在多人游戏中某些玩家延迟高或带宽占用异常。Networking Insights可以可视化每个网络通道Channel的带宽使用、RPC调用频率、属性复制开销帮助优化网络同步逻辑减少不必要的网络流量。资产加载与流送优化打开大型关卡或切换场景时加载时间过长。Asset Loading Insights可以展示每个资产包.uasset的加载顺序、耗时以及依赖关系帮助你调整包的优先级、合并小包或拆分大包实现更平滑的流送体验。注意UE4 Insights虽然强大但它主要侧重于引擎运行时行为的分析。对于纯粹的Shader性能分析如使用RenderDoc、底层硬件计数器如使用Intel VTune或AMD uProf或者第三方库的内部性能可能需要结合其他工具。3. 环境准备与工具启动3.1 获取Unreal Insights工具Insights工具通常随UE4引擎一同安装。根据你的引擎版本和安装方式启动路径略有不同。1. 预编译二进制版本推荐如果你通过Epic Games Launcher安装了二进制版本的引擎这是最常见的方式Insights工具位于引擎目录下[YourEngineInstallPath]\Engine\Binaries\[Platform]\UnrealInsights[.exe]Windows:...\Engine\Binaries\Win64\UnrealInsights.exeMac:.../Engine/Binaries/Mac/UnrealInsights.app/Contents/MacOS/UnrealInsightsLinux:.../Engine/Binaries/Linux/UnrealInsights2. 从源代码构建如果你是从GitHub克隆源码自行编译引擎则需要单独编译Insights目标。在Visual Studio中在解决方案资源管理器中找到Programs/UnrealInsights项目右键生成。使用命令行Windows在引擎根目录打开命令行执行Engine\Build\BatchFiles\RunUBT.bat UnrealInsights Win64 Development使用命令行Mac/Linux./Engine/Build/BatchFiles/RunUBT.sh UnrealInsights [Linux|Mac] Development3.2 启动Trace Server追踪服务器从UE 5.3开始Unreal Trace Server在桌面平台是默认启用的它是一个常驻后台的轻量级服务负责接收和存储从编辑器或游戏进程发来的追踪数据。你通常不需要手动启动它。首次启动当你第一次运行UnrealInsights.exe或从编辑器内启动Insights时Trace Server会自动在后台启动。服务管理Trace Server会监听1981端口。如果你想手动关闭它可以在命令行中导航到Engine\Binaries\Win64\目录执行UnrealTraceServer.exe kill数据存储位置Trace Server将生成的追踪文件.utrace和缓存文件.ucache默认存储在用户目录下Windows:%LOCALAPPDATA%\UnrealEngine\Common\UnrealTrace\Mac/Linux:~/UnrealEngine/UnrealTrace/3.3 从虚幻编辑器中启动追踪这是最便捷的日常使用方式。在编辑器界面的底部状态栏你可以找到Trace/Insights Status Bar Widget追踪/Insights状态栏部件。配置追踪通道Channels点击状态栏上的“Trace”下拉按钮。这里列出了所有可追踪的通道如cpu、gpu、log、memory、network、slate、assetloadtime等。默认可能只开启了cpu和log。根据你的分析目标勾选需要的通道。例如分析内存就勾选memory分析UI就勾选slate。实操心得开启过多通道会增加运行时开销和最终文件大小。建议按需开启。对于常规性能排查cpu、gpu、log是基础。memory追踪开销较大仅在怀疑内存问题时开启。开始录制配置好通道后点击“Start”按钮。编辑器或游戏进程就会开始向Trace Server发送追踪数据。状态栏会显示“Recording...”和已记录的数据大小。停止并分析点击“Stop”按钮结束录制。随后点击“Unreal Insights (Session Browser)”按钮这将打开Insights的会话浏览器窗口你刚才录制的会话会出现在列表中。3.4 在独立游戏Standalone Game中启动追踪有时我们需要分析打包后游戏的性能这就需要通过命令行参数来启动追踪。启动游戏并连接Trace Server在游戏的可执行文件启动命令后添加-tracehost127.0.0.1如果Trace Server在本机。例如MyGame.exe -tracehost127.0.0.1控制追踪游戏启动后默认不会立即开始记录。你需要通过控制台命令来控制开始记录: 在游戏内按~打开控制台输入Trace.Start。你也可以在启动命令中直接加入-tracestart来自动开始。停止记录: 控制台输入Trace.Stop。指定通道: 在启动命令或控制台中指定如-tracecpu,gpu,memory。在Insights中查看游戏运行时打开Unreal Insights工具在“会话浏览器”的“连接”选项卡中你应该能看到一个“实时LIVE”会话双击即可连接并实时查看分析数据。4. 核心界面解析与数据加载当你打开Unreal Insights主界面或通过会话浏览器加载一个追踪文件.utrace后你会看到一个功能强大的分析工作区。我们重点解析几个核心部分。4.1 会话浏览器Session Browser这是所有分析的起点。界面主要分为两部分存储Store列出Trace Server存储目录下所有已保存的追踪会话文件.utrace。你可以在这里管理、重命名或删除历史记录。连接Connection显示当前通过Trace Server连接的实时游戏或编辑器会话。状态显示为“LIVE”你可以双击连接进行实时分析。加载追踪文件的几种方式在“存储”列表中双击任一.utrace文件。选中文件后点击右上角的“打开追踪Open Trace”按钮。直接从Windows资源管理器拖拽一个.utrace文件到Insights主窗口。使用菜单栏的文件File - 打开追踪文件Open Trace File...。4.2 主视图布局与Timing Insights加载追踪后默认打开的是Timing Insights窗口这是使用频率最高的视图。时间轴视图Timeline View, 顶部水平方向是时间轴毫秒或帧垂直方向是各个线程轨道Thread Tracks。每个彩色条代表一个事件Event长度代表其持续时间。你可以用鼠标滚轮缩放时间轴按住中键拖动平移。CPU线程如GameThread、RenderThread、RHIThread以及各个任务线程TaskGraph。GPU轨道显示GPU上的渲染阶段如PrePass、BasePass、ShadowDepths、PostProcessing等。帧面板Frames Panel, 左侧垂直列出每一帧的编号和该帧的总耗时。点击任一帧时间轴会自动定位并高亮该帧的范围。这是快速定位卡顿帧的利器。计时面板Timing Panel, 底部当你选中时间轴上的一个或多个事件时这里会显示事件的详细信息包括名称、持续时间、开始/结束时间、调用栈如果已捕获等。右侧的“调用者/被调用者Callers/Callees”面板可以分析该事件的函数调用关系。计数器与计时器标签Counters Timers这里以图表形式显示一些聚合数据如帧时间Frame Time、内存使用量Memory Usage、Draw Call数量等的变化曲线。日志面板Log Panel显示追踪过程中输出的日志信息与事件时间轴关联方便你结合日志分析问题。操作技巧框选放大在时间轴上按住鼠标左键拖动可以框选一个区域进行放大查看。搜索事件使用顶部的搜索框可以按名称过滤事件。例如搜索“Tick”可以快速找到所有Tick事件。书签Bookmarks在发现关键问题点时可以添加书签按B键或点击工具栏按钮并添加注释便于后续回顾和团队协作。4.3 其他专业Insights视图除了Timing视图Insights还提供了多个针对特定领域的深度分析视图可以通过顶部标签页或“窗口Window”菜单切换。Memory Insights用于深度分析内存使用。它可以展示内存分配热图按大小、数量、分配栈可视化内存块。内存标签LLM如果项目中启用了LLMLow Level Mem Tracker可以按引擎定义的内存类别如UObject、RenderTarget、Audio等查看内存分布。分配调用栈对于可疑的内存增长可以展开查看是哪些代码路径进行了分配。Networking Insights分析网络流量。视图包括网络流量图按时间展示每个连接的上传/下载带宽。属性复制详情查看每个Actor的每个属性复制的频率和大小。RPC调用列表统计所有远程过程调用的次数和耗时。Slate Insights专攻UI性能。可以分析Slate Widget的Tick和Paint耗时。无效化Invalidation和重绘Repaint的触发链帮你找到导致界面频繁刷新的根源。Asset Loading Insights分析资产加载。核心功能是资产加载时间线显示每个资产包开始加载和结束加载的时间点。加载依赖图可视化资产包之间的加载依赖关系。按类型筛选可以快速查看纹理、静态网格体、蓝图等不同类型资产的加载情况。5. 实战演练定位并解决一个典型性能问题让我们通过一个虚构但常见的场景走一遍完整的Insights实战流程。问题描述在第三人称动作游戏中每当角色靠近场景中某个特定区域比如一个有很多可交互物件的集市时帧率会从稳定的60FPS骤降到40FPS左右有明显的卡顿感。5.1 第一步录制性能数据在编辑器中打开存在问题的关卡。在编辑器底部状态栏点击“Trace”下拉菜单确保至少勾选了cpu和gpu通道。为了更全面我们也勾选log。点击“Start”开始录制。操作角色正常游戏并特意走到那个导致掉帧的集市区域停留几秒让问题充分暴露。点击“Stop”停止录制。点击“Unreal Insights (Session Browser)”在存储列表中找到刚刚录制的会话通常以时间命名双击打开。5.2 第二步宏观定位问题帧打开后注意力首先放在帧面板Frames Panel。滚动列表寻找帧时间Frame Time突然升高的帧。通常掉帧的那一帧时间会远高于前后帧例如从16ms跳到25ms。点击那帧时间轴会自动居中显示。观察时间轴视图。在高帧耗时的区域你会看到某些线程上的事件条明显变长、变密集。最常见的问题是GameThread或RenderThread出现了“长条”。如果长条出现在GameThread通常是游戏逻辑蓝图或C计算过重。如果长条出现在RenderThread通常是渲染指令提交或资源准备有瓶颈。如果GameThread和RenderThread都长但GPU轨道空闲可能是它们之间的同步等待如等待资源加载。如果GPU轨道如BasePass出现长条则是GPU渲染瓶颈。5.3 第三步微观剖析问题根源假设我们发现是GameThread上出现了一个长达8毫秒的“长条”。缩放与框选使用鼠标滚轮放大这个长条所在的区域直到能看清内部的一个个独立事件。识别可疑事件浏览GameThread轨道上的事件。你可能会看到诸如TickActor、ExecuteUbergraph蓝图执行、某个特定的C函数名、或者LoadPackage、CreateObject等。点击探查点击那个最宽、最可疑的事件条。底部的计时面板Timing Panel会显示该事件的详情。事件名称比如TickActor: BP_InteractiveVendor_C。持续时间假设显示6.8ms这在一个帧内是极高的开销。调用栈Call Stack如果录制时启用了符号需要在高级设置中配置这里可以展开看到完整的函数调用链直接定位到代码行。分析调用关系查看右侧的“被调用者Callees”面板。这里列出了在这个TickActor事件内部调用的所有子事件及其耗时。你可能会发现大部分时间花在了一个名为UpdateVendorStock的蓝图函数里或者是在遍历一个包含数百个物品的数组进行价格计算。5.4 第四步结合其他视图交叉验证查看日志Log Panel在问题发生的时间点附近过滤日志看看是否有相关的Warning或Log输出比如“Loading large data table...”。使用Memory Insights如果开启了memory通道切换到Memory视图查看在卡顿帧附近是否有大规模的内存分配Allocation事件这可能暗示着意外的资源加载或数据创建。使用Asset Loading Insights检查是否在卡顿时触发了同步资产加载Sync Load这会阻塞游戏线程。5.5 第五步提出并验证解决方案根据分析假设我们定位到问题是集市中每个商贩Actor的Tick里都在执行一个O(n^2)复杂度的库存价格比对算法。优化方案将价格计算改为异步或者缓存计算结果只在库存变更时重新计算而不是每帧计算。验证优化修改代码。按照同样的路径走到集市在同样的条件下相同的Trace通道设置重新录制一段性能数据。在Insights中打开新的追踪文件与旧的进行对比。可以直接并排打开两个窗口或者使用Insights的“比较”功能如果支持。重点观察之前那个6.8ms的TickActor事件现在它的耗时应该大幅降低GameThread的帧耗时也应恢复正常。避坑技巧在进行性能对比测试时务必确保测试环境硬件、场景状态、操作路径尽可能一致并关闭其他无关应用程序以减少变量干扰。Insights数据本身是客观的但测试过程需要科学控制。6. 高级配置与自定义追踪6.1 自定义追踪通道与详细程度除了在编辑器UI中勾选通道你还可以通过控制台命令进行更精细的控制。trace.start开始记录。trace.stop停止记录。trace.enable和trace.disable启用或禁用特定通道。例如trace.enable cpu,gpu,memory,slate trace.disable log设置详细程度Verbosity对于log通道可以设置日志级别。trace.set_log_verbosity LogMyCategory Verbose // 记录该类别所有日志 trace.set_log_verbosity All Warning // 只记录Warning及以上级别的所有日志6.2 在C代码中添加自定义追踪事件Insights的强大之处在于可以扩展。你可以在自己的C代码中插入自定义事件来追踪特定模块的性能。// 需要包含头文件 #include Trace/Trace.inl // 使用 TRACE_CPUPROFILER_EVENT_SCOPE 宏来定义一个CPU范围事件 void MyExpensiveFunction() { TRACE_CPUPROFILER_EVENT_SCOPE(MyModule_MyExpensiveFunction); // 这个字符串会在Insights中显示 // ... 你的函数逻辑 ... } // 你也可以创建带参数的事件 void LoadAsset(const FString AssetName) { // 使用 TRACE_CPUPROFILER_EVENT_SCOPE_TEXT 支持动态字符串注意性能开销 TRACE_CPUPROFILER_EVENT_SCOPE_TEXT(*FString::Printf(TEXT(LoadAsset: %s), *AssetName)); // ... 加载逻辑 ... }编译并运行后你的自定义事件MyModule_MyExpensiveFunction和LoadAsset: xxx就会出现在Insights的GameThread轨道上让你能清晰看到自己代码块的执行耗时。6.3 配置Trace Server存储目录如果你希望把追踪文件统一存放到项目目录或网络共享位置方便团队协作可以配置Trace Server。打开Unreal Insights。点击主界面左上角的菜单按钮三条横线。选择“会话浏览器Session Browser”。在会话浏览器窗口中点击“管理存储设置Manage store settings”下拉按钮。点击“设置追踪存储目录Set Trace Store directory”选择一个新的文件夹。之后所有新录制的追踪文件都会保存在这里。你还可以点击“添加目录Add directory”来添加额外的监视文件夹。Insights会同时显示这些文件夹里的所有.utrace文件并用不同颜色区分来源。7. 常见问题排查与实战技巧7.1 问题速查表问题现象可能原因排查步骤与解决方案Insights无法启动或连接1. Trace Server未运行。2. 防火墙阻止了1981端口。3. 引擎版本不匹配。1. 尝试手动运行UnrealTraceServer.exe。2. 检查防火墙设置允许UnrealTraceServer.exe和UnrealInsights.exe。3. 确保Insights工具版本与生成追踪数据的引擎/游戏版本兼容。录制时游戏卡顿严重开启了过多或开销过大的追踪通道如memory的详细堆栈追踪。按需开启通道。分析内存时可先尝试不记录调用栈memory而非memory:stack。在编辑器中录制比在最终游戏中开销小。.utrace文件巨大1GB录制时间过长或开启了高数据量通道如gpu和memory。1. 只录制问题发生前后的关键时段。2. 分析完成后及时清理旧文件。3. 考虑使用trace.set命令限制某些通道的数据量。Insights中看不到GPU轨道1. 录制时未开启gpu通道。2. 使用的RHI渲染硬件接口不支持如某些移动平台。1. 确保在开始追踪前勾选了gpu。2. 在PC上确保使用DirectX 11/12或Vulkan。自定义C事件未显示1. 代码未编译。2. 未链接Trace模块。3. 事件名称冲突或被过滤。1. 确认代码已重新编译。2. 在项目的.Build.cs文件中添加Trace到PublicDependencyModuleNames。3. 在Insights搜索框中检查事件名。无法看到函数调用栈录制时未捕获符号信息。在编辑器Trace设置中启用高级选项下的“Callstack Capturing”捕获调用栈注意这会显著增加性能开销和文件大小。7.2 高级分析技巧使用“统计Statistics”视图在Timing视图中你可以框选一个时间段然后右键选择“统计”Insights会生成该时间段内所有事件的耗时统计表按总耗时排序能快速找出最耗时的顶级事件。关注“等待Wait”事件线程轨道上灰色的“Waiting”事件通常意味着线程在等待锁、同步点或空闲。过多的等待可能是并行化不合理或资源竞争的表现。关联多视图分析例如在Timing视图发现一个LoadPackage事件导致卡顿立刻切换到Asset Loading视图找到对应的资产加载事件查看其依赖链判断是否是同步加载或依赖了未预加载的资产。建立性能基线在项目性能良好的时候录制一段“标准场景”的追踪文件如空场景、角色站立。以后当性能下降时用同样的场景录制并对比可以快速发现新增的性能开销来自何处。命令行自动化对于需要批量测试的场景可以编写批处理脚本用命令行启动游戏并自动开始/停止追踪然后将.utrace文件归档便于持续集成CI环境进行自动化性能回归测试。性能优化是一个迭代和求证的过程。UE4 Insights提供了无与伦比的深度和广度将引擎的黑盒运行过程变成了可视化的数据流。掌握从启动、录制、分析到最终定位问题的全流程你就拥有了解决绝大多数UE4性能难题的钥匙。记住关键不是记住所有按钮的功能而是形成一套“观察现象 - 假设瓶颈 - 录制数据 - 验证假设 - 实施优化 - 验证效果”的科学工作流。
UE4 Insights性能分析工具：从事件追踪到实战优化全解析
发布时间：2026/7/14 2:37:34
1. 项目概述为什么我们需要UE4 Insights如果你在UE4项目开发中遇到过“游戏卡顿”、“加载缓慢”或者“内存莫名飙升”这类问题并且对着性能分析器Profiler里密密麻麻的线程和函数调用感到无从下手那么UE4 Insights就是你一直在找的那把“手术刀”。它不是一个简单的帧率监视器而是一个由Epic官方提供的、深度集成在引擎内部的高性能遥测捕获与分析套件。简单来说它能把游戏运行时引擎内部发生的几乎所有重要事件——从CPU线程的每一毫秒执行到GPU的渲染指令再到内存的分配释放、网络包的收发、甚至UI元素的更新——都像飞机黑匣子一样以极低的性能开销记录下来并生成一份结构化的、可视化的“体检报告”。与传统的采样分析器不同Insights采用的是事件追踪Event Tracing技术。这意味着它记录的是带有精确时间戳和上下文信息的“事件”比如“BeginRenderViewFamily”、“LoadPackage ‘/Game/Maps/Start’”、“NetSendBunch”等。这种基于事件的追踪方式让我们能够精确地重现问题发生的完整上下文而不是仅仅看到一个统计上的热点函数。对于解决那些偶发的、难以复现的性能问题或者优化复杂系统的交互逻辑Insights的价值是无可替代的。2. 核心需求解析谁需要它以及它能解决什么问题2.1 目标用户画像技术美术TA与图形程序员需要分析GPU渲染管线瓶颈定位特定Pass如BasePass、ShadowDepth的耗时优化材质复杂度或Draw Call数量。Gameplay程序员与系统架构师需要分析游戏逻辑帧耗时排查蓝图或C代码中的性能热点优化Tick开销分析网络同步效率。UI/UX开发人员使用Slate Insights分析UMG/Slate界面的构建、布局和渲染性能解决界面卡顿问题。关卡设计师与场景构建师通过Asset Loading Insights分析场景流送Level Streaming和资产加载的耗时与顺序优化关卡打开速度和内存使用。项目负责人与制作人通过宏观的Timing视图了解游戏整体性能基线监控各模块耗时趋势为性能预算Performance Budget的制定和验收提供数据支持。2.2 核心解决场景定位偶发性卡顿Hitch游戏运行流畅但每隔几十秒会突然卡一下。传统Profiler可能抓不到瞬间的峰值而Insights的Timing视图可以精确捕捉到卡顿发生的那一帧并展开该帧内所有线程的活动快速定位是物理计算、GC垃圾回收还是某个资产的同步加载导致了卡顿。内存泄漏与不合理分配游戏运行一段时间后内存持续增长。Memory Insights可以追踪每一次内存分配和释放的调用栈让你清晰地看到是哪些资产、哪些代码路径导致了内存没有被正确释放或者存在大量的碎片化小对象分配。网络同步性能分析在多人游戏中某些玩家延迟高或带宽占用异常。Networking Insights可以可视化每个网络通道Channel的带宽使用、RPC调用频率、属性复制开销帮助优化网络同步逻辑减少不必要的网络流量。资产加载与流送优化打开大型关卡或切换场景时加载时间过长。Asset Loading Insights可以展示每个资产包.uasset的加载顺序、耗时以及依赖关系帮助你调整包的优先级、合并小包或拆分大包实现更平滑的流送体验。注意UE4 Insights虽然强大但它主要侧重于引擎运行时行为的分析。对于纯粹的Shader性能分析如使用RenderDoc、底层硬件计数器如使用Intel VTune或AMD uProf或者第三方库的内部性能可能需要结合其他工具。3. 环境准备与工具启动3.1 获取Unreal Insights工具Insights工具通常随UE4引擎一同安装。根据你的引擎版本和安装方式启动路径略有不同。1. 预编译二进制版本推荐如果你通过Epic Games Launcher安装了二进制版本的引擎这是最常见的方式Insights工具位于引擎目录下[YourEngineInstallPath]\Engine\Binaries\[Platform]\UnrealInsights[.exe]Windows:...\Engine\Binaries\Win64\UnrealInsights.exeMac:.../Engine/Binaries/Mac/UnrealInsights.app/Contents/MacOS/UnrealInsightsLinux:.../Engine/Binaries/Linux/UnrealInsights2. 从源代码构建如果你是从GitHub克隆源码自行编译引擎则需要单独编译Insights目标。在Visual Studio中在解决方案资源管理器中找到Programs/UnrealInsights项目右键生成。使用命令行Windows在引擎根目录打开命令行执行Engine\Build\BatchFiles\RunUBT.bat UnrealInsights Win64 Development使用命令行Mac/Linux./Engine/Build/BatchFiles/RunUBT.sh UnrealInsights [Linux|Mac] Development3.2 启动Trace Server追踪服务器从UE 5.3开始Unreal Trace Server在桌面平台是默认启用的它是一个常驻后台的轻量级服务负责接收和存储从编辑器或游戏进程发来的追踪数据。你通常不需要手动启动它。首次启动当你第一次运行UnrealInsights.exe或从编辑器内启动Insights时Trace Server会自动在后台启动。服务管理Trace Server会监听1981端口。如果你想手动关闭它可以在命令行中导航到Engine\Binaries\Win64\目录执行UnrealTraceServer.exe kill数据存储位置Trace Server将生成的追踪文件.utrace和缓存文件.ucache默认存储在用户目录下Windows:%LOCALAPPDATA%\UnrealEngine\Common\UnrealTrace\Mac/Linux:~/UnrealEngine/UnrealTrace/3.3 从虚幻编辑器中启动追踪这是最便捷的日常使用方式。在编辑器界面的底部状态栏你可以找到Trace/Insights Status Bar Widget追踪/Insights状态栏部件。配置追踪通道Channels点击状态栏上的“Trace”下拉按钮。这里列出了所有可追踪的通道如cpu、gpu、log、memory、network、slate、assetloadtime等。默认可能只开启了cpu和log。根据你的分析目标勾选需要的通道。例如分析内存就勾选memory分析UI就勾选slate。实操心得开启过多通道会增加运行时开销和最终文件大小。建议按需开启。对于常规性能排查cpu、gpu、log是基础。memory追踪开销较大仅在怀疑内存问题时开启。开始录制配置好通道后点击“Start”按钮。编辑器或游戏进程就会开始向Trace Server发送追踪数据。状态栏会显示“Recording...”和已记录的数据大小。停止并分析点击“Stop”按钮结束录制。随后点击“Unreal Insights (Session Browser)”按钮这将打开Insights的会话浏览器窗口你刚才录制的会话会出现在列表中。3.4 在独立游戏Standalone Game中启动追踪有时我们需要分析打包后游戏的性能这就需要通过命令行参数来启动追踪。启动游戏并连接Trace Server在游戏的可执行文件启动命令后添加-tracehost127.0.0.1如果Trace Server在本机。例如MyGame.exe -tracehost127.0.0.1控制追踪游戏启动后默认不会立即开始记录。你需要通过控制台命令来控制开始记录: 在游戏内按~打开控制台输入Trace.Start。你也可以在启动命令中直接加入-tracestart来自动开始。停止记录: 控制台输入Trace.Stop。指定通道: 在启动命令或控制台中指定如-tracecpu,gpu,memory。在Insights中查看游戏运行时打开Unreal Insights工具在“会话浏览器”的“连接”选项卡中你应该能看到一个“实时LIVE”会话双击即可连接并实时查看分析数据。4. 核心界面解析与数据加载当你打开Unreal Insights主界面或通过会话浏览器加载一个追踪文件.utrace后你会看到一个功能强大的分析工作区。我们重点解析几个核心部分。4.1 会话浏览器Session Browser这是所有分析的起点。界面主要分为两部分存储Store列出Trace Server存储目录下所有已保存的追踪会话文件.utrace。你可以在这里管理、重命名或删除历史记录。连接Connection显示当前通过Trace Server连接的实时游戏或编辑器会话。状态显示为“LIVE”你可以双击连接进行实时分析。加载追踪文件的几种方式在“存储”列表中双击任一.utrace文件。选中文件后点击右上角的“打开追踪Open Trace”按钮。直接从Windows资源管理器拖拽一个.utrace文件到Insights主窗口。使用菜单栏的文件File - 打开追踪文件Open Trace File...。4.2 主视图布局与Timing Insights加载追踪后默认打开的是Timing Insights窗口这是使用频率最高的视图。时间轴视图Timeline View, 顶部水平方向是时间轴毫秒或帧垂直方向是各个线程轨道Thread Tracks。每个彩色条代表一个事件Event长度代表其持续时间。你可以用鼠标滚轮缩放时间轴按住中键拖动平移。CPU线程如GameThread、RenderThread、RHIThread以及各个任务线程TaskGraph。GPU轨道显示GPU上的渲染阶段如PrePass、BasePass、ShadowDepths、PostProcessing等。帧面板Frames Panel, 左侧垂直列出每一帧的编号和该帧的总耗时。点击任一帧时间轴会自动定位并高亮该帧的范围。这是快速定位卡顿帧的利器。计时面板Timing Panel, 底部当你选中时间轴上的一个或多个事件时这里会显示事件的详细信息包括名称、持续时间、开始/结束时间、调用栈如果已捕获等。右侧的“调用者/被调用者Callers/Callees”面板可以分析该事件的函数调用关系。计数器与计时器标签Counters Timers这里以图表形式显示一些聚合数据如帧时间Frame Time、内存使用量Memory Usage、Draw Call数量等的变化曲线。日志面板Log Panel显示追踪过程中输出的日志信息与事件时间轴关联方便你结合日志分析问题。操作技巧框选放大在时间轴上按住鼠标左键拖动可以框选一个区域进行放大查看。搜索事件使用顶部的搜索框可以按名称过滤事件。例如搜索“Tick”可以快速找到所有Tick事件。书签Bookmarks在发现关键问题点时可以添加书签按B键或点击工具栏按钮并添加注释便于后续回顾和团队协作。4.3 其他专业Insights视图除了Timing视图Insights还提供了多个针对特定领域的深度分析视图可以通过顶部标签页或“窗口Window”菜单切换。Memory Insights用于深度分析内存使用。它可以展示内存分配热图按大小、数量、分配栈可视化内存块。内存标签LLM如果项目中启用了LLMLow Level Mem Tracker可以按引擎定义的内存类别如UObject、RenderTarget、Audio等查看内存分布。分配调用栈对于可疑的内存增长可以展开查看是哪些代码路径进行了分配。Networking Insights分析网络流量。视图包括网络流量图按时间展示每个连接的上传/下载带宽。属性复制详情查看每个Actor的每个属性复制的频率和大小。RPC调用列表统计所有远程过程调用的次数和耗时。Slate Insights专攻UI性能。可以分析Slate Widget的Tick和Paint耗时。无效化Invalidation和重绘Repaint的触发链帮你找到导致界面频繁刷新的根源。Asset Loading Insights分析资产加载。核心功能是资产加载时间线显示每个资产包开始加载和结束加载的时间点。加载依赖图可视化资产包之间的加载依赖关系。按类型筛选可以快速查看纹理、静态网格体、蓝图等不同类型资产的加载情况。5. 实战演练定位并解决一个典型性能问题让我们通过一个虚构但常见的场景走一遍完整的Insights实战流程。问题描述在第三人称动作游戏中每当角色靠近场景中某个特定区域比如一个有很多可交互物件的集市时帧率会从稳定的60FPS骤降到40FPS左右有明显的卡顿感。5.1 第一步录制性能数据在编辑器中打开存在问题的关卡。在编辑器底部状态栏点击“Trace”下拉菜单确保至少勾选了cpu和gpu通道。为了更全面我们也勾选log。点击“Start”开始录制。操作角色正常游戏并特意走到那个导致掉帧的集市区域停留几秒让问题充分暴露。点击“Stop”停止录制。点击“Unreal Insights (Session Browser)”在存储列表中找到刚刚录制的会话通常以时间命名双击打开。5.2 第二步宏观定位问题帧打开后注意力首先放在帧面板Frames Panel。滚动列表寻找帧时间Frame Time突然升高的帧。通常掉帧的那一帧时间会远高于前后帧例如从16ms跳到25ms。点击那帧时间轴会自动居中显示。观察时间轴视图。在高帧耗时的区域你会看到某些线程上的事件条明显变长、变密集。最常见的问题是GameThread或RenderThread出现了“长条”。如果长条出现在GameThread通常是游戏逻辑蓝图或C计算过重。如果长条出现在RenderThread通常是渲染指令提交或资源准备有瓶颈。如果GameThread和RenderThread都长但GPU轨道空闲可能是它们之间的同步等待如等待资源加载。如果GPU轨道如BasePass出现长条则是GPU渲染瓶颈。5.3 第三步微观剖析问题根源假设我们发现是GameThread上出现了一个长达8毫秒的“长条”。缩放与框选使用鼠标滚轮放大这个长条所在的区域直到能看清内部的一个个独立事件。识别可疑事件浏览GameThread轨道上的事件。你可能会看到诸如TickActor、ExecuteUbergraph蓝图执行、某个特定的C函数名、或者LoadPackage、CreateObject等。点击探查点击那个最宽、最可疑的事件条。底部的计时面板Timing Panel会显示该事件的详情。事件名称比如TickActor: BP_InteractiveVendor_C。持续时间假设显示6.8ms这在一个帧内是极高的开销。调用栈Call Stack如果录制时启用了符号需要在高级设置中配置这里可以展开看到完整的函数调用链直接定位到代码行。分析调用关系查看右侧的“被调用者Callees”面板。这里列出了在这个TickActor事件内部调用的所有子事件及其耗时。你可能会发现大部分时间花在了一个名为UpdateVendorStock的蓝图函数里或者是在遍历一个包含数百个物品的数组进行价格计算。5.4 第四步结合其他视图交叉验证查看日志Log Panel在问题发生的时间点附近过滤日志看看是否有相关的Warning或Log输出比如“Loading large data table...”。使用Memory Insights如果开启了memory通道切换到Memory视图查看在卡顿帧附近是否有大规模的内存分配Allocation事件这可能暗示着意外的资源加载或数据创建。使用Asset Loading Insights检查是否在卡顿时触发了同步资产加载Sync Load这会阻塞游戏线程。5.5 第五步提出并验证解决方案根据分析假设我们定位到问题是集市中每个商贩Actor的Tick里都在执行一个O(n^2)复杂度的库存价格比对算法。优化方案将价格计算改为异步或者缓存计算结果只在库存变更时重新计算而不是每帧计算。验证优化修改代码。按照同样的路径走到集市在同样的条件下相同的Trace通道设置重新录制一段性能数据。在Insights中打开新的追踪文件与旧的进行对比。可以直接并排打开两个窗口或者使用Insights的“比较”功能如果支持。重点观察之前那个6.8ms的TickActor事件现在它的耗时应该大幅降低GameThread的帧耗时也应恢复正常。避坑技巧在进行性能对比测试时务必确保测试环境硬件、场景状态、操作路径尽可能一致并关闭其他无关应用程序以减少变量干扰。Insights数据本身是客观的但测试过程需要科学控制。6. 高级配置与自定义追踪6.1 自定义追踪通道与详细程度除了在编辑器UI中勾选通道你还可以通过控制台命令进行更精细的控制。trace.start开始记录。trace.stop停止记录。trace.enable和trace.disable启用或禁用特定通道。例如trace.enable cpu,gpu,memory,slate trace.disable log设置详细程度Verbosity对于log通道可以设置日志级别。trace.set_log_verbosity LogMyCategory Verbose // 记录该类别所有日志 trace.set_log_verbosity All Warning // 只记录Warning及以上级别的所有日志6.2 在C代码中添加自定义追踪事件Insights的强大之处在于可以扩展。你可以在自己的C代码中插入自定义事件来追踪特定模块的性能。// 需要包含头文件 #include Trace/Trace.inl // 使用 TRACE_CPUPROFILER_EVENT_SCOPE 宏来定义一个CPU范围事件 void MyExpensiveFunction() { TRACE_CPUPROFILER_EVENT_SCOPE(MyModule_MyExpensiveFunction); // 这个字符串会在Insights中显示 // ... 你的函数逻辑 ... } // 你也可以创建带参数的事件 void LoadAsset(const FString AssetName) { // 使用 TRACE_CPUPROFILER_EVENT_SCOPE_TEXT 支持动态字符串注意性能开销 TRACE_CPUPROFILER_EVENT_SCOPE_TEXT(*FString::Printf(TEXT(LoadAsset: %s), *AssetName)); // ... 加载逻辑 ... }编译并运行后你的自定义事件MyModule_MyExpensiveFunction和LoadAsset: xxx就会出现在Insights的GameThread轨道上让你能清晰看到自己代码块的执行耗时。6.3 配置Trace Server存储目录如果你希望把追踪文件统一存放到项目目录或网络共享位置方便团队协作可以配置Trace Server。打开Unreal Insights。点击主界面左上角的菜单按钮三条横线。选择“会话浏览器Session Browser”。在会话浏览器窗口中点击“管理存储设置Manage store settings”下拉按钮。点击“设置追踪存储目录Set Trace Store directory”选择一个新的文件夹。之后所有新录制的追踪文件都会保存在这里。你还可以点击“添加目录Add directory”来添加额外的监视文件夹。Insights会同时显示这些文件夹里的所有.utrace文件并用不同颜色区分来源。7. 常见问题排查与实战技巧7.1 问题速查表问题现象可能原因排查步骤与解决方案Insights无法启动或连接1. Trace Server未运行。2. 防火墙阻止了1981端口。3. 引擎版本不匹配。1. 尝试手动运行UnrealTraceServer.exe。2. 检查防火墙设置允许UnrealTraceServer.exe和UnrealInsights.exe。3. 确保Insights工具版本与生成追踪数据的引擎/游戏版本兼容。录制时游戏卡顿严重开启了过多或开销过大的追踪通道如memory的详细堆栈追踪。按需开启通道。分析内存时可先尝试不记录调用栈memory而非memory:stack。在编辑器中录制比在最终游戏中开销小。.utrace文件巨大1GB录制时间过长或开启了高数据量通道如gpu和memory。1. 只录制问题发生前后的关键时段。2. 分析完成后及时清理旧文件。3. 考虑使用trace.set命令限制某些通道的数据量。Insights中看不到GPU轨道1. 录制时未开启gpu通道。2. 使用的RHI渲染硬件接口不支持如某些移动平台。1. 确保在开始追踪前勾选了gpu。2. 在PC上确保使用DirectX 11/12或Vulkan。自定义C事件未显示1. 代码未编译。2. 未链接Trace模块。3. 事件名称冲突或被过滤。1. 确认代码已重新编译。2. 在项目的.Build.cs文件中添加Trace到PublicDependencyModuleNames。3. 在Insights搜索框中检查事件名。无法看到函数调用栈录制时未捕获符号信息。在编辑器Trace设置中启用高级选项下的“Callstack Capturing”捕获调用栈注意这会显著增加性能开销和文件大小。7.2 高级分析技巧使用“统计Statistics”视图在Timing视图中你可以框选一个时间段然后右键选择“统计”Insights会生成该时间段内所有事件的耗时统计表按总耗时排序能快速找出最耗时的顶级事件。关注“等待Wait”事件线程轨道上灰色的“Waiting”事件通常意味着线程在等待锁、同步点或空闲。过多的等待可能是并行化不合理或资源竞争的表现。关联多视图分析例如在Timing视图发现一个LoadPackage事件导致卡顿立刻切换到Asset Loading视图找到对应的资产加载事件查看其依赖链判断是否是同步加载或依赖了未预加载的资产。建立性能基线在项目性能良好的时候录制一段“标准场景”的追踪文件如空场景、角色站立。以后当性能下降时用同样的场景录制并对比可以快速发现新增的性能开销来自何处。命令行自动化对于需要批量测试的场景可以编写批处理脚本用命令行启动游戏并自动开始/停止追踪然后将.utrace文件归档便于持续集成CI环境进行自动化性能回归测试。性能优化是一个迭代和求证的过程。UE4 Insights提供了无与伦比的深度和广度将引擎的黑盒运行过程变成了可视化的数据流。掌握从启动、录制、分析到最终定位问题的全流程你就拥有了解决绝大多数UE4性能难题的钥匙。记住关键不是记住所有按钮的功能而是形成一套“观察现象 - 假设瓶颈 - 录制数据 - 验证假设 - 实施优化 - 验证效果”的科学工作流。
)
