文档

Unity 引擎

Unity 引擎

性能分析器 Markers 参考

内置性能分析性能分析器Markers的参考。
阅读时间23 分钟最后更新于 10 天前

Unity 的代码带有性能分析器 Markers,可让您深入了解应用程序中占用的时间。下表包含一些内置 Markers 的列表。

主要线程底部 Markers

主要线程底部Markers可以清除区分在应用程序程序ON花费的时间与ON Unity Editor 和性能分析器活动上花费的时间。还可以将这些 Markers 与
ProfilerRecorder
API 结合使用来获取主要线程上的帧的时间,或者在运行时获取高级别帧Stats的
FrameTimingManager
API。
还可以使用渲染性能分析器计数器 CPU 主要线程帧时间、CPU 渲染线程帧时间和 CPU 总计帧时间来获取应用程序的 CPU 使用率的高关卡时间。有关更多信息,请参阅渲染性能分析器计数器参考。

标记

描述

PlayerLoop包含源应用程序用程主要Loop的Any样本。如果在 Active 播放模式下播放器在 Editor 中运行时以 Editor 而不是播放模式为目标,则 PlayerLoop 样本嵌套在 EditorLoop 下。
EditorLoop
(仅限 Editor 标记)
包含源自 Editor 主要Loop的Any样本。仅当您在 Editor 中配置文件 Player 时,才显示此属性。当您使用性能分析器Target播放模式时,EditorLoop 样本指示渲染和运行包含播放器的 Editor 所花费的时间量。

有关更多信息,请参阅播放模式和编辑模式样本。
Profiler.CollectEditorStats
(仅限 Editor 标记)
包含与收集不同Active Profiler模块的统计信息有关的Any样本。

嵌套在
Profiler.CollectGlobalStats
标记下的样本指示 Player 在收集特定模块的统计信息时的开销。All Other 子样本仅在 Editor 中反映其特效。

要移除特定模块的开销,请关闭模块的图表或调用
Profiler.SetAreaEnabled
。

**注意:**使用内置计数器的自定义性能分析器模块启用内置计数器的区域,即使其所属的模块已禁用。要防止性能性能分析器收集这些统计信息并产生Collection开销,请makeDisabled内置性能性能分析器模块和自定义义性能性能分析器模块。

Script更新Markers

除非您使用的是任务系统,否则大多数脚本代码都嵌套在以下 Markers 下面。有关 ON 任务系统样本的信息,请参阅本 Page 的 Multi threading Markers 部分。
有关 ON Unity Update Loop 的更多细节,请参阅 ON Order of execution of event function 的文档。您可以使用
PlayerLoop.SetPlayerLoop
将您自己的回调插入 Player Loop。如果直接将回调插入主要Loop中,则脚本更新样本ON自行显示。如果将回调作为子系统插入,样本将显示在相应的主要 PlayerLoopSystem 标记下。

标记

描述

BehaviourUpdate包含
MonoBehaviour.Update
方法的所有样本。
CoroutinesDelayedCalls包含第一个产量之后的协程的所有样本。
FixedBehaviourUpdate包含
Monobehaviour.FixedUpdate
方法的所有样本。
PreLateUpdate.ScriptRunBehaviourLateUpdate包含
Monobehaviour.LateUpdate
方法的所有样本。
Update.ScriptRunBehaviourUpdate包含
MonoBehaviour.Update
和协程的所有样本。

渲染和 VSync Markers

这些 Markers 包含 CPU 花费时间为 GPU 处理数据或可能等待 GPU 完成的样本。如果 GPU 性能分析器模块不可用,或增加太多开销,则性能分析器模块细节面板中的工具栏不会显示此信息。这些 Markers 下的样本可以让您很好地了解应用程序是 CPU 密集型还是 GPU 密集型。

标记

描述

WaitForTargetFPS指示应用程序花费多少时间等待
Application.targetFrameRate
指定的目标 FPS。

如果样本是 Gfx.WaitForPresentOnGfxThread 的子样本,则代表应用程序等待 GPU 所花费的时间量。例如,这可能是 GPU 等待 Next VSync 所花费的时间(如果在 QualitySettings.vSyncCount 中配置了该时间,或者您的 Target 平台实施了 VSync)。但是,如果 GPU 尚未完成帧计算,也会发出具有此标记的样本。

要确定导致具有此标记的样本使用大量时间的原因,请在 CPU 性能分析器模块中切换到 Time轴 View。在此View中,可以检查渲染线程ON发生的情况,以及在当前帧中结束的样本本与在周围帧中结束的相同样本之间经过的时间。

