# Editor Performance Tool を使ったパフォーマンス計測ツール

**URL:** <https://forums.unrealengine.com/t/editor-performance-tool/2187904>\
**Category:** 日本語 (Japanese)\
**Tags:** unreal-engine, Tools\
**Created:** [December 9, 2024, 8:59am UTC](https://forums.unrealengine.com/t/editor-performance-tool/2187904 "2024-12-09T08:59:37Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![Ken.Kuwano](https://d3kjluh73b9h9o.cloudfront.net/original/4X/2/8/5/28502927f1d97ba1051b3b47ccfe17233bf41ef0.png) [@Ken.Kuwano](https://forums.unrealengine.com/u/Ken.Kuwano)\
**Post date:** [December 9, 2024, 8:59am UTC](https://forums.unrealengine.com/t/editor-performance-tool/2187904/1 "2024-12-09T08:59:38Z")

</div>

# 1. はじめに

Editor Performance Toolは、UE5.5でExperimentalとして追加されたツールです。このツールはエディタ動作のパフォーマンスを計測し、ヒッチのタイミングやPCスペックが不足しているかどうか、といったパフォーマンス情報を検出して、ユーザーに通知したり、自動的にパフォーマンスログ（Unreal Insightsトレース）を取得することができます。

このツールを利用することで、ユーザーはエディタ動作におけるボトルネックを特定したり、定期的にエディタのパフォーマンスを観測・統計をとることができ、エディタの動作環境を安定させることに役立ちます。

 ![2024-12-06_17h37_38](https://d3kjluh73b9h9o.cloudfront.net/original/4X/6/6/c/66cb8aaa172e10961a7aa8e15c19cb34f5e98cb3.png)

# 2. 利用方法

このツールを有効にするには、前提としてEditor Performanceのプラグインが有効になっている必要がありますが(UE5.5ではデフォルトで有効)、実際にツールを起動するには手動で有効にする必要があります。この設定は、 [Editor Preferences] → [General] → [Performance] を開き、[Editor Peformance Tool] 内の [Enable Tool]の設定を有効にします。 有効にすると画面右下にエディタの再起動を求められるポップアップが表示されるため、エディタを再起動することで利用可能になります。

 ![2024-12-03_14h34_31](https://d3kjluh73b9h9o.cloudfront.net/original/4X/d/6/7/d6791d5e9899bbec478ab96eea8905f9d02a304b.png)

エディタを再起動すると、エディタの下部に [Performance] のステータスバーが表示されます。以下の図では警告のアイコンを表示しているため、エディタパフォーマンスにおいて何らかの警告が発生していることが確認できます。警告内容の詳細を知るためには、[View Performance Report] のパネルを選択することで表示することができます。

 ![2024-12-03_14h39_39](https://d3kjluh73b9h9o.cloudfront.net/original/4X/e/e/7/ee72b75993e5993e7bcddd191c3037c835cac578.png)

このパフォーマンスレポートは、エディタのメニューバー [Tools]-\>[Profile]-\>[Editor Performance] から開くこともできます。

 ![2024-12-03_14h39_50](https://d3kjluh73b9h9o.cloudfront.net/original/4X/b/5/6/b56f2c3fa58b7d3d2f4f31376e783632c9b07db6.png)  
ツールを開くと以下のようなUIを表示します。  
 ![2024-12-06_17h55_52](https://d3kjluh73b9h9o.cloudfront.net/original/4X/4/6/8/4689d28a26cbec4c67e405433aa135edd1033c4a.png)

# 3. プロファイルツールの項目

## Editor

エディタの基本動作に関する警告の項目を表示します。

**Boot**  
エディタの最初の初期プロセスにかかった時間を表示します。

**Load Map**  
初期マップのロード完了までにかかった時間を表示します。

**Asset Registry Scan**  
初期化時のアセットレジストリスキャンに要した時間を表示します。

**Plugin Count**  
読み込んでいる（モジュールロードした）プラグインの個数を表示します。

**Hitch Rate**  
エディタ操作時の15fpsを10回以上下回った際のヒッチ発生率を表示します。

**Total Time To Editor**  
エディタの起動完了までに要した時間を表示します。

**Stall Rate**  
エディタ操作時のCPUストールの発生率を表示します。

## PIE

PIE (Play In Editor)、エディタでセッションを開始した際の警告の項目を表示します。

**First Transition**  
初回PIE実行時の移行時間を表示します。

**Iterative Transition**  
初回以降のPIE実行時の移行時間を表示します。

**Shutdown**  
PIEのセッション終了時の時間を表示します。

**Hitch Rate**  
PIEセッション実行時の15fpsを10回以上下回った際のヒッチ発生率を表示します。

**Total Time To PIE**  
エディタ起動＋マップロード＋PIE移行時間を合算した、エディタ起動からPIEセッション開始までの時間を表示します。

**Stall Rate**  
PIEセッション時のCPUストールの発生率を表示します。

## Cache

キャッシュに関する警告の項目を表示します。

**Local Efficiency**  
ローカルDDCのキャッシュヒット率を表示します。

**Unreal Cloud DDC Latency**  
Unreal Cloud DDCの遅延の時間を表示します。

**Unreal Cloud DDC Speed**  
Unreal Cloud DDCの読み取り速度を表示します。

**Virtual Asset Efficiency**  
仮想アセットのキャッシュヒット率を表示します。

## Hardware

動作中の開発PCのハードウェアに関する警告の項目を表示します。

**Core Count**  
動作中のコア数（FPlatformMisc::NumberOfCores()で取得される値）を表示します。

**Total Memory**  
総メモリ使用量を表示します。

**Available Memory**  
使用可能なメモリ使用量を表示します。

## Hints

各警告の内容に対してどのような警告内容かを説明し、対処方法に対するヒントを表示します。

## Settings

パフォーマンスに関する各機能について、機能の有効無効を切り替えます。

**Notificaitons**  
エディタにポップアップで通知を送信するかどうかを指定します。

**Snapshots**  
警告が発生した際に自動的にUnreal Insights トレースのキャプチャを行うかどうかを指定します。ここで取得したキャプチャは、Project/Saved/EditorPerformance フォルダに保存されます。

**Telemetry**  
検出したテレメトリイベントをAnalysis Systemを介してHorde Serverに通知するかどうかを指定します。

**Throttling**  
エディタがバックグラウンド動作時にCPU使用率を下げるかどうかを指定します。エディタの設定 bThrottleCPUWhenNotForeground (Use Less CPU when in Background) と同期。

**Diagnostics**  
エディタにパフォーマンスモニターのUI (エディタ右上上部にFPS/Mem/Objs/Stalls)の項目を表示するかどうかを指定します。エディタの設定 bMonitorEditorPerformanceと同期。

# 4. プロファイルの設定

パフォーマンスの測定値は、.iniファイル等で設定される期待値と比較して、現在の値が期待値を満たさない場合に警告として通知します。ここで設定する期待値は、開こうとするマップや構成で異なることが想定されるため、複数のプロファイルを設定することもできます。期待値はプロジェクトのEditor.iniで新しいプロファイルを追加したり、既存のプロファイルを定義することができます。

 ![2024-12-06_16h55_44](https://d3kjluh73b9h9o.cloudfront.net/original/4X/2/7/3/273aafbd728e71702d9be6aaaa40880a1890dbf8.png)

```auto
[EditorPerformance.Profile.MyProject_Defualt]
ProfileName=MyProject_Defualt
Editor_Boot=60.0
Editor_Startup=120.0
Editor_Load_Map=120.0
Cache_Local_Efficiency=90.0
PIE_First_Transition=30.0
PIE_Total_Time_To_PIE=60.0
PIE_Iterative_Transition=30.0
PIE_Shutdown=10.0

```

設定の内容および詳細は「3.パフォーマンスツールの項目」、および EditorPerformanceModule.cpp を参照してください。

# 5. Editor Preferences の設定

Editor Preferencesで設定する項目はDefaultEditor.iniに保存/変更を反映することができます。

 ![2024-12-06_17h23_30](https://d3kjluh73b9h9o.cloudfront.net/original/4X/1/5/5/155353e565032604b85cecb585898d3ac51b0be4.png)

**Enable Tool**  
警告の発生を検知するツール自体の動作の有効、無効を切り替えます。

**Enable Notifications**  
警告が発生した際に、エディタの右下にポップアップとして通知するかどうかを切り替えます。

**Notification List**  
通知を受け取りたいイベントリストの定義です。これは通常ドロップダウンオプションを介して設定されます。

**Enable Telemetry**  
警告が発生した際のテレメトリイベントの通知を有効または無効に切り替えることができます。

**Enable Snapshots**  
警告が発生した際に Unreal Insights のスナップショットトレースの自動作成を有効または無効に切り替えます。

**Show Warnings Only**  
パフォーマンスビューに警告対象となっている項目のみを表示するかどうか、フィルタの制御設定を切り替えます。