Unreal Insights参考

涵盖输入快捷方式、宏和命令行选项的Unreal Insights参考。

Windows
MacOS
Linux

为充分利用 Unreal Insights 附带的众多功能,用户可以用宏和命令行选项自定义项目输出。同时用户可以使用鼠标和键盘输入快捷方式更高效地浏览Insights窗口。

根据要在Unreal Insights工具中查看的数据,参照下表确定想要调整的宏:

宏名称

默认状态

源文件

区域说明

UE_TRACE_ENABLED

开启

Engine/Source/Runtime/TraceLog/Public/Trace/Config.h

整个系统的主控

LOGTRACE_ENABLED

开启

Engine/Source/Runtime/Core/Public/Logging/LogTrace.h

控制是否向Unreal Insights报告日志消息

MISCTRACE_ENABLED

开启

Engine/Source/Runtime/Core/Public/ProfilingDebugging/MiscTrace.h

控制书签、帧、线程和线程组的追踪

CPUPROFILERTRACE_ENABLED

开启

Engine/Source/Runtime/Core/Public/ProfilingDebugging/CpuProfilerTrace.h

控制CPU定时器和时间事件的追踪

LOADTIMEPROFILERTRACE_ENABLED

开启

Engine/Source/Runtime/CoreUObject/Public/Serialization/LoadTimeTrace.h

控制加载资产相关事件的追踪

EXPERIMENTAL_STATSTRACE_ENABLEDSTATSTRACE_ENABLED

关闭

Engine/Source/Runtime/Core/Public/Stats/StatsTrace.h

控制统计信息计数器的追踪 - 将两个宏都定义为"1"来激活

PLATFORMFILETRACE_ENABLED

关闭

在Windows系统中默认开启。

Engine/Source/Runtime/Core/Public/ProfilingDebugging/PlatformFileTrace.h

控制文件活动(例如打开、关闭、读取和写入文件)的追踪

GPUPROFILERTRACE_ENABLED

开启

Engine/Source/Runtime/RHI/Public/GpuProfilerTrace.h

控制GPU定时器和时间事件

UE_NET_TRACE_ENABLED

开启

  • Engine\Source\Runtime\Net\Core\Public\Net\Core\Trace\NetTrace.h

    * `Engine\Source\Runtime\Net\Core\Public\Net\Core\Trace\Config.h`

控制网络数据包内容的追踪

命令行选项

以下命令行选项与宏相结合可启用追踪数据:

命令行选项

用途

说明

-statnamedevents

CPUPROFILERTRACE_ENABLED

若结合 -trace=cpu,此选项将激活更多CPU时间事件。

-trace

-trace=channel1,channel2,...

将事件分类到命名组中,管理生成的追踪数据数量