如果Duration时间大于应用程序程序的帧时间(基ON目标帧率或 VSync),帧的渲染或计算时间太长。如果是这种情况,请调查渲染线程,了解该线程在 ON Gfx.PresentFrame 上花费了多少时间,而不是在为 GPU 准备和发出命令的 Other 工作上花费了多少时间。如果渲染线程在 Gfx.PresentFrame 中花费了大量时间,则渲染工作受 GPU 限制。如果渲染线程的时间用于准备命令,应用程序用程序受 CPU 限制。

要了查找Focus On的内容(如果应用程序用程序受 GPU 限制),请使用 Unity Profiler 或平台性能性能分析器器对 GPU 工作进行性能配置文件。有关更多信息,请参阅 ON 如何优化图形性能的用户手册文档。

**注意:**Editor 不会ON GPU VSync,而是使用 WaitForTargetFPS 模拟 VSync 的延时。某些平台(特别是 Android 和 iOS)会强制执行 VSync 帧率为 30 或 60。
Gfx.PresentFrame表示应用程序等待 GPU 渲染和呈现帧(包括等待 VSync)所花费的时间。

ON 主要线程带有 WaitForTargetFPS 标记的样本显示等待 VSync 所花费的时间。
Gfx.ProcessCommands包含渲染线程ON渲染命令的All处理。应用程序程序可能花费了其中一些处理时间来等待 VSync 主要线程的新建命令,可以从其子样本 Gfx.WaitForPresentOnGfxThread 中看到这些命令。
Gfx.WaitForCommands指示渲染线程已准备好接受新建命令。如果看到此标记,则可能表示 ON 主要线程存在瓶颈。
例如:
GfxDeviceD3D11.WaitForLastPresent
GfxDeviceD3D12.WaitForLastPresent
GfxDeviceMetal.WaitForLastPresent
当主要线程等待 GPU 将帧数量翻转到屏幕(
Time.frameCount - QualitySettings.maxQueuedFrames + 1
)时,会出现具有此标记的样本。这意味着,如果 QualitySettings.maxQueuedFrames Is Greater Than 1,则会花费此时间等待 GPU 翻转应用程序在先前主要线程帧中请求渲染的帧。

有关 ON 样本的更多详细信息以及 Unity 帧管道的 Overview,请参阅 Unity ON 修复增量时间的博客 POST。
Gfx.WaitForPresentOnGfxThread指示主要线程已准备好Start渲染Next一帧,但渲染线程未完成等待 GPU 帧。这可能表示应用程序用程序受 GPU 限制。要检查渲染线程同时在 ON 上花费的时间,请检查 CPU 性能分析器模块的 Time轴 View。

如果渲染线程在 渲染用程序受 CPU 限制,可能花费太多时间将绘制Calls或Textures发送到 GPU。

如果渲染线程在
Gfx.PresentFrame
中花费时间,则表示应用程序是 GPU 密集型的,或者可能正在等待 GPU 上的 VSync。
Gfx.WaitForPresentOnGfxThread
的
WaitForTargetFPS
子样本表示当前阶段中应用程序等待 VSync 所花费的部分。当前阶段是 Unity 指示图形 API 交换缓冲区与此操作完成之间的一段时间。
Gfx.WaitForRenderThread指示主要线程正在等待渲染线程处理其命令流中的All命令。具有此标记的样本仅出现在多线程渲染中。

结束脚本Markers

这些样本突出显示 Mono 或 IL2CPP Scripting Backend活动,可用于故障排除垃圾Collection和分配问题。

标记

描述

GC.Alloc表示Managed中的分配,其中包含受Automatic垃圾Collection影响的Managed分配。为了减少应用程序程序ONAutomatic垃圾收Collection花费的时间,应尽量减少这些类型的样本。
GC.Colleect表示与垃圾Collection相关的样本。每当 Unity 需要执行垃圾Collection时,都会停止running程序代码,仅在垃圾回收器完成All工作When恢复法线执行。**注意:**如果已启用 Incremental Garbage Collection,则垃圾回收器可能无法在单一帧中完成工作。

此中断可能会导致应用程序执行延迟,持续时间从不到一毫秒到数百毫秒不等。这取决于垃圾回收器需要处理的内存量以及应用程序运行的平台。有关更多信息,请参阅 ON Understanding Automatic 内存管理的文档。
Mono.JIT
仅限 Mono
包含与脚本方法的时间编译相关的样本。时间执行函数When,Mono 会对其进行编译,而 Mono 表示此编译开销。
UnsafeUtility.Malloc包含调用 UnsafeUtility.Malloc 来分配非托管内存的样本。虽然垃圾回收器不会轨道此内存,但分配内存可能会性能产生重大影响,如此样本所示。要调查此调用的音频源,可在性能分析器窗口中为此标记启用 Call Stack 录制。

多线Markers记

