ドキュメント

Unity Engine

Unity Engine

CPU Usage プロファイラーモジュールの概要

アプリケーションのCPUパフォーマンスを調査し、パフォーマンスのボトルネックを特定します。
読み終わるまでの所要時間 12 分最終更新 5日前

アプリケーションが CPU プロファイラーモジュールを使用する場所の概要を把握します。
CPU Usage プロファイラーモジュールは、レンダリング、スクリプト、アニメーションなど、アプリケーションが時間を費やす領域の概要を提供します。この情報はウィンドウの上部にあるチャートに表示されます。個々のフレームを選択して Timeline 内のデータを検査したり、プロファイラーウィンドウの下半分にある詳細ペインのさまざまな階層ビューでデータを検査できます。

Views (視聴数)

CPU Usage プロファイラーモジュールは、プロファイリングデータを Timeline ビュー、または異なる階層ビューに表示します。以下のビューが利用可能です。
  • タイムラインサンプルを Timeline グラフに表示します。タイムライングラフには、異なるスレッド上のマーカーの関係が表示されます。
  • 階層:コールスタックとマーカーでグループ化されたサンプルを表示します。
  • 反転階層:マーカーでグループ化されたサンプルを反転サンプルスタックで表示します。
  • Raw階層:グループ化されていないサンプルを表示します。
ビューを変更するには、プロファイラーウィンドウの下半分にあるドロップダウンビューセレクターを使用します。

Profiler window with a frame in the CPU Usage Profiler module selected. The Timeline view is selected in the details pane.

Timelineラインビュー

Timeline ビューは、CPU Usage プロファイラーモジュールのデフォルトビューです。アプリケーションに費やした時間の概要と、タイミングの相互関係が示されます。すべてのスレッドのパフォーマンスデータを、それぞれのサブセクションに同じ時間軸に沿って表示します。
Timeline ビューを使用して、並列実行で異なるスレッドのアクティビティーが互いにどのように相関するかを理解できます。Timeline ビューには、ジョブシステムのワーカースレッドなど、アプリケーションがさまざまなスレッドをどれだけ使用しているかも表示されます。また、スレッドの作業がどのようにキューに入れられているか、アイドル状態のスレッド (Idle サンプル) か、別のスレッドまたはジョブの終了を待っているスレッド (Wait for x サンプル) かを示します。

階層ビュー

階層 ビューにはプロファイリングデータが 1 スレッドずつディスプレイされます。デフォルトではメインスレッドになっています。これらのビューにはサンプルの継続時間さのみがディスプレイされますが、Timelineビューには各サンプルが発生した時間が表示されます。
階層ビューには、プロファイルしたすべてのサンプルがリストされ、共有コールスタックとプロファイラーマーカーの階層によってグループ化されます。Raw 階層ビューはサンプルをグループ化しないため、サンプルをきめ細かく調べるのに最適です。
階層反転ビューは、プロファイラーマーカーによってサンプルをグループ化し、反転サンプルスタックとともに表示します。階層の最初のレベルには、各プロファイラーマーカーのアイテムが表示されます。樹木内の各子アイテムは、反転したサンプルスタックの一部を表し、そのデータは、このサンプルスタックを介して集約された親アイテムに費やされた時間またはヒープメモリーの量を示します。
階層反転ビューは、パフォーマンスに小さな影響を与える多くのインスタンスが原因で発生する、より大きなパフォーマンスの問題を明らかにするのに役立ちます。この種の問題は、Timeline ビューや非反転階層ビューでは見つけにくい場合があります。

マネージコードコールスタックと割り当ての調査

プロファイラーマーカーは、プロファイリング情報を異なる時系列および階層ビューにディスプレイおよび整理するためにプロファイラーが使用するサンプルのセットを生成します。プロファイラー ウィンドウに表示されるすべてのサンプルは、サンプルスタックの一部です。
サンプルスタックはメソッドのコールスタックとは異なります。Unity はすべてのサンプルを特定のメソッドに関連付けるわけではなく、すべてのコールをサンプルとして記録するわけではありません。ディーププロファイリングは、すべての機能コールにプロファイラーマーカーを追加しますが、ネイティブコードには追加せず、サンプルのレコーディングには高いオーバーヘッドがかかります。
CPU Usage プロファイラーモジュールを使用して、
GC.Alloc
、
UnsafeUtility.Malloc
、および
JobHandle.Complete
が発行するサンプルのコールスタック全体を検査できます。これは、ディーププロファイリングを有効にして高いオーバーヘッドに遭遇することなく、これらのサンプルが発生した場所を追跡したい場合に便利です。コールスタックを有効にする方法については、「 フルコールスタックの有効化 」を参照してください。

マネージアロケーションの調査

また、CPU Usage プロファイラーを使用して、Unity がメモリ クリーンアップを実行した場所を調べることもできます。
コードが新しいマネージオブジェクトを作成するたびに、現在のメモリーヒープに収まらず、Unity がガベージコレクションを実行する可能性があります。ガベージコレクションは、すべてのスレッドを一時停止し、マネージヒープをスキャンして未使用メモリを探します。このプロセスには時間がかかり、フレームレートが乱れる場合があります。マネージガベージコレクションはプロファイラーに
GC.Collect
サンプルとして表示され、マネージアロケーションは
GC.Alloc
として表示されます。
ガベージコレクターがアプリケーションのフレームレートに影響を与えないようにするには、アプリケーションの実行中は
GC.Alloc
値を 0 に保ち、ヒープサイズを小さくします。Timeline ビューでは、
GC.Alloc
サンプルは赤紫色で表示され、アロケーションのサイズを表します。
コードマネージアロケーションのどこで発生するかを確認するには、GC.Alloc の完全なコールスタックを有効にします。マネージヒープの詳細については、マネージメモリー に関するドキュメントを参照してください。

追加リソース