プロファイラツールリファレンス | Unreal Engine 4.27 ドキュメンテーション

プロファイラ は Unreal Engine 3 では StatsViewer ツールに当たります。ゲームデータを収集およびトラックしてゲームのパフォーマンスをモニターするためのツールです。このデータを使って、ゲームの遅延または引きつりの潜在的な原因を特定するができます。

パフォーマンスを初めて調節する場合は、パフォーマンスおよびプロファイリングドキュメントを参照して、ゲームのパフォーマンスのモニタリング方法の詳細およびコツをご確認下さい。

プロファイラを有効にする

Profiler を有効にしてデータ収集を行う方法は 2 通りあります。

ライブ接続
- パラメータ --messaging でゲームを実行します (例えば、UE4Editor-Win64-Debug.exe -messaging)。
- パラメータ --messaging で UFE を実行します (例えば、 UnrealFrontend-Win64-Debug.exe -messaging)。
- [Window] メニューバーから Developer ツール の [Session Frontend (セッションフロントエンド)] を選択し、[Profiler (プロファイラ)] タブを選択します。
以下の方法で、キャプチャデータをロードします。
- [Profiler (プロファイラ)] タブからツールバーの [Load (ロード)] ボタンを押して、 「.ue4stats」 ファイルを選択します。
- エクスプローラーまたは他のファイルマネージャーから統計情報ファイルを [Profiler (プロファイラ)] ウィンドウへドロップします。

C:\Program Files\Unreal Engine\4.3\Engine\Binaries\Win64 フォルダからスタンドアロンの UnrealFrontEnd.exe を起動しても、 [Session FrontEnd] と [Profiler (プロファイラ)] タブへアクセスできます (注記: バージョンにより上記のパスが異なる場合があります)。

プロファイラウィンドウ

以下は [Profiler] ウィンドウと UI コンポーネントです。

画像をクリックしてフルサイズで表示

[Connected Session (接続済みのセッション)] と [Session Information (セッション情報)] ウィンドウをセッションとして使用して、統計情報データを取得します。
[Main Toolbar (メインツールバー)] ウィンドウには、基本的なグローバル機能が含まれます。
[Data Graph Full (データグラフ全画面)] ウィンドウでは、統計情報が全画面でグラフ表示されます。
[Data Graph (データグラフ)] ウィンドウは、統計情報がグラフ表示されます。
[Filter (フィルター)] と [Presets (プリセット)] ウィンドウには、すべての統計情報とグループが含まれます (ユーザーによるフィルタとソートが可能です)。
[Event Graph (イベントグラフ)] ウィンドウには、選択したフレーム (複数可) がイベントグラフとして表示されます。

メインツールバー

以下は、メインツールバー に含まれるアクションの説明です。

オプション	説明
	統計ファイルをロードすることができます。
	このオプションはまだ実装されていません。
	ライブ接続の場合のみ、接続されたセッション / クライアントとの通信が可能になります (有効の時はアイコンが光ります)。
	ライブ接続の場合のみ、データグラフビューとのライブ同期が可能になります。
	ライブ接続の場合のみ、クライアント上にデータをキャプチャします。キャプチャが完了するとポップアップメッセージが表示され、キャプチャデータをユーザーのマシンへ転送するかを確認します。データが転送されるとポップアップメッセージが表示され、希望に応じて統計ファイルをロードすることができます。
	Stats Profiler を有効にします。
	FPS Chart を表示します (このオプションは現在作業中です)。
	プロファイラの設定を開きます: [Single Instance Mode] または [Show Coalesced View Modes in Event Graph (イベントグラフで結合ビューモードで表示)] を有効 / 無効にします。

データをキャプチャした ファイルは以下の場所に格納されます: ...\UE4\Engine\Programs\UnrealFrontend\Saved\Profiling\UnrealStats\Received...

フィルタとプリセット

以下は、メインツールバー に含まれるアクションの説明です。

オプション	説明
Search Box (1)	統計情報の検索に使用します。文字列を入力すると、位置するエレメントが [Stats/Groups] ウィンドウで強調表示されます。
Group By (2)	統計情報のグループ化のメソッドです。デフォルトでは統計情報はグループ名でグループ化されます。
Sort By (3)	グループ内での統計情報のソート方法です。デフォルトでは名前でソートされます。
Stats/Groups Window (4)	統計情報とグループを表示します。アイコンをクリックすると、グループごとに拡張されます。統計情報はアイコンを強調表示させます。
	階層の統計情報、別名スコープカウンタの表示を切り替えます。
	単精度浮動小数点、倍精度浮動小数点、アキュムレータの表示を切り替えます。
	整数統計情報、ワードカウンタ、アキュムレータの表示を切り替えます。
	メモリ情報の表示を切り替えます (このオプションは現在作業中です)。

