ドキュメント

Unity Engine

User Manual

Script Reference

Unity Engine

プロファイラーマーカーのリファレンス

Reference for built-in Profiler markers.
読み終わるまでの所要時間 40 分最終更新 1ヶ月前
Unity のコードは プロファイラーマーカー を使用してインストルメント化されており、アプリケーションで何に時間がかかっているかを知ることができます。以下の表は、ビルトインマーカーの一部のリストです。

メインスレッドの基本マーカー

メインスレッドの基本マーカーは、アプリケーションに費やされた時間と、Unity エディターやプロファイラーのアクティビティに費やされた時間を明確に区別します。また、これらのマーカーを 
ProfilerRecorder
 API とともに使用してメインスレッドのフレームのタイミングを取得したり、 
FrameTimingManager
 API を使用してランタイムにフレームに関する高度な統計情報を取得したりすることもできます。
また、レンダリングプロファイラーの各カウンター、CPU Main Thread Frame Time、 CPU Render Thread Frame Time、CPU Total Frame Time を使用して、アプリケーションの CPU 使用量のタイミングに関する高度な情報を取得することもできます。詳細は、レンダリングプロファイラーカウンターのリファレンス を参照してください。

マーカー

説明

PlayerLoopアプリケーションのメインループから発生するすべてのサンプルが含まれます。プレイヤーがエディターでアクティブな再生モードで実行されているときに、再生モードではなく エディターをターゲットにする 場合、PlayerLoop のサンプルは EditorLoop の下にネストされます。
EditorLoop
(エディター専用マーカー)		エディターのメインループから発生するすべてのサンプルが含まれます。これは、エディターでプレイヤーをプロファイルする 間のみ表示されます。プロファイラーで再生モードをターゲットにする 場合、EditorLoop のサンプルは、プレイヤーを含むエディターのレンダリングと実行にどのくらいの時間が費やされたかを示します。

詳細は、再生モードと編集モードのサンプル を参照してください。
Profiler.CollectEditorStats
(エディター専用マーカー)		各種のアクティブな Profiler モジュールの統計収集に関連するサンプルが含まれます。

Profiler.CollectGlobalStats
マーカーの下にネストされたサンプルは、プレイヤーが特定のモジュールの統計を収集するときのオーバーヘッドの量を示します。他のすべての子サンプルは、エディターでの影響のみを反映します。

特定のモジュールのオーバーヘッドを削除するには、モジュールのチャートを閉じるか、
Profiler.SetAreaEnabled
を呼び出します。

注意ビルトインカウンターを使用する カスタム Profiler モジュール は、(ビルトインカウンターが属するモジュールが無効になっていても) ビルトインカウンターの領域を有効にします。プロファイラーがこれらの統計を収集して収集オーバーヘッドを発生させないようにするには、ビルトイン Profiler モジュールとカスタム Profiler モジュールの両方が無効になっていることを確認してください。

スクリプトの更新マーカー

ジョブシステム を使用しない限り、ほとんどのスクリプトコードは以下のマーカーの下にネストされます。ジョブシステムのサンプルについては、マルチスレッドマーカー のセクションを参照してください。
Unity の更新ループの詳細は、イベント関数の実行順序 に関するドキュメントを参照してください。
PlayerLoop.SetPlayerLoop
 を使用して、PlayerLoop に独自のコールバックを挿入できます。メインループに直接コールバックを挿入すると、スクリプトの更新サンプルが単独で表示されます。コールバックをサブシステムとして挿入すると、サンプルはそれぞれメインの PlayerLoopSystem マーカーの下に表示されます。

マーカー

説明

BehaviourUpdate
MonoBehaviour.Update
 メソッドのすべてのサンプルが含まれます。
CoroutinesDelayedCalls最初の yield の後の コルーチン のすべてのサンプルが含まれます。
FixedBehaviourUpdate
Monobehaviour.FixedUpdate
 メソッドのすべてのサンプルが含まれます。
