BlueRoseNote/03-UnrealEngine/性能优化/UnrealInsight以及其他性能监测工具.md
2023-06-29 11:55:02 +08:00

307 lines
23 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
title: UnrealInsight以及其他性能监测工具
date: 2022-08-10 22:18:31
excerpt:
tags: Profiler
rating: ⭐⭐⭐
---
# 前言
目前主要使用的是Unreal Insights。其他工具有
- Stat用于实时显示数据。
- GPU Profiler用于显示简单的GPU性能损耗情况。
- UnrealFrontend Profiler似乎已经被Unreal Insights代替。
## Unreal Insights
- 官方视频:[UnrealFestOnline2020用Unreal Insights收集、分析及可视化你的数据(官方字幕)](https://www.bilibili.com/video/BV1Ay4y1q7Kj?share_source=copy_web&vd_source=fe8142e8e12816535feaeabd6f6cdc8e)
- 官方文档:[UnrealInsights](https://docs.unrealengine.com/4.27/zh-CN/TestingAndOptimization/PerformanceAndProfiling/UnrealInsights/Reference/)
- [Networking Insights](https://docs.unrealengine.com/4.27/zh-CN/TestingAndOptimization/PerformanceAndProfiling/UnrealInsights/NetworkingInsights )
- [Animation Insights](https://docs.unrealengine.com/4.27/zh-CN/TestingAndOptimization/PerformanceAndProfiling/UnrealInsights/AnimationInsights )
- [Slate Insights](https://docs.unrealengine.com/4.27/zh-CN/TestingAndOptimization/PerformanceAndProfiling/UnrealInsights/SlateInsights)
- [Animation Insights](https://docs.unrealengine.com/4.27/zh-CN/TestingAndOptimization/PerformanceAndProfiling/UnrealInsights/AnimationInsights/)
- [Memory Insights](https://docs.unrealengine.com/5.0/zh-CN/memory-insights-in-unreal-engine/)
- 其他知乎文章参考:
- [UE4性能分析工具 Unreal Insights](https://zhuanlan.zhihu.com/p/511148107)
- [Unreal Insights分析卡顿和降帧](https://zhuanlan.zhihu.com/p/514263195)
- [UE UnrealInsights 使用与实现](https://zhuanlan.zhihu.com/p/458086085)
### 与Profiler 的对比
- Profiler 只能记录 CPU 侧的开销信息Unreal Insights 对 CPU, GPU 的信息都能捕获到
- Profiler 能够直接从 Editor 内部打开并检测 Editor 下的性能Unreal Insights 只能作为独立应用打开,且必须通过添加启动参数才能统计到 Editor 的性能数据
- Profiler 对 Game Thread 的瓶颈定位分析粒度更小,能精确定位到开销较大的某个函数
- Unreal Insights 作为应用程序的性能更优,能更大程度上减少在本地进行性能检测时造成的额外影响
- Unreal Insights 支持远程监测,彻底消除 Profiling 本身对性能检测结果的影响
- Unreal Insights 在信息可视化上明显优于 Profiler有更加具有辨识度的色彩、便捷的操作和良好的交互体验
### 用法
1. 启动UnrealInsights其路径为`Engine\Binaries\Win64\UnrealInsights.exe`
2. 在工程或者游戏中启用trace命令。
3. 此时UnrealInsights会显示连接上的Session双击这个Session即可查看相关信息。
>PS.在Windows上开发打开了UE客户端会自动去连接Unreal Insights。trace的方法默认情况下会生成.utrace文件可以设置-tracefile=PATH设置生成的路径和文件名也可以使用.
#### 客户端
非Shipping版本的独立客户端命令行启动进行数据追踪。命令行需要附带运行工程以及 `-trace=cpu,gpu,frame,log`命令。例如 `D:\UnrealEngine\UE_4.27\Engine\Binaries\Win64\UE4Editor.exe D:\Work\Lyra\Lyra.uproject -game -WINDOWED -ResX=1280 -ResY=720 -trace=cpu,gpu,frame,log`
编辑器启动的游戏等可以打开命令窗口输入:
```text
trace.start frame,cpu,gpu | trace.stop 开始停止数据追踪
```
生成的`.utrace`文件会出现在项目的默认剖析目录中(...`/Saved/Profiling`)
#### 专用服务器
非shipping版本的ds,启动参数添加需要启动参数:
```text
-tracehost=127.0.0.1 -trace=cpu,frame,bookmark,log,loadtime,file,net,gpu,counters,animation -statnamedevents
```
会生成.utrace文件. 可以使用-tracefile=PATH 设置文件生成的目录。
#### 远程追踪
凭借Android Debug Bridge (adb)Android工具可通过USB线重定向TCP流量。要在Android设备上连接运行时应用程序首先指示[adb](https://link.zhihu.com/?target=https%3A//developer.android.com/studio/command-line/adb)经由设备上通过USB建立的TCP连接传递
```text
adb.exe reverse tcp:1980 tcp:1980
```
Unreal Insights聆听TCP端口1980。
在设备上运行时应连接到 localhost因此操作系统将通过USB线路由流量。
```text
-tracehost=127.0.0.1
```
1. 手机端开启开发者模式数据线连接PC保持adb连接状态运行adb reverse tcp:1980 tcp:1980
2. PC端启动Unreal Insights自动监听1980端口
3. 设置android手机包的启动参数通过UE4CommandLine.txt。UE4CommandLine.txt文件中添加
```text
-tracehost=127.0.0.1 -trace=cpu,frame,bookmark,log,loadtime,file,net,gpu,counters,animation -statnamedevents
```
运行`adb push <path_to>\UE4CommandLine.txt /mnt/sdcard/UE4Game/<project_name>/UE4CommandLine.txt` 将文件放入手机项目相关目录。
4. 启动app. PC端Unreal Insights上可以看到手机Trace Session的Status变为LIVE。双击连接即可实时看到数据。同时.utrace文件也会被传到PC端
### 参数
| 命令行选项 | 用途 | 说明 |
| ------------------ | ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `-statnamedevents` | `CPUPROFILERTRACE_ENABLED` | 开启指定的追踪事件,若结合 `-trace=cpu`此选项将激活更多CPU时间事件。 |
| `-trace` | `-trace=cpu,frame,bookmark,...` | 追踪指定的Channel |
| `-tracehost` | `tracehost=X` | `-tracehost` 的更多详情,请参阅[Unreal Insights介绍](https://docs.unrealengine.com/4.27/zh-CN/TestingAndOptimization/PerformanceAndProfiling/UnrealInsights/Overview) |
可用追踪的channel包括
- Log
- Bookmark
- Frame
- CPU
- GPU
- LoadTime
- File
- Net
## Stat
官方文档:[Stat命令](https://docs.unrealengine.com/4.27/zh-CN/TestingAndOptimization/PerformanceAndProfiling/StatCommands/)
参考文章:[UE4 性能 - (一)瓶颈定位](https://zhuanlan.zhihu.com/p/438543980)
用于在屏幕上试试显示各种参数,常用的命令主要有:
- Stat Fps
- **Stat Unit**
- **Frame**: 即一帧所耗费的总时间。
- **Game**: CPU Gameplay线程处理游戏逻辑所耗费的时间。
- **Draw**: CPU渲染线程准备好所有必要的渲染所需的信息并把它从 _CPU_ 发送给 _GPU_ 所耗费的时间 。
- **GPU**: GPU接收到渲染所需信息之后将像素最终的表现画在屏幕上的耗时
- **Stat UnitGraph**:显示实时图标。
- Stat UnitMax
- **stat game**Game逻辑消耗情况。
- **stat initviews**:渲染物体剔除损耗情况。
- **stat SceneRendering** Draw Call情况。
- stat streaming overview贴图流占用内存情况。
- **stat startfile/stat stopfile**:开始/停止记录性能情况快照,最后会生成*.ue4stats。该文件可以使用[UnrealFrontend Profiler]打开。
- **stat slow/stat stopslow**:开始/停止获取实时数据。比如stat slow 0.01 10这将会渲染在过去的10秒内所有运行时间超过10毫秒的循环统计数据。
Stat也可以通过点击ViewportOption的Stat进行开启
![](https://pic1.zhimg.com/80/v2-dc405089eeca41afc5aec8cbdccb801c_720w.jpg)
## GPU
主要的工具:
- GPUProfile
- 第三方GPU调试工具
- RenderDoc
- NSight GraphicN卡
- Radeon GPU ProfilerA卡
- PIX微软
- GPAInter
如果有条件还是使用RenderDoc来调试比较好。建议先关闭帧数限制**- r.VSync** 可以关闭垂直同步):
![](https://pic1.zhimg.com/80/v2-006167bc0f3ad29efa9d23730f5c37fc_720w.jpg)
### GPUProfile
按下**Ctrl+shift+,** 或 者控制台命令: **ProfileGPU**打开:
![](https://pic3.zhimg.com/80/v2-10da9a1d961d2871b9ba1211265583b6_720w.jpg)
可以看出影响**GPU**瓶颈最主要的是**BasePass**和**PrePass** 。
- **PrePass RenderPrePass
- **Base pass RenderBasePass / TBasePassDrawingPolicy。**
- 渲染不透明和遮盖的材质,向 **GBuffer** 输出材质属性。
- 光照图贡献和天空光照也会在此计算并加入场景颜色。
- **Lighting **
- 阴影图将对各个光照渲染,光照贡献会累加到场景颜色,并使用标准延迟和平铺延迟着色。光照也会在透明光照体积中累加。
- **Fog **
- 雾和大气在延迟通道中对不透明表面进行逐个像素计算。
- **Post Processing **
- 多种后期处理效果均通过 GBuffers 应用。透明度将合成到场景中。
- 其中 **BasePass 0** =不透明网格。**BasePass 1** =用于Z深度的Alpha蒙版不透明网格。**BasePass Dynamic** =动画顶点,如**SkeletalGeoCacheAlembic等**。
几个值得注意的数据项:
- **Base Pass**
- **Deferred Decals**
- **Lighting**
- **SSR环境反射**
- **Translucency(半透明)**
- **Postprocessing(后期处理效果)**
- **Particle粒子**
### 材质复杂度
材质复杂程度在这里可以查看,**越红的越消耗**,原则上减少使用点动画和曲面细分等一些效果。**红色:**意味着性能消耗非常高 绿色:意味着性能消耗最低半透明:意味着增加性能消耗
![](https://pic2.zhimg.com/80/v2-5b219263c69ecd93a60cae157d172e2d_720w.jpg)
## CPU
### Game Thread
Game Thread 造成的开销,基本可以归因于 C++ 和蓝图的逻辑处理瓶颈常见于Tick 和高复杂度逻辑。大量物体同时 Tick 会严重影响 Game Thread 的耗时。
针对Tick可使用
- **stat game**:显示 Tick 的耗时情况
- **dumpticks**:可将所有正在 _tick_ 的 _actor_ 打印到 _log_ 中
复杂逻辑:需要借助 Unreal Frontend Profiler / Unreal Insights 等工具对游戏逻辑中开销较大的代码进行定位。
### Draw Thread (Rendering Thread)
Draw Thread 的主要开销来源于 **Visibility Culling** 和 **Draw Call**
**Visibility Culling** 会基于深度缓存(Depth Buffer) 信息,剔除位于相机的视锥体(Frustum)之外的物体和被遮挡住(Occluded)的物体,当游戏世界中可见的物体过多,剔除所需的计算量也将变大,导致耗时过长
- **stat initviews**:显示 Visibility Culling 的耗时情况,同时还能显示当前场景中可见的 Static Mesh 的数量(Visible Static Mesh Elements)
![](https://pic2.zhimg.com/80/v2-8b0bc9e9fa36490aa2acb201d67d01e9_720w.jpg)
**Draw Call**为CPU向GPU提交渲染数据的过程。在UE中只要将多边形赋予相同的Materials引擎将会自动合并Batch这个过程叫做**合批**。合批工具一般会把相同ShaderModel的材质合并到一起来实现具体就是把多个材质所用到的贴图合并到一起在一个材质中使用。并且使用一个Index来控制当前材质。
- **stat SceneRendering** 可查看 Mesh Draw Call 的数量
- 相比于面数,**Draw Call** 对性能开销的影响要大得多
![](https://pic3.zhimg.com/80/v2-6241ca05121a00c2ef7ed1cab16fccb6_720w.jpg)
### GPU Thread
- 顶点瓶颈(**Vertex-bound**)
- Dynamic Shadow
- 目前动态阴影(Dynamic Shadow)的生成主要依赖 **Shadow Mapping**Shadow Mapping 每生成一次阴影需要进行两次光栅化,因此当顶点数过多(可能源于多边形数量巨大,也可能源于不适当的曲面细分) Dynamic Shadow 将成为 GPU 在光栅化阶段的一大性能瓶颈
- **ShowFlag.DynamicShadows 0**: 使用该指令可关闭场景内的动态阴影(0表示关闭1表示开启),可在开启和关闭两种状态间反复切换,查看卡顿情况是否发生明显变化,以此判断 Dynamic Shadow 是否确实造成了巨大开销
- 着色瓶颈(**Pixel-bound**)
- 运行指令 **r.ScreenPercentage 50**,表示将渲染的像素数量**减半**_(也可替换成其他 0-100 之间的数)_观察卡顿现象是否明显减缓以此判断瓶颈是否 _Pixel-bound_
- **Shader Complexity**
- 显示对每一个像素所执行的着色指令数量,数量越多,消耗越大
- 场景中存在过多的半透明物体(Translucent Object),会显著增加 Pixel Shader 的计算压力,使用 **stat SceneRendering** 可查看 Translucency 的消耗情况;使用 **ShowFlag.Translucency 0** 来关闭(0表示关闭1表示开启)所有半透明效果
- 当Shader的实现逻辑过于复杂或低效时也会导致较高的 Shader Complexity
- 在 Viewport 中选择 Optimization Viewmodes → Shader Complexity可视化 Shader 造成的开销
![](https://pic2.zhimg.com/80/v2-bb73d794eea836f17c17f4da1a4264f5_720w.jpg)
- **Quad Overdraw**
- 着色期间 _GPU_ 的大部分操作不是基于单个像素,而是一块一块地绘制,这个块就叫 _Quad_,是由 4 个像素 _(2 × 2)_ 组成的像素块
- 当模型存在较多**狭长、细小的三角形**时,有效面积较小,但可能占用了很多 _Quad__Quad_ 被多次重复绘制会导致大量像素参与到无意义的计算中引起不必要的性能开销
![](https://pic1.zhimg.com/80/v2-52678eed135de118cf10fc9adfa520f0_720w.jpg)
- 进入 _Optimization Viewmodes → Quad Overdraw_,显示 _GPU_ 对每个 _Quad_ 的绘制次数
![](https://pic3.zhimg.com/80/v2-68ac8b4d74ac9aacf2e632d36b94d2aa_720w.jpg)
- **Light Complexity**
- 场景内的动态光源(Dynamic Lights)数量过多时,会产生大量动态阴影(Dynamic Shadow)_如上述所说容易引起较大开销
- 动态光源的半径过大,导致多个光源的范围出现大量交叠,也可能导致严重的 _Overdraw_ 问题
- 进入 _Optimization Viewmodes → Light Complexity_,查看灯光引起的性能开销
![](https://pic2.zhimg.com/80/v2-fe971576642cfebbaf6f9288490e3d31_720w.jpg)
- 内存(**Memory-bound**)_引起的瓶颈
- 有时性能瓶颈还在于过高的内存占用,其中最常见的是大量的纹理(Texture)_加载和采样
- 使用 **stat streaming overview**,查看当前纹理对内存的占用情况
- 对于纹理的优化,后续将另开新篇加以详细介绍
![](https://pic1.zhimg.com/80/v2-81aea063a7fd1de8c2eef38b355268bc_720w.jpg)
## UnrealFrontend Profiler
官方文档:[Profiler Tool](https://docs.unrealengine.com/4.27/zh-CN/TestingAndOptimization/PerformanceAndProfiling/Profiler/)
其他参考文章:
- [UE4性能分析工具 UnrealFrontend Profiler](https://zhuanlan.zhihu.com/p/510862140)
- [UE4 性能 - (二) 性能分析工具: Unreal Frontend Profiler](https://zhuanlan.zhihu.com/p/441501920)
### 常见操作流程
- 运行游戏,切换到 **Profiler** 界面
- **Main Toolbar** 中点击 **Data Preview** 开始预览性能数据
- 关注 **Data Graph Full** 内是否出现明显尖峰,如果有并希望马上查看原因,则再次点击 **Data Preview** 停止预览
- 拖动 **Data Graph Full** 中的绿色滑窗至尖峰处,开始观察 **Data Graph** 界面,准确定位导致开销陡升发生在哪一帧或哪一小段
-**Data Graph** 中选择一段时长范围,此时 **Event Graph** 将显示这段时长内各方法的耗时情况,按降序排列
-**Event Graph****Main Event Graph** 区域展开条目层级,根据 **Function Details** 区域显示的信息,一级级深入定位到具体的方法上
### 游戏线程分析
查看游戏线程的性能表现的最佳工具是使用统计数据分析程序。
在控制台输入“**stat startfile**”来启动分析
等10秒左右输入“**stat stopfile**”收集这10秒的平均值当然也可以等更多的时间。
在路径**Saved/Profiling/UnrealStats**下,会有关于您项目文件夹的**ue4stats**文件。
也可以用“**stat slow**”来获取实时的报告,它可以通过报告运行一帧中特定时间段**(默认10毫秒**)来逐步定位帧停顿的位置。
运行速度较慢的数据将会在**HUD**上显示一段时间,从而判断性能波动。
“**Stat stopslow**”来关闭它。
参数以秒为单位(所以10ms也就是0.01秒)参数可设置持续的时间,默认值是**10**秒。
**例:**STAT SLOW 0.01 10这将会渲染在过去的10秒内所有运行时间超过10毫秒的循环统计数据。
![](https://pic2.zhimg.com/80/v2-872e2d3e8516a781ec277ec91e11c799_720w.jpg)
现在我们需要分析,需要打开编辑器中的**Session Frontend**(会话前端)
![](https://pic4.zhimg.com/80/v2-ba7882faa8f1ee2fdd1b2ba97c96e8c3_720w.jpg)
当您打开了会话前端选项卡后,您需要切换到**Profiler**(分析程序)的小选项卡。在该处,您可以选择载入您最近捕获的**ue4stats**分析文件。
![](https://pic2.zhimg.com/80/v2-7165da72d514eb10e83554e7b356d151_720w.jpg)
加载后会这样显示
![](https://pic1.zhimg.com/80/v2-77d20994bff0fabe025f5e1474945c0c_720w.jpg)
1. 渲染线程vs游戏线程的简图
- 根据CPU逻辑与渲染的关系一眼你就会知道你是否是CPU受限的或者它是否是与游戏相关的且花费最多性能的逻辑。
2. 抓取期间的整个CPU加载的简图
- 在这里你可以沿着时间线单击任何部分来观察对应帧的CPU分析或者你可以单击、拖拽来选择帧的范围并且查看均值。根据你这里的选择函数时间3的层级列表中的分析数据会改变。
3. 调用的不同函数和所花时间的层级列表
- 花费时间最长的函数排在顶端。花费最多时间的函数以**红色**显示,其它用**黑色**显示。你可以通过单击左侧三角来展开对应层,你可以看到这个函数调用过程的分解以及执行花费的时间。
![](https://pic4.zhimg.com/80/v2-e688cba4e90b7b70161c919ddaa22f83_720w.jpg)
**注意这里的CPU停转是CPU闲置等待其它线程结束的时间**
4. 如果你在函数时间3的层级列表中选择了特定的函数你可以看到这里的显示变化这里显示了什么函数调用了这个函数以及该函数调用了哪些函数同时可以看到这些调用和被调用函数执行时间的比例。
5. 左侧面板展示了stats和stat组。顶层是stat组你可以展开它查看内部的独立stat。这些stat可以是整型、浮点型数字或者内存你可以控制哪些显示在stat过滤器面板6中。如果你鼠标停留在一个stat上会弹出该stat的分析信息8
6. 在这里你可以通过搜索想要的stat、改变分组和排序、隐藏/显示不同类型的stat浮点/整型/内存)以及启用/禁用层级视图控制stat面板的显示5
7. 这些控件用于显示函数时间的层级列表和所选函数的分解信息4
1. 类型
- 如果在图像视图中你只选择了一帧2你唯一的选择就是显示信息那帧但是如果你选择了一系列帧你可以选择是否显示平均时间或者花费的最长时间。![](https://pic3.zhimg.com/80/v2-66a06f2aaec1596950b54f93ea29d02e_720w.jpg)
2. 视图模式
- 这会改变函数时间分层的层级列表视图3或者改变单纯的函数列表里面包括这些函数的子程序包括的或排除的时间。![](https://pic1.zhimg.com/80/v2-e4ca55902be0204198bf980dbe237834_720w.jpg)
3. 向前、向后按钮可以让你在图像视图的不同部分之间跳转2
- 所有你可以看到一系列信息,之后缩小你的选择范围直到一个帧,然后用这些按钮来在两者之间切换。下拉箭头显示了之前的选择。![](https://pic2.zhimg.com/80/v2-583cf009975346836747b575207d2359_720w.jpg)
4. 这里的火焰按钮是用来展开你当前选择函数的时间层级列表的3
- 用来查找花费最多时间的路径,它也会用一个小火焰图标来标识该路径。![](https://pic2.zhimg.com/80/v2-b5b3b22056ce585027d765bb92917eb9_720w.jpg)
8. 鼠标在stat面板5的一个stat上面停留时会显示关于该stat的分析信息最重要的是最小值、平均值和最大值
>这里我们只关注几个选项,展开**GameThread(游戏线程)**项目,然后往下拉,直到您看到超过几毫秒的“**Inc Time**”(包含时间)条目,而且其不包含许多子项或不包含任何子项。
同时关注一下“**Calls**”(调用)数列,它显示了每帧调用的统计数据的平均次数。
不要被“**CPU Stall**”CPU停滞时间项目弄糊涂了。
它们显示的是线程等待处理其他内容时所花费的时间,所以不是主要数据,而且仅仅会在帧频率受限或者游戏进程不为瓶颈时才会显示出来。
- 还有一个重要项目**TickFunctionTask**。
>此项目下是正在更新的每个**actor**和组件。
一般来说,降低每帧更新的**actor**和组件的数量都可以很好地加速游戏。![](https://pic1.zhimg.com/80/v2-ce9b4fd6295383f025e1c36c7a2bacbc_720w.jpg)
- 另一个要关注的是**BlueprintTime蓝图时间**
>找到这个值的最佳方法是切换到包含(合并)视图并在列表中找到它。
这样就可以把所有的**BlueprintTime蓝图时间**)条目组合到单一行中。
如果您选择**BlueprintTime蓝图时间**,然后切换回层次视图,则其会选择所有蓝图代码被执行的位置,这样能让您很好地了解花费时间进行处理的位置及其位于哪个蓝图中。![](https://pic3.zhimg.com/80/v2-07748f2c0dcf2076c0eb1899977c70ee_720w.jpg)
- 另一个常见的问题位置是**TickWidgets更新控件**
>如果这个统计数据值很高,这表示您可能同时显示了太多控件,或者这些控件上的属性代理过于复杂。
一些**slate**属性,比如可见性,可能会在每帧被调用好几次,这样它们的值必须要小而且能及时返回。
**您是不是在游戏中有很多骨架网格物体?**
>**SkinnedMeshComp更新时间**有时也会消耗很多系统资源
请尝试降低显示在分析文件中的骨架中的骨骼数量,或者降低动画蓝图的复杂度。
如果您不需要在无法看到骨架网格物体时更新动画,请考虑将骨架网格物体组件上的**MeshComponentUpdateFlag网格物体组件更新标识**正确设置为**OnlyTickPoseWhenRendered仅在渲染时更新姿势**。
请注意,将此标识设置为**AnimNotifies动画通知**将使得这些网格物体不被渲染时不再对其进行触发。
## 打包项目调试
可以参考[[打包项目的Debug方法]] 。
## 资产优化工具
- MergeActors合批工具。
- DeviceProfile针对不同设备使用不同的渲染参数。
- **LOD**
- ModelLOD
- MaterialLOD
- ParticleLOD
- 粒子裁剪工具:将粒子透明部分裁剪掉,减少重叠区域。