Unreal Engine (UE) Advent Calendar 2022 の16日目の記事となります。
はじめに
コンソールコマンドのMemreportを使用してメモリリークの原因を調査したので、その時の対応を書き出してみました。
確認環境はUE5.0.3になります。
間違いなどありましたら、ご指摘いただけると有難いです。
経緯
イベントに展示するゲームのビルドを作成する際に、デモループを追加しました。
デモループは何も操作されない状態で長時間動き続ける可能性があるため、それを想定した長時間の放置確認も合わせて行いました。
8時間ほどデモループを流し続けた時点で、クラッシュすることもなく動き続けていて安心したのですが、その状態でプレイすると、処理が落ちが発生していました。
最初は何が起きたか分からず、タスクマネージャーを確認したところ、メモリの使用量が起動時の状態から300MBほど増加していました。起動直後は約300MBのメモリ使用量だったので倍に増えています。リソースを保持している可能性もありましたが、起動以降はリソースの読み込みもほぼ無いはずなので、メモリリークが発生していることが疑われます。
この時点で処理落ちの原因はわかりませんでしたが、メモリリークの状態を放置するのはまずいので、まずはそこを起点に調査していくことにしました。
調査したこと
メモリの調査方法について調べたところ、丁度良い記事を見つけました。
以下の記事を参考に、Memreportでメモリの状況を確認していくことにしました。
確認方法は簡単で、コンソールコマンドでmemreportと入力すると、
Saved以下のフォルダにファイルが出力されます。拡張子は「memreport」ですが、内容はテキスト形式です。
そのまま内容を見ても該当の箇所が分かる場合もありますが、出力タイミングの異なるファイルに対してdiffツールを使用することで、変化しているメモリに関わる部分を視認しやすくなります。
実際に何が起こっていたのか
まずは、起動直後とデモループを何度か繰り返して再生した後のMemreportを出力して差分を確認してみました。diffツールにはWinMergeを使用しています。
差分に一通り目を通すのも良いのですが、量が結構あるので、ある程度見る場所を絞った方が良いと思います。
長時間動いていてクラッシュしていないなら、リークが大量に発生しているとは考えにくいので、変化が少ない箇所から見ていくのが良さそうです。
変化の少ない下の方から見ていくと、どうやらテクスチャの項目の数値が増加している部分がありました。ファイル名を見ると、Niagaraで参照しているテクスチャでした。
ちなみに、末尾から3番目の数値は「Usage Count」(使用数)です。使用数が増えているということは、メモリの使用量も増えていると考えられます。
今度はNiagaraに当たりをつけて調べると、NiagaraComponentの数値が 287-199=88 増加しています。
これは、先ほどのテクスチャの使用数 240-152=88 と同等の増加です。これは偶然ではなく、Niagaraのエフェクトが残り続けていると考えて良さそうです。
コンポーネントが残っているということは、何らかの管理処理が動いていると想定できるので、処理落ちの原因になっている可能性が高いです。
他に目立ったエフェクトが残っていないようなので、このエフェクト自身の発生方法や設定に何かありそうだと予想されます。
原因は？
該当のエフェクトは、発生時にAuto DestroyをONにしているので、再生が終了した時点で特に問題無く消えてくれそうでした。
そうなると設定自体に問題がありそうなので、とにかく他のNiagaraエフェクトと比較したところ、存続期間に関するパラメータで以下の違いがありました。
上が間違っているときの状態で、下が正しい状態です。
Loop Behaviorのヘルプを見ると以下の説明があります。
エミッターの存続期間がLoop Durationを超えると非アクティブ状態に入るとあります。これは、Loop Duration ModeがInfiniteだと、非アクティブ状態にならないということになるのではないか？という疑問が出てきました。
確認
その設定で本当にエフェクトが残り続けるのかという疑問を解消するため、状況を再現して確認してみました。
Loop BehaviorがOnceの同じエフェクトを2つ用意して、それぞれのLoop Duration ModeをFixedとInfiniteに設定して発生させてみました。
それぞれ同時に50個ずつ発生させた後のNiagaraデバッガの表示です。NS_OnceがFixedの設定の方で、再生後にActiveが「0」になっています。Infiniteを設定したNS_OnceInfinityの方が、発生した数だけActiveが残っています。メモリも使用されたままです。
ざっくりとした確認ではありますが、パラメータ設定ミスが原因で、エフェクトがActiveのまま残り続けることが確認できました。
まとめ
今回のメモリリークの原因は、エフェクトの単純な設定ミスでした。色々パラメータを変更している際に、戻し忘れてしまったものと思われます。
設定を正しく修正することで、メモリリークの現象は収まり、8時間のデモループ後のプレイでも処理落ちしなくなりました。
ちなみに、コンポーネントに紐づけていないNiagaraエフェクトは、パーシスタントレベルを終了させれば全部消えるようです。
ゲームにもよると思いますが、パーシスタントレベルを保持したまま、シーンを遷移する実装を行った場合などは、何らかの解放忘れが発生する可能性が高くなるかと思います。
見た目の派手さも無く地道な作業ですが、機会を見てMemreportでメモリの状況を確認すると楽しい発見があるかもしれません。