PreLateUpdate.ScriptRunBehaviourLateUpdate
Monobehaviour.LateUpdate
 メソッドのすべてのサンプルが含まれます。
Update.ScriptRunBehaviourUpdate
MonoBehaviour.Update
 と コルーチン のすべてのサンプルが含まれます。

レンダリングマーカーと VSync マーカー

これらのマーカーには、CPU が GPU のデータ処理に時間を費やしている箇所、または、GPU の終了を待機しているかもしれない箇所のサンプルが含まれます。GPU Profiler モジュール が使用できない場合やオーバーヘッドが大きすぎる場合は、Profiler モジュールの詳細ペインのツールバーにこの情報は表示されません。これらのマーカーに含まれるサンプルは、アプリケーションが CPU 依存か GPU 依存かを判断するのに役立ちます。

マーカー

説明

WaitForTargetFPS
Application.targetFrameRate
 が指定するターゲット FPS の待機にアプリケーションが費やした時間を示します。

サンプルが Gfx.WaitForPresentOnGfxThread のサブサンプルである場合、アプリケーションが GPU の待機に費やした時間を表します。例えば、QualitySettings.vSyncCount で次の VSync が設定されている場合やターゲットプラットフォームで vSync が適用されている場合に、GPU が次の VSync の待機に要した時間などです。ただし、GPU がフレームの計算を完了していない場合でもこのマーカーを持つサンプルが出力されます。

このマーカーのサンプルが多くの時間を使用する原因を特定するには、CPU Profiler モジュールの Timeline ビュー に切り替えます。このビューでは、レンダースレッドで何が起きたか、現在のフレームで終了するこのサンプルと周囲のフレームで終了する同じサンプルとの間に経過した時間を確認できます。

継続時間がアプリケーションの目標とするフレーム時間 (ターゲットフレームレートまたは vSync に基づく) よりも長い場合、フレームの描画や計算に時間がかかり過ぎています。その場合は、レンダースレッドを調査し、GPU へのコマンドの準備と発行のために行った他の作業と比較して、Gfx.PresentFrame にどのくらい作業時間を費やしているかを確認します。レンダースレッドが Gfx.PresentFrame により多くの時間を費やしている場合、レンダリング作業は GPU 依存です。レンダースレッドがコマンドの準備により多くの時間を費やしている場合、アプリケーションは CPU 依存です。

アプリケーションが GPU 依存の場合に何に重点を置くべきかを判断するには、Unity プロファイラーまたはプラットフォームプロファイラーで GPU 作業をプロファイルします。詳細は、グラフィックスパフォーマンスの最適化 方法に関するユーザーマニュアルドキュメントを参照してください。

注意エディターは GPU で VSync を実行せず、代わりに WaitForTargetFPS を使用して VSync の遅延をシミュレートします。一部のプラットフォーム、特に Android と iOS では VSync が適用されているか、デフォルトのフレームレートの上限が 30 または 60 です。
Gfx.PresentFrameGPU によるフレームの描画と表示をアプリケーションが待機した時間を示します (VSync の待機も含む)。

メインスレッドの WaitForTargetFPS マーカーのサンプルは、VSync の待機に費やされた時間を示します。
Gfx.ProcessCommandsレンダースレッドのレンダリングコマンドのすべての処理が含まれます。この処理時間の一部は、メインスレッドからの VSync または新しいコマンドの待機に費やされた可能性があります。これは、その子サンプル Gfx.WaitForPresentOnGfxThread から確認できます。
Gfx.WaitForCommands新しいコマンドに対し、レンダースレッドの準備ができていることを示します。このマーカーは、メインスレッドのボトルネックを示す場合もあります。
<GraphicsAPIName>.WaitForLastPresent
例:
GfxDeviceD3D11.WaitForLastPresent
GfxDeviceD3D12.WaitForLastPresent
GfxDeviceMetal.WaitForLastPresent		このマーカーのサンプルは、GPU がそのフレーム番号を画面に表示するのをメインスレッドが待機した場合に表示されます (
Time.frameCount - QualitySettings.maxQueuedFrames + 1
)。つまり、QualitySettings.maxQueuedFrames が 1 より大きい場合、この時間は、アプリケーションがメインスレッドの前のフレームで描画するように要求したフレームを GPU が表示するのを待機するのに費やされる時間を示します。

