Timing Insights

在 Timing Insights 窗口中，你可以看到包括 CPU 轨道和 GPU 轨道在内的不同轨道的每帧性能数据。 时序（Timing）视图 有新 工具栏 ，将轨道（Tracks）下拉菜单拆分为多个菜单，你可以在其中查看项目在各种任务上所花费时间的直观呈现。

Timing Insights窗口包含帧（Frames）面板（1）、时序（Timing）面板（2)、日志（Log）面板（3）、定时器（Timers）和计数器（Counters）选项卡（4），以及调用者（Callers）和被调用者（Callees）面板（5）。

Timing Insights主工具栏

工具栏 提供了选择时间块来聚合查看数据、排列数据或将数据分类，以及查看日志输出的功能。

点击每个相应轨道，你可以切换可视性，显示该帧 时序（Timing） 、 定时器（Timers） 、 调用者（Callers） 、 被调用者（Callees） 、 计数器（Counters） 和 日志（Log） 轨道的数据。

你可以选择时间块来聚合查看数据、显示或隐藏相应面板、排列数据或将数据分类，以及查看日志输出。为此，请在 帧（Frames）面板 中点击单个帧，或点击并拖动时序面板顶部推移条的分段，称为 时间标尺（Time Ruler） 。

帧

帧（Frames） 面板使用条形图格式显示每帧所用的总时间。这对于识别一般趋势很有用，例如加载关卡、未优化场景可见，或同时生成大量Actor时性能低下或帧率下降。

帧面板会显示帧、时序、定时器、调用者、被调用者、计数器和日志轨道。

将光标悬停在条形上可显示该帧的索引和运行时间。

如果右键点击条形，以下 缩放（Zoom） 上下文菜单选项将显示：

这些选项在 UnrealInsightsSettings.ini 文件中也可供编辑。

时序

你可以点击每个轨道旁边的箭头来显示或隐藏轨道。

所有轨道

点击 所有轨道（All Tracks） 下拉箭头将显示所有可用轨道的列表。

CPU/GPU

点击 CPU/GPU 下拉箭头将显示 CPU和GPU轨道和线程组选项。

其他

点击 其他（Other） 下拉箭头将显示 主图表（Main Graph） 、 文件活动（File Activity） 、 资产加载（Asset Loading） 和 帧轨道（Frames Tracks） 可视性的选项。

插件

点击 插件（Plugins） 下拉箭头将显示插件公开的轨道和选项，包括有关 Slate 、 Gameplay 、 动画（Animation） 和 RDG轨道（RDG Tracks） 的信息。

视图模式

视图模式（View Mode） 下拉箭头将显示时序视图的各种选项的功能按钮。

快速查找控件

快速查找（Quick Find） 控件用于搜索和筛选 时序视图（Timing View） 中显示的事件。控件可以通过右键点击 时序事件（Timing event） 从时序（Timing）视图上下文菜单中打开，也可以在时序视图具有焦点时使用 CTRL + F 快捷键打开。

快速查找（Quick Find）控件搜索逻辑使用 组 和 筛选器 定义。组节点包含子筛选器节点，并定义应用于子项结果的逻辑。筛选器节点是叶节点，每个节点都包含筛选器。

每个筛选器包含：

• 筛选器类型，可以从下拉菜单中选择。

• 筛选器运算符，也可以使用下拉菜单选择。

• 筛选器值，可以使用文本框输入。

创建筛选器逻辑后，它可以用于从时序视图搜索事件或筛选轨道。

如果你更改筛选器的逻辑，就必须再次点击 应用筛选器（Apply Filter） 才能根据新逻辑突出显示事件。

如何使用元数据筛选器

添加元数据筛选器后，它会提供多个字段。你可以在其中填写想要筛选的元数据。具体字段如下所示：

作为示例，你可以使用键"AssetPath"，类型"String"以及包含字符串"Pawn"的值创建一个元数据筛选器。