統計情報のトラック方法

3 通りの方法で統計情報をトラックできます。

選択した統計情報を ダブルクリック して、[Data Graph View] での表示に追加 / 削除します。
[Stats/Groups] ウィンドウ から [Data Graph View] へ統計情報をドラッグ＆ドロップします (下の画像をご覧ください)。
[Event Graph View] から統計情報を ドラッグ＆ドロップ します。

トラックされていると、統計情報は名前の横に「*」記号が付いて、異なる色で表示されます。

さらに、グループ名の次の () 内の数を見れば、グループでトラック中の統計数が分かります。

上図の Audio では、グループにある 11 項目のうち、現在 1 項目がトラック中です。

データグラフ

[Data Graph (データグラフ)] ビューにはトラックされた全ての統計情報が表示されます。統計情報のトラックを停止するには、統計情報というテキスト上にある [X] ボタンを押します。

統計情報のテキストは以下の情報で構成され、このように分類されます。

(Group Name)(グループ名) - 統計情報のグループ名
Stat Name (統計情報名) - 統計情報名
Actual Value (実際の値) - 統計情報の実際の値
Min Value (最小値) - キャプチャ全体での最小値
Avg Value (平均値) - キャプチャ全体での平均値
Max Value (最大値) - キャプチャ全体での最大値
Calls (コール) - この統計情報に対するコールを持つフレーム比率 (階層データの場合のみ)
Min Value (最低値) - キャプチャ全体でのこの統計情報に対するコールの最低数 (階層データの場合のみ)
Avg Value (平均値) - キャプチャ全体でのこの統計情報に対するコールの平均数 (階層データの場合のみ)
Max Value (最大値) - キャプチャ全体でのこの統計情報に対するコールの最大数 (階層データの場合のみ)

「階層データのみ」と記載された値は、階層データの場合のみ表示され、通常は表示されない場合があります。

Data Graph 軸は、以下のような説明もできます。

下 - 0.0 から開始する開始からの時間を表示します。
上 - 0.0 から開始する開始からのフレーム数を表示します。
左 - ズームレベルの時間に関する適応情報をミリ秒で表示します。マウスホイール を使って、 30 、 60 、 100 FPS で実行されるゲームの場合、 3 本の軸が既に定義されており、それぞれ異なる色で表示されます。
右 - 浮動小数点やメモリなど、その他の統計情報に関する適応情報を表示します。浮動小数点やメモリの値は通常、時間関連の情報より値が大きくなるため、この軸のスケールは左側の軸のスケールとは異なります。

[Data Graph (データグラフ)] ウィンドウを 右クリック しても、コンテキストメニューにオプション情報がついて表示されます。

View Mode - ここでは、 インデックスベース モードのみがサポートされています (タイムベース モードは プロファイル の使用はマルチセッションモードのみで、デフォルトでは無効になっている体験版の機能です)。
Select All Frames - すべてのフレームを選択して Event Graph View を更新します。
Live Preview - メインツールバーと同じオプションです。

イベントグラフ

イベントグラフビュー は、以下で構成されています。

タイトル - 現在接続中のセッション名、または現在ロードされた統計情報ファイルを表示します。
イベントグラフツールバー - イベントグラフ のフィルター、その他の機能に使用します。
関数の詳細 - 選択したイベント / 関数の詳細ビューです。
メインイベントグラフ - 選択したフレーム (複数可) の階層なビューです。

イベントグラフツールバー

以下は、イベントグラフツールバー 上に含まれる各アクションの説明です。

オプション	説明
	Data Graph 上でフレームが 1 つ選択された場合のみ有効になります。
	Data Graph で複数のフレームが選択されるとデフォルトで有効になります。フレーム別の平均グラフです。
	Data Graph で複数のフレームが選択されると有効にできる場合があります。フレーム別の一番高いグラフです。
	階層ツリービューのメインイベントグラフにコンテンツを表示します。
	包括時間でソートされているイベントのフラット表示リストに Main Event Graph のコンテンツを表示します
	イベント名で結合され包括時間でソートされているイベントのフラット表示リストにメインイベントグラフのコンテンツを表示します。
	排他時間でソートされているイベントのフラット表示リストに Main Event Graph のコンテンツを表示します
	イベント名で結合され排他時間でソートされているイベントのフラット表示リストにメインイベントグラフのコンテンツを表示します。
	アクション履歴を戻すボタンです。
	アクション履歴を進ませるボタンです。
	アクション履歴メニューを表示します。
	包括時間に基いて選択したイベントにホットパスを展開して、包括時間の降順ソートを有効にします (パフォーマンス負荷が最も大きいパスです)。