このサンプルの詳細と Unity のフレームパイプラインの概要については、デルタタイムの修正に関する Unity のブログ記事 を参照してください。
Gfx.WaitForPresentOnGfxThreadメインスレッドが次のフレームを描画する準備ができたが、レンダースレッドが GPU によるフレームの表示の待機を完了しなかったことを示します。これは、アプリケーションが GPU 依存であることを示している可能性があります。レンダースレッドが何に同時に時間を費やしているかを確認するには、CPU Profiler モジュールの Timeline ビュー を確認します。

レンダースレッドが Camera.Render で時間を費やしている場合、アプリケーションは CPU 依存であり、GPU へのドローコールやテクスチャの送信に時間をかけすぎている可能性があります。

レンダースレッドが Gfx.PresentFrame で時間を費やしている場合、アプリケーションは GPU 依存であるか、GPU の VSync を待機している可能性があります。Gfx.WaitForPresentOnGfxThread の WaitForTargetFPS サブサンプルは、アプリケーションが VSync の待機に費やした Present フェーズの部分を表します。Present フェーズは、Unity がバッファのスワップをグラフィックス API に指示してから、その操作が完了するまでの時間の部分です。
Gfx.WaitForRenderThreadレンダースレッドがコマンドストリームにあるすべてのコマンドを処理するのをメインスレッドが待機していたことを示します。このマーカーのサンプルは、マルチスレッドレンダリングでのみ表示されます。

バックエンドスクリプティングマーカー

このサンプルは、Mono または IL2CPP のスクリプティングバックエンドアクティビティを強調しており、ガベージコレクションや割り当てに関する問題のトラブルシューティングに役立ちます。

マーカー

説明

GC.Alloc自動ガベージコレクションの対象となるマネージ割り当てを含むマネージヒープ内の割り当てを表します。アプリケーションが自動ガベージコレクションに費やす時間を短縮するには、これらのタイプのサンプルを最小化する必要があります。
GC.Collectガベージコレクションに関連するサンプルを示します。Unity がガベージコレクションを行う必要があるときは常に、プログラムコードの実行を停止し、ガベージコレクターがすべての作業を終了したときにのみ、通常の実行を再開します。注意インクリメンタルガベージコレクション を有効にした場合、ガベージコレクターは 1 フレームで作業を完了しない可能性があります。

この中断により、アプリケーションの実行に遅延が発生し、1 ミリ秒未満から数百ミリ秒に及ぶ場合があります。これは、ガベージコレクターの処理に必要なメモリの量や、アプリケーションが実行されるプラットフォームによって異なります。詳細は、自動メモリ管理 に関するドキュメントを参照してください。
Mono.JIT
Mono-only		スクリプトメソッドの実行時コンパイルに関連するサンプルが含まれます。関数が初めて実行されると、Mono はその関数をコンパイルします。Mono.JIT はこのコンパイルのオーバーヘッドを示します。
UnsafeUtility.MallocUnsafeUtility.Malloc を呼び出し、アンマネージメモリを割り当てるサンプルが含まれます。ガベージコレクターはこのメモリを追跡しませんが、メモリの割り当てはパフォーマンスに大きな影響を与える可能性があり、このサンプルでそれが示されています。この呼び出しのソースを調べるには、Profiler ウィンドウで、このマーカーの コールスタック の記録を有効にします。

マルチスレッドマーカー