下方的第二个示例展示了奖元数据筛选器与其他类型筛选器结合使用的情况。它搜索所有名称为"FRDGBufferPool_CreateBuffer"，并有一个元数据字段的键为"SizeInBytes"、类型为整型（Int），且值大于6500的定时器命名事件。

你可以使用特殊字符串 * 显示所有拥有附加元数据的事件，忽略键、类型或值。

定时器

定时器（Timers） 面板列出了在时序（Timing）面板中指定时间范围内运行的所有定时器事件。除了基于时间范围的分组数据外，列表还可以按激活列中的值升序或降序排列。

要更改排列顺序，或者激活或停用列，请右键点击列。以下选项可用：

资产加载时间

从命令行启动Timing Insights时，资产加载时间通道可用于为 UObject::Serialize 启用指定的CPU定时器并切换追踪蓝图名称。

过去，追踪蓝图名称默认启用，这为追踪运行时事件带来了大量成本。现在，如果你想启用蓝图名称追踪，必须在命令行中开启此参数。

要从命令行启用资产加载时间追踪，你可以使用参数

	`-trace=default,AssetLoadTime`

Copy full snippet

`-trace=default,AssetLoadTime`

由于在开启蓝图名称时会添加许多定时器，所以蓝图名称在Trace Insights中默认隐藏。

启用蓝图名称

启用资产加载时间追踪后，你可以添加以下参数来显示蓝图名称：

	`-statnamedevents` 。
Copy full snippet

`-statnamedevents` 。

在不打开UI的情况下执行命令

Timing Insights可以在不打开UI的情况下直接从命令行运行。你可以直接在命令行中指定单个命令，也可以使用响应文件执行一系列命令。 在每种情况下，都会将一组数据导出到 .csv 或 .tsv 文件。

这些命令很适合用于运行自动测试。

导出功能

定时器（Timers）面板具有通过选择一个或多个定时器并右键点击上下文菜单来导出时序事件数据的功能。

定时器选项（Timer Options） 包括：

其他 杂项（Miscellaneous） 导出选项包括以下内容：

CPU定时器的源文件

在"定时器（Timers）"面板中，源文件和行号在每个定时器的提示文本中可见。

调用者和被调用者

调用者（Callers） 和 被调用者（Callees） 面板将显示任务事件的层级列表。从时序（Timing）视图选择事件时，将鼠标悬停在个别任务的信息图表上，将显示以下信息：

• Id
• 名称（Name）
• 类型（Type）
• 源（Source）
• 实例数量（Num Instances） *包括有关 实例数量（Instance count） 以及总 非独占（Inclusive） 和 独占（Exclusive） 时间的详细信息。
• 平均非独占/独占时间（Average Inclusive / Exclusive Time）
  • 总非独占/独占时间除以实例数量得到的平均时长。
• 子实例数量（Child Instance Count）
  • 子定时器的时序事件总数（调用者或被调用者）。

计数器

计数器（Counters） 面板列出了在与定时器（Timers）面板相同的时间段内递增的所有统计数据。你可以通过更新排序顺序和整理列来重新排列该面板。

以下组可用：

窗口性能计数器

在满足以下先决条件时，计数器列表中会出现窗口性能计数器：

• 命令行中存在 -perfcounters。
• 启用了 counters 追踪通道。

这些计数器将显示前缀：PC /。

日志

日志（Log） 视图将显示从Trace会话调用宏 UE_LOG 生成的全部日志。你可以按 冗长度 和 类别 筛选日志，类似于编辑器中的 输出日志（Output Log） 窗口。

在时序（Timing）面板中选择时间段会高亮显示位于该时间范围内的所有日志条目。如果选择多个日志条目，时序（Timing）面板会高亮显示这些条目之间的时间范围。 该日志面板具有搜索框，可以筛选掉所有与你输入的文本不匹配的日志消息。除了筛选之外，点击任意行会将时序（Timing）面板平移到记录该行文本的时间。 选择一条或多条消息，右键点击上下文菜单并从下拉菜单中选择以下选项之一，你可以保存日志：