ドキュメント

Unity Engine

Unity Engine

CPU Usage プロファイラーモジュールの操作

CPU Usage プロファイラーモジュールを操作してパフォーマンスデータを調査します。
読み終わるまでの所要時間 9 分最終更新 6日前

CPU Usage プロファイラーモジュールには、ビュー間を簡単に操作するためのユニバーサル操作がいくつかあります。

選択したサンプルにフォーカスする

選択したサンプルにフォーカスするには、F キーを押します。何も選択していない場合は、デフォルトのズームレベルが表示されます。
階層、Raw 階層、または反転階層ビューに変更しても、サンプルがメインスレッド上にある限り、選択内容が引き継がれます。選択したものがすぐに見つからない場合は、F キーを押してフォーカスします。
Timeline ビューの軸の領域をズームするには、以下を行います。
  • マウスのスクロールホイールを使用するか、
  • Alt キーを押しながら、 右マウスボタンを押したままドラッグするか、 または
  • 水平スクロールバーの端を使用してズームインします。
  • ビューをパンするには、マウスの中ボタンを押すか、Alt キー (macOS ではコマンドキー) を押しながらマウスの左ボタンを押します。
キーボードの A キーを押してズームをリセットし、フレーム時間全体を表示します。
以下のオプションは、スレッドのディスプレイを管理するために使用できます。
  • スレッドを展開するには、スレッドの下部にある白い矢印をクリックしてすべての行をディスプレイ
  • 表示する行数を調整するには、スレッドを区切る線をドラッグします。
  • スレッドのセクションの高ささをコールスタックの最大深度に設定するには、行をダブルクリックします。
  • スレッドのグループを折りたたんだり展開したりするには、ビューの左端にあるスレッド名の横にある折り畳みの矢印をクリックします。

コールスタックを有効にする

GC.Alloc
、
UnsafeUtility.Malloc
、および
JobHandle.Complete
が発行するサンプルの全コールスタックを有効にできます。これらのコールスタックを有効にするには、次の手順に従います。
  1. プロファイラーのツールバーのコールスタックボタンを有効にします。デフォルトでは、
    GC.Alloc
    サンプルのコールスタックが有効になっています。
  2. ほかのコールスタックを有効にするには、ドロップダウン矢印を選択し、コールスタックをディスプレイするほかのマーカーを有効にします。
この機能は、Unity エディターでプロファイルする場合でも、実行中のプレイヤーでプロファイルする場合でも使用できます。これは、この設定を有効にした後にプロファイルするフレームに対してのみエフェクトがかかります。
コールスタックをさらに調査する
  1. Timeline ビューでサンプルを選択
  2. コールスタックをコピーするには、「Copy」を選択します。
  3. 関連するコードファイルを開くには、ファイルパス (青いリンクで強調表示されている部分) を選択します。**ノート:**すべてのコードファイルがこの方法で使用できるわけではありません。また、コールスタック情報には、そのメソッド内の正確な行番号ではなく、メソッドの先頭の行だけが含まれます。
コールスタックの全詳細を開く
  1. 階層ビューまたは Raw 階層ビューでサンプルを開きます。
  2. 詳細ビューを関連データに設定します。
関連データビューには、このサンプルに関連付けられているメタデータがリストされます。これには、そのサンプルに関連付けられた
UnityEngine.Object
が含まれる場合があります。
UnityEngine.Object
に関連付けられていないメタデータ エントリーについては、このパネルで名前が N/A と表示されます。N/A エントリーを選択すると、プロファイラーは詳細ビューの下半分にコールスタックなどのメタデータを表示します。
Unity がレポートするサンプルには、レンダリングを実行する
Camera
ゲームオブジェクトにリンクされた
Camera.Render
サンプルなど、ビルトインのメタデータがあるものもあります。再生モードでプロファイルする場合、Unity はこれらのオブジェクトをインスタンス ID でレポートし、プロファイラー ウィンドウで名前に解決します。これらのオブジェクトの 1 つをクリックすると、Unity はシーン階層からオブジェクトを検索して ping を送信しようとします。
アソシエーションはインスタンス ID を使用するため、ping が機能するのは、アプリケーションを再生モードでプロファイルするときと、オブジェクトが存在する間だけです。
GC.Alloc
サンプルの場合、このビューには、この階層レベルで発生した各アロケーションの
N/A
アイテムのリストと、アロケーションのサイズが GC.Alloc カラムに表示されます。

Profiler window in Timeline view with GC.Alloc sample selected (top), and with the same sample selected in Hierarchy view.

これらのマーカーの詳細については、プロファイラーマーカーに関するドキュメントを参照してください。

追加リソース