これらのマーカーには、消費された CPU サイクルを測定するのではなく、スレッドの同期やジョブシステムに関連する情報を強調するサンプルが含まれます。これらのサンプルが表示された場合、CPU Profiler モジュールの Timeline ビュー を使って、他のスレッドで同時に発生していることを確認してください。

マーカー

説明

Idleワーカースレッドが非アクティブになっている時間の長さを示すサンプルが含まれます。ワーカースレッドは、ジョブシステムによって使用されないときは常に非アクティブです。待機モードになり、セマフォで待機します。

Idle サンプル間の小さなギャップは通常、例えば新しいジョブをスケジュールするために、ジョブシステムがそれらを起動するときに発生します。長いギャップは、インストルメント化されていないネイティブジョブがスレッド上で実行されていることを示している場合があります。
JobHandle.Completeジョブの同期ポイントが発生したときのサンプルが含まれます。同期ポイントが発生すると、アプリケーションのパフォーマンスに影響を与えたり、マルチスレッドのジョブコードの実行に支障をきたしたりする場合があります。同期ポイントが発生した場所を正確に探しやすくするには、このサンプルの コールスタック の記録を有効にします。CPU Profiler モジュールの Timeline ビューで Flow Events を有効にすると、現時点でどのジョブが終了したかを確認できます。
Semaphore.WaitForSignalスレッドの同期ポイントを示すサンプルが含まれます。待機しているスレッドを見つけるには、Timeline ビューでこのサンプルの直前に終了したサンプルを確認してください。
WaitForJobGroupIDJobHandle に Sync Fence がトリガーされました。作業を完了したワーカーが他のワーカーのジョブを確認して完了する 作業の横取り が発生する可能性があります。その場合は、このマーカーの下に実行されたジョブのサンプルとして表示されます。横取りされたジョブは必ずしも待機されていたジョブとは限りません。

物理マーカー

以下の表は、高レベルの物理演算プロファイラーマーカーの一部をまとめたものです。 
FixedUpdate
 は、これらの計測をすべて呼び出します。

マーカー

説明

Physics.FetchResults物理エンジンから物理シミュレーションの結果を収集するサンプルが含まれます。接触ストリーム、トリガーのオーバーラップ、ジョイントの破損イベントなど。
Physics.Interpolation
Physics.Interpolation
メソッドの実行時間を計測するサンプルが含まれます。このメソッドは、アプリケーションのすべての物理オブジェクトの位置と回転の補間を管理します。
Physics.Processingすべてのスレッドで物理シミュレーションが完了するまで、メインスレッドで待機して時間を費やしたサンプルが含まれます。アプリケーションが 
Physics.Processing
に多くの時間を費やしているにも関わらず、シーンに物理演算に関連するゲームオブジェクトが数個しかない場合、ワーカースレッドがジョブを横取りして他のシステムのタスクを拾い、物理演算として報告した可能性があります。これは、待機中にメインスレッドが優先度の高いキューからジョブを拾うためです。
Physics.ProcessingCloth
Physics.ProcessingCloth
メソッドの実行時間を計測するサンプルが含まれます。このメソッドは、すべてのクロスの物理ジョブを処理します。このサンプルを展開すると、 物理演算エンジンで内部的に行われた作業の低レベルの詳細が表示されます。
Physics.ProcessReports
OnTriggerEnter
 などのコールバックを介して物理演算データをスクリプトに転送するのに要した時間に対応するサンプルが含まれます。**注：**これらのサンプルは、
FetchResults
中にすでに準備されているため、必要なデータを計算しません。

4 つの異なるステージがあります。
Physics.Contacts
Physics.Contacts
の実行時間を計測するサンプルが含まれます。
OnCollisionEnter
、
OnCollisionExit
、
OnCollisionStay
 イベントを処理します。