这些Markers包含的样本不会测量消耗的 CPU 周期,而是突出显示与线程同步和任务System相关的信息。当您看到这些样本时,请使用 CPU 性能分析器模块的 Time轴 View 来检查其他线程同时发生的情况。

标记

描述

空闲包含指示工作线程处于 Inactive 状态的时间长度的样本。工作线程在任务 System 不使用它的任何时间都处于 Inactive 状态,并进入等待模式,在此模式下等待信号量 ON。

空闲样本之间的小间隙通常在任务System唤醒它们When发生,例如,为了调度新建作业。较长的间隙可能表示尚未检测的原生任务正ON线程上running。
JobHandle.Complete包含指示任务ONS点c点发生When的样本。Sync 点可能会影响 ON 应用程序的性能,并可能会干扰多线程任务代码的执行。为了更容易查找同步点的确切发生位置,请为此样本启用 Call Stack 录制。在 CPU 性能分析器模块的时间轴 View 中,可以启用 Flow 事件来标识此时已完成的作业。
Semaphore.WaitForSignal包含描述 ON 线程同步点的样本。要查找它正在等待的线程,请检查 时间轴 View图,查找在此线程之前不久结束的样本。
WaitForJobGroupID触发了 JobHandle ON的Sync围栏。这可能导致工作被盗,当一个工人完成工作,然后查看其他工人的工作以完成时,就会发生这种情况。这些显示为在此标记下执行的任务样本。被盗的作业不一定是正在等待的作业。

PhysicsMarkers

下表概述了一些高级关卡 Physics Profiler Markers。
FixedUpdate
Calls All these measurements.

标记

描述

Physics.FetchResults包含从Physics引擎收集Physics模拟结果的样本,例如接触流、触发器器重叠和关节破坏事件。
Physics.Interpolation包含测量
Physics.Interpolation
方法执行时间的样本。此方法管理应用程序程序中AllPhysics对象的位置和旋转的插值。
Physics.Processing包含OAllllccompletedPhysicsetedPhysics主要线程上花费时间的样本。如果应用程序在
Physics.Processing
中花费大量时间,但在 Scene 中只有少数与 Physics 相关的游戏对象,则可能表明工作线程由于任务窃取而拾取了 Other 系统任务并报告为 Physics。这是因为在等待期间,主要线程从高 Priority 队列中获取作业。
Physics.ProcessingCloth包含测量
Physics.ProcessingCloth
方法执行时间的样本。此方法处理AllClothPhysics作业。Expand此样本可显示Physics system内部Done的工作的关卡细节。
Physics.ProcessReports包含的样本对应于通过回调(例如
OnTriggerEnter
)将 Physics 数据转发到脚本所花费的时间。**注意:**这些样本不会计算所需的数据,因为它们已经在
FetchResults
期间准备就绪。

有四个不同的阶段:
  • Physics.Contacts:包含测量
    Physics.Contacts
    执行时间的样本。这将处理
    OnCollisionEnter
    、
    OnCollisionExit
    和
    OnCollisionStay
    事件。
  • Physics.JointBreaks:包含测量
    Physics.JointBreaks
    执行时间的样本。这将处理与中断关节相关的更新和消息。
  • Physics.TriggerEnterExits:包含测量
    Physics.TriggerEnterExits
    执行时间的样本。这将处理
    OnTriggerEnter
    和
    OnTriggerExit
    事件。
  • Physics.TriggerStays:包含测量
    Physics.TriggerStays
    执行时间的样本。这将处理
    OnTriggerStay
    事件。
Physics.Simulate包含的样本用于测量 ON
Physics.Simulate
方法先决条件所花费的时间量。此方法指示 Physics system 运行其模拟,从而更新当前 Physics 的状态。
Physics.UpdateBodies包含更新AllPhysics体的位置和旋转的样本。对于具有 Rigidbody 组件的每个游戏对象,具有此标记的样本从 Physics system 读取动作并将其写入变换。
Physics.UpdateCloth包含测量
Physics.UpdateCloth
方法执行时间的样本。此方法处理与 Cloth 及其蒙皮网格相关的更新。
有关脚本生命周期和脚本 Lifecycle 中的 General 样本的更多信息,请参阅 Order of execution for event function。

动画 Markers

下表包含动画系统中的 Markers。有关 ON 动画系统性能的一般信息,请参阅 Mecanim 性能和优化 Page。

PreLateUpdate.DirectorUpdateAnimationBegin 阶段

在此阶段,将处理每个Active并已启用的 动画器。无论剔除模式和可可见性如何,都会处理Active动画器。
以
Director.
开头的 Markers 还可以涵盖可播放项和时间轴。

标记

描述