例如 -trace=cpu,frame,bookmark 启用CPU分析器事件、帧标记和书签。`

-tracehost

tracehost=X

欲了解关于 -tracehost 的更多详情,请参阅Unreal Insights概览

可用追踪通道包括:

  • Log

  • Bookmark

  • Frame

  • CPU

  • GPU

  • LoadTime

  • File

  • Net

已废弃命令行选项

以下命令行选项已废弃(仍可用,但未来某个UE版本会将其移除):

命令行选项

所需宏

作用

-cpuprofilertrace

CPUPROFILERTRACE_ENABLED

使用此选项运行时,将用包含时间事件的多个CPU线程轨迹填充时间视图。

-filetrace

PLATFORMFILETRACE_ENABLED

对于使用此选项生成的追踪,Unreal Insights工具的定时器选项卡中将有两个I/O活动轨迹,可按"I"键或在"轨迹(Tracks)"下拉菜单中启用"I/O轨迹(I/O Tracks)"以查看这两个轨迹。此功能在4.23版中属实验性功能。

-loadtimetrace

LOADTIMEPROFILERTRACE_ENABLED

此选项导致资产加载信息窗口包含"加载-主线程"轨迹和"加载-异步线程"轨迹。

UnrealInsights.exe的命令行选项

命令行选项

用法

描述

-OpenTraceId

-OpenTraceId=id

强制Unreal Insights开始在"查看器模式"下分析指定ID

-OpenTraceFile

-OpenTraceFile=file.utrace

强制Unreal Insights开始在"查看器模式"下分析指定文件

-Store

-Store=address:port

将浏览器连接到指定追踪存储区

同时提供 -StoreHost=address-StorePort=port

实验性统计数据和计数器

计数器标签页可以显示来自两个API源的计数器:

API源

示例

命令行参数

注释

统计数据

TRACE_STAT_* macros

-trace=frame,stats,...

4.24用户请使用 -statstrace

Engine\Source\Runtime\Core\Public\Stats\StatsTrace.h 中用 #define EXPERIMENTAL_STATSTRACE_ENABLED 1 启用。

计数器

TRACE_COUNTER_*

-trace=frame,counters,...

4.24用户请使用 -counterstrace.

Source\Runtime\Core\Public\ProfilingDebugging\CountersTrace.h

更多详情请参见统计数据系统概述

输入快捷方式

所有输入操作和控制引用均受限制,且可能更改。

Timing Insights窗口

以下鼠标和键盘命令有助于更高效地浏览Timing Insights:

帧面板

输入快捷方式

功能

鼠标左键点击

选择帧

时间视图在选定帧中居中。

鼠标右键点击

打开快捷菜单

**鼠标左/右拖动**v

水平缩放

鼠标滚轮

水平缩放

Shift + 鼠标滚轮

垂直缩放

时间面板输入快捷方式

输入快捷方式

功能

鼠标左/右拖动

水平或垂直平移

Ctrl + 鼠标左/右拖动

水平平移

Shift + 鼠标左/右拖动

垂直平移

鼠标滚轮

缩放

Ctrl + 鼠标滚轮

水平滚动

Shift + 鼠标滚轮

垂直滚动

鼠标右键点击

打开快捷菜单

图表追踪可用选项。

鼠标左键点击时间事件

选择时间事件

鼠标左键点击空白处

取消选择

Ctrl + 鼠标左键双击

选择选定时间事件的时间范围

按ENTER执行相同功能。

鼠标在时间标尺上左右拖动

选择时间范围

聚合状态在定时器和计数器视图中自动更新。

F

框住上个选择,然后选择框住时间范围或时间事件

上个选择可以是时间范围或时间事件。

G

切换图表轨迹可视性,显示游戏和渲染帧,包括计数器系列的placeholder。

Y

切换GPU时间轨迹可视性

U

切换CPU时间轨迹可视性

I

切换I/O概览和活动轨迹可视性

O

切换I/O活动轨迹中文件活动的背景事件可视性

L

切换资产加载轨迹可视性

C

在正常和紧凑模式之间切换,影响时间事件的显示方式

V

自动隐藏空白时间轴

空白时间轴不含时间事件。

B

切换书签可视性

默认显示书签。

M

切换时间标记可视性(所有追踪日志,而非只是书签)

默认不显示时间标记。

D

启用下采样

此调试功能默认启用。

缩放

Ctrl + 左/右/上/下箭头

水平和垂直平移

左/右/上/下箭头

选择时间事件的上一或下一同级项/父项/最大子项

Enter

选择选定时间事件的时间范围

按住 Ctrl + 鼠标左键双击执行相同功能。

Networking Insights窗口

以下鼠标和键盘命令有助于更高效地浏览Networking Insights:

输入快捷方式

功能

鼠标左键点击数据包

选择对应数据包

Shift + 鼠标左键点击不同数据包

选择一组数据包

Ctrl + A

选择所有数据包

左/右箭头

选择上个/下个数据包

Shift + 左/右箭头

向左/右侧扩展选择(多个数据包)

Ctrl + Shift + 左/右箭头

从左/右侧收缩选择(多个数据包)

双击事件

高亮显示数据包内容视图中所有包含该事件的数据包,并屏蔽所有其他事件

Select Skin
Light
Dark

欢迎来到全新虚幻引擎4文档站!

我们正在努力开发新功能,包括反馈系统,以便您能对我们的工作作出评价。但它目前还未正式上线。如果您对此页面有任何意见与在使用中遭遇任何问题,请前往文档反馈论坛告知我们。

新系统上线运行后,我们会及时通知您的。

发表反馈意见