Physics.JointBreaks
Physics.JointBreaks
の実行時間を計測するサンプルが含まれます。壊れたジョイントに関連する更新やメッセージを処理します。
Physics.TriggerEnterExits
Physics.TriggerEnterExits
の実行時間を計測するサンプルが含まれます。
OnTriggerEnter
、
OnTriggerExit
 イベントを処理します。
Physics.TriggerStays
Physics.TriggerStays
の実行時間を計測するサンプルが含まれます。
OnTriggerStay
 イベントを処理します。
Physics.Simulate
Physics.Simulate
 メソッドの必要条件の作業時間を計測するサンプルが含まれます。このメソッドは物理演算エンジンにシミュレーションの実行を指示し、現在の物理演算の状態を更新します。
Physics.UpdateBodiesすべての物理演算ボディの位置と回転を更新するサンプルが含まれます。このマーカーを持つサンプルは、Rigidbody コンポーネントを持つ各ゲームオブジェクトに対して、物理演算エンジンからポーズを読み取り Transform に書き込みます。
Physics.UpdateCloth
Physics.UpdateCloth
メソッドの実行時間を計測するサンプルが含まれます。このメソッドは、クロスとそのスキンメッシュに関連する更新を処理します。
スクリプトのライフサイクルと、スクリプトのライフサイクル内の一般的なサンプルについては、イベント関数の実行順序 のドキュメントを参照してください。

アニメーションマーカー

以下の表に、アニメーションシステム のマーカーを示します。アニメーションシステムのパフォーマンスに関する一般的な情報は、Mecanim のパフォーマンスと最適化 のページを参照してください。

PreLateUpdate.DirectorUpdateAnimationBegin ステージ

このステージでは、アクティブで有効なすべてのアニメーターが処理されます。アクティブなアニメーターは、Culling Mode や可視性に関係なく処理されます。
Director.
で開始するマーカーは、Playables と Timeline もカバーできます。

マーカー

説明

Director.PrepareFrame
Director.PrepareFrameJob
ジョブの設定、スケジュール設定、待機を行います。これらのジョブは、すべてのアクティブなアニメーターコンポーネントのステートマシンを評価します。
Director.PrepareFrameJob (job)1 つのアクティブなアニメーターのステートマシンを評価します。アニメーターの処理にかかる時間は、ステートマシンの複雑さ (ステート、遷移、プロパティ、レイヤーの数など) に応じて増加します。

OnStateMachineEnter
、
OnStateMachineExit
 リスナーを実装する 
StateMachineBehaviours
 を持つステートマシンの評価は、メインスレッドに制約されます。
Animators.PrepareFirstPass次の処理ステップの準備をします。
Animators.ProcessGraphJob
Animator.ProcessGraph
ジョブのビルド、スケジュール設定、結果の待機を行います。
Animators.ProcessGraph (job)接続されているすべての AnimationClip のすべてのプロパティを評価します。

すべてのクリップのルートモーションプロパティをブレンドして、ルートモーションのディスプレイスメントを計算します。

現在の 
deltaTime
 の新しいアニメーションイベントを収集します。

AnimationClip のプロパティを評価するとき、カーブセグメントはフレーム間でローカルにキャッシュされ、AnimationClip のメモリからの必要以上の読み取りを防ぎます。
Animators.FireAnimationEventsAndBehaviours
StateMachineBehaviours
 と MonoBehaviour のすべてのアニメーションイベントメッセージを起動します。ただし、
Director.PrepareFrameJob
ですでに発生している 
OnStateMachineEnter
 または 
OnStateMachineExit
 リスナーは除きます。
Animators.ApplyOnAnimatorMoveMonoBehaviour にルートモーションを適用し、
OnAnimatorMove
 メッセージをトリガーします。

PreLateUpdate.DirectorUpdateAnimationEnd

このステージでは、Culling Mode が 
Always Update
のアニメーターと、Culling Mode が 
UpdateTransform
または 
Cull Completely
の表示中のアニメーターだけが処理されます。
Cull Completely
を持つアニメーターがルートモーションによってフレーム外に移動した場合、このフェーズには参加しません。StateMachineBehaviours と AnimationEvents でトリガーされたユーザーコードによって無効化されたアニメーターも同様です。