関数の詳細

[Function Details (関数の詳細)] は、ユーザーが選択した関数 / イベントと、選択したその関数 / イベントを実行するために呼びだされた関数の関係を表示します。これらの関係は、パーセント値に合わせてスケールされたボタンを使って表示されます。

ユーザーは上から下までイベントを簡単にたどって、パフォーマンス負荷の原因を探すことができます。[Function Details (関数の詳細)] ビューは メインイベントグラフ と双方向で同期しているので、新規関数を選択すると メインイベントグラフ でもその関数が選択されます。

[Function Details (関数の詳細)] は以下のエレメントで構成されています。

Calling Functions - 選択された関数を呼び出す関数を表示します。ウィジェットのサイズはパーセント値に基きます。
Current Functions - Main Event Graph イベントで現在選択されているイベント / 関数です。
Called Functions - 選択された関数に呼び出される関数です。ウィジェットのサイズはパーセント値に基きます。
- - これが表示されると、イベントは [Main Event Graph] ウィンドウでカリングされます (詳細は次のセクションで説明します)。
- - これが表示されると、イベントは [Main Event Graph] ウィンドウでフィルタがかけられます (詳細は次のセクションで説明します)。

アイコンにカーソルを合わせると、その項目の追加情報が表示されることを覚えておいてください。

メインイベントグラフ

メインイベントグラフ ウィンドウは、イベント実行パスを表示します。ルートは 1 つではありませんが、スレッドにはそれぞれの開始イベントがあります。通常これは、名前の「スレッド」または「0x1234」などの数字の ID で示されます。

メインイベントグラフ でフィルター、カリング、その他多くの関数の利用が可能になります。これらの関数は、 メインイベントグラフ を 右クリック し、表示されたコンテキストメニューから希望するアクションを選択すると利用できます。以下が説明です。

オプション	説明
Selection	選択したイベント名を表示します。
	Set Root - 選択したイベントにルートを設定して階層ビューに切り替えます
	Cull Events - 「ColumnName」に合わせた「値」にイベントをカリングします。カラム「Inc Time (MS)」に対してのみ使用できます。これらのイベントはグラフから削除され、それぞれの親が (IconCulled.png)(w:20 convert:false) アイコンを表示します。操作がしやすいように、ユーザーはこのアイコンを押せばカリング処理されたイベントをリストアすることができます。カリングが利用できない場合は、このオプションはグレイアウトされます。
	Filter Events - 「ColumnName」に合わせた「値」にイベントをフィルタします。[Inc Time (MS)]、[Exc Time (MS)]、[Calls] 欄に対してのみ利用できます。これらのイベントはグラフではグレイで表示されます。フィルタリングが利用できない場合は、このオプションはグレイアウトされます。
	Reset to Default - 選択したイベントグラフのルート、カリング、フィルタをデフォルトステートにリセットしてアクション履歴をクリアします。
	Expand All - すべてのイベントを展開します。
	Collapse All - すべてのイベントを折りたたみます。
	Expand Selection - 選択したイベントの子を展開します。
	Collapse Selection - 選択したイベントの子を折りたたみます。
	Expand Thread - 選択したスレッドの子を展開します。
	Collapse Thread - 選択したスレッドの子を折りたたみます。
	Expand Hot Path - 包括時間に基いて選択したイベントにホットパスを展開して、包括時間の降順ソートを有効にします (パフォーマンス負荷が最も大きいパスです)。
	Show in Hierarchical View - 階層ビューに切り替えて、選択したイベントを展開します
	Show in Flat Inclusive View - フラットな包括表示に切り替えて、包括時間による降順ソートを有効にします。
	Show in Flat Inclusive Coalesced - フラットな結合表示に切り替えて、包括時間による降順ソートを有効にします。
	Show in Flat Exclusive View - フラットな排他表示に切り替えて、排他時間による昇順ソートを有効にします。
	Show in Flat Exclusive Coalesced - フラットな排他表示に切り替えて、包括時間による昇順ソートを有効にします。
	Copy to Clipboard - 選択内容をクリップボードにコピーします。
	Select Stack - スタックのすべてのイベントを選択します。
	Sort By - 指定コラムでソートし、ソートモードの変更ができるメニューを表示します。
	View Column [利用可能なコラムリスト] - コラムの表示 / 非表示を可能にするメニューを表示します。
	Reset Columns to Default - コラムをデフォルト設定にリセットします。.

プロファイラを有効にする

プロファイラ ウィンドウ

メイン ツールバー