Director.PrepareFrame设置、调度和等待
Director.PrepareFrameJob
作业。这些作业评估AllActive的 动画器 组件的状态机。
Director.PrepareFrameJob_(任务)_计算单一 Active 动画器的状态机。处理动画器所用的时间量随着状态机的复杂性(即状态、过渡、Properties 和图层的数量)而增加。

对具有实现
OnStateMachineEnter
或
OnStateMachineExit
监听器的
StateMachineBehaviours
的状态机的评估将限于主要线程。
Animators.PrepareFirstPass为 Next 处理步骤做好准备。
Animators.ProcessGraphJob生成、调度并等待
Animator.ProcessGraph
作业的结果。
Animators.ProcessGraph (job)评估All连接的 AnimationClip 中的AllProperties。

通过将AllClips的根运Propertiesroperties性混合在全体学员来计算根运动位移。

收集当前
deltaTime
的新建动画事件。

When评估 AnimationClips 的Properties时,曲线线段会缓存在帧之间的本地,以避免从 AnimationClips 内内存中读取超过必要的内容。
Animators.FireAnimationEventsAndBehavioursFire
StateMachineBehaviours
和 MonoBehaviours 的所有动画事件消息,已在
Director.PrepareFrameJob
中触发的
OnStateMachineEnter
或
OnStateMachineExit
监听器除外。
Animators.ApplyOnAnimatorMoveApply 根运动并触发器 ON MonoBehaviours 的
OnAnimatorMove
message。

PreLateUpdate.DirectorUpdateAnimationEnd

在此阶段,仅处理具有剔除模式
Always Update
的动画器和具有剔除模式
UpdateTransform
或
Cull Completely
的可见动画器。
Cull Completely
被根运动移出帧的动画器不参与此阶段。由 StateMachineBehaviours 和 AnimationEvents 触发的用户代码Disabled的 Animator 也是如此

标记

函数

Animators.PrepareSecondPass设置 Next 处理步骤。这包括根据剔除模式和可见性状态 ON 过滤掉动画器。
Animators.SortWriteJob变换System一时间只允许单一个线程修改变换换层级视图。为了适应这一约束,
Animators.SortWriteJob
组按其 transform.root
Animators.WriteTransforms
作业。

为了获得最佳性能,请避免在同一变换层级视图中使用多个个动画器,以提高可以调度和并行作业的粒度。
Animators.ProcessAnimationsJob生成、调度并等待
Animators.ProcessAnimations
作业的结果。
动画器.ProcessAnimations(任务)混合单一 动画器 的当前Active AnimationClip ON的AllProperties,根运动除外。将它们Apply于内部化身表示。

此标记的长度随动画和混合复杂性而缩放。
OnAnimatorIK设置动画反向动力学。为每个已启用反向动力学通道的动画控制器图层调用一次此函数。
Animators.WriteJob生成、调度并等待
Animator.WriteTransform
作业的结果。这些作业将变换姿势从动画化身写入相关的游戏对象变换层级。
Animators.WriteTransforms (job)将All动画变换从工作线程写入Scene。
Animator.WriteProperties将Any不是变换动作的动画属性写入Target Object。

性能警告

CPU 性能分析器检测到一些常见的性能问题并发出相关警告。这些显示在模块细节面板中的 CPU 性能分析器模块层级视图的 Warning 柱状图中。
性能分析器 会检测在性能键型上下文中要避免的一些指定的Calls。它会显示警告以及操作影响性能的原因,如下所示:

警告

描述

Animation.DestroyAnimationClip
Animation.AddClip
Animation.RemoveClip
动画。克隆
动画。停用
指示已触发 RebuildInternalState。RebuildInternalState 是一种操作,它遍历动画组件每个 Clip In 的曲线列表,然后将每条曲线重新绑定到 ON 组件和 ON 游戏对象的值。

这是一项Resource密集型操作,因此应尽可能避免在运行时时调用这些方法。
AssetBundle.asset/allAssets指示 Unity 在 AssetBundle 加载未完成时调用 AssetBundleRequest. Assets/allAssets API(AssetBundleRequest.isDone 为 false)。这会导致主线程卡顿并等待加载中的操作完成。
AsyncUploadManager.AsyncBufferResize
AsyncUploadManager.AsyncBufferDelete
指示用于将数数据传到 GPU 的内部缓冲区区已调整大小,因为它不够大。此大小调整很慢,会导致 CPU Activity 出现峰值。

如果能够腾出内内存前面分配更大的大小,可以避免此Warning。

您可以使用 Quality Settings 中的 Async Upload 缓冲区大小设置来设置默认大小。

AsyncUploadManager.AsyncBufferResized
标记指示新分配的大小,您可以将其用作默认缓冲区大小的指南。
Rigidbody.SetKinematic为 Rigidbody 重新创建非凸面体 MeshCollider。

其他资源