マーカー

機能

Animators.PrepareSecondPass次の処理ステップを設定します。Culling Mode と可視性の状態に基づくアニメーターのフィルタリングが含まれます。
Animators.SortWriteJobTransform システムでは、一度に 1 つのスレッドだけが Transform 階層を変更できます。この制限に対応するために、
Animators.SortWriteJob
は 
Animators.WriteTransforms
ジョブを Transform.root でグループ化します。

最高のパフォーマンスを得るには、ジョブのスケジュール設定と並列化の粒度を高めるために、同じ Transform 階層に複数の Animator を配置することは避けてください。
Animators.ProcessAnimationsJob
Animators.ProcessAnimations
ジョブのビルド、スケジュール設定、結果の待機を行います。
Animator.ProcessAnimations (job)1 つのアニメーターの現在アクティブな AnimationClip のすべてのプロパティをブレンドします (ルートモーションを除く)。アバターの内部表現に適用されます。

このマーカーの長さはアニメーションとブレンドの複雑さに応じて増減します。
OnAnimatorIKアニメーション IK を設定します。IK パスが有効なアニメーターコントローラーレイヤーごとに 1 回呼び出されます。
Animators.WriteJob
Animator.WriteTransform
ジョブのビルド、スケジュール設定、結果の待機を行います。これらのジョブは、アニメーションアバターから関連するゲームオブジェクトの Transform 階層に Transform のポーズを書き込みます。
Animators.WriteTransforms (job)ワーカースレッドからシーンにアニメーション化されたすべての Transform を書き込みます。
Animator.WritePropertiesTransform のポーズ以外のアニメーション化されたプロパティをターゲットオブジェクトに書き込みます。

パフォーマンスに関する注意

CPU Profiler は、いくつかの一般的なパフォーマンス問題を検出し、警告を発します。これらは、モジュールの詳細ペインの CPU Profiler モジュールの Hierarchy ビューの Warning 列に表示されます。
プロファイラーは、パフォーマンスに重要なコンテキストで避けるべき特定の呼び出しを検出します。以下のように、操作がパフォーマンスに影響を与えている理由とともに警告を表示します。

警告

説明

Animation.DestroyAnimationClip
Animation.AddClip
Animation.RemoveClip
Animation.Clone
Animation.Deactivate		RebuildInternalState がトリガーされたことを示します。RebuildInternalState は、Animation コンポーネント内の各クリップのリストを参照し、各カーブをゲームオブジェクトのコンポーネント上の値に再バインドする操作です。

これはリソースに負荷がかかる操作であるため、ランタイムにこれらのメソッドを呼び出すことはできるだけ避ける必要があります。
AssetBundle.asset/allAssetsAssetBundle の読み込みが完了していない状態 (AssetBundleRequest.isDone が false) で Unity が AssetBundleRequest.assets/allAssets API を呼び出したことを示します。これにより、メインスレッドでストールが発生し、ロードの操作が完了するのを待機します。
AsyncUploadManager.AsyncBufferResized
AsyncUploadManager.AsyncBufferDelete		GPU にデータをアップロードするための内部バッファのサイズが十分でないために、サイズ変更されていることを示します。このサイズ変更には時間がかかるため、CPU アクティビティのスパイクの原因になります。

この警告は、メモリに余裕があり事前に大きいサイズを割り当てられる場合は回避できます。

品質設定 の Async Upload Buffer Size 設定を使用して、デフォルトサイズを設定できます。

AsyncUploadManager.AsyncBufferResized マーカーは新しく割り当てられたサイズを示し、デフォルトバッファサイズの目安として使用できます。
Rigidbody.SetKinematicRigidbody 用の非凸のメッシュコライダーを再作成します。

追加リソース