ゲーム開発の救世主！Tracyで実現する1フレーム単位の超精密パフォーマンス分析とライブデバッグ入門

wolfpld/tracy

今回は、高性能なフレームプロファイラである wolfpld/tracy について、ソフトウェアエンジニアの視点から、トランクス派とブリーフ派のコント風で分かりやすく解説していきますね！

舞台は、とあるソフトウェア開発会社の休憩室。ベテランのトランクス派エンジニアと、若手のブリーフ派エンジニアが、熱くプロファイラについて語り合っています。

トランクス派 (ベテラン)
「おい、若いの。最近、俺たちが作ってるゲーム、どうもフレームレートが安定しないんだよな。ボクサーブリーフみたいに中途半端なプロファイラじゃ、どこがボトルネックか、見当もつかんだろう？」

ブリーフ派 (若手)
「ベテランさん、お任せください！そこで登場するのが、この Tracy ですよ。まさしく、白いブリーフのようなタイトで素早いプロファイリングが可能です！」

Tracyは、主に以下のような点でソフトウェアエンジニアのパフォーマンスチューニングに役立ちます。

フレーム単位の正確な分析

トランクス派
「俺たちの使ってるプロファイラは、数秒ごとの平均値しか見せてくれないから、ガバガバで大雑把な情報しかわからないんだよ。」

ブリーフ派
「Tracyは、ゲームなどの1フレームごとの実行時間を非常に詳細に記録します。スパゲッティコードのどこで時間がかかっているか、ミリ秒、マイクロ秒単位でピシッと特定できますよ！」

低オーバーヘッド

ブリーフ派
「一般的なプロファイラは、計測自体に時間がかかりすぎて、まるでおむつを履いたみたいに処理が遅くなります。しかしTracyは超軽量で、本番に近い速度で計測できます。」

ライブビューとリモートプロファイリング

トランクス派
「デバッグ用にビルドしたものを動かして、後でファイルを開くのは面倒なんだ。もっと開放的なやり方はないのか？」

ブリーフ派
「Tracyはライブで計測結果をビューアに送信します。開発中のPCだけでなく、リモートのテスト機やコンソール機のパフォーマンスも、まるで鏡を見るようにリアルタイムで確認できます！」

豊富なコンテキスト情報

ブリーフ派
「CPUの処理時間だけでなく、メモリ割り当て、ロックの競合、GPUの実行時間など、下着のゴムの伸び具合までチェックするくらい、隅々まで詳細なコンテキスト情報を収集できます。」

トランクス派 (ベテラン)
「ふむ、ライブで詳細に見られるのは良いな。で、導入はふんどしを締めるみたいに大変なのか？」

ブリーフ派 (若手)
「ご安心ください、非常に簡単です！主にC++プロジェクトを想定していますが、他の言語バインディングもあります。」

Tracy リポジトリの取得

Gitでリポジトリをクローンします。

git clone https://github.com/wolfpld/tracy

プロジェクトへの組み込み

通常、Tracyをサブモジュールとして追加し、ビルドシステム（CMakeなど）に組み込みます。

計測用のライブラリ (TracyClient) をプロジェクトにリンクします。

ビューアのビルドと起動

Tracyには計測結果を可視化するためのスタンドアロンのビューアがあります。

これをビルドし、起動しておきます。

ソースコードへの計測マクロ挿入

パフォーマンスを計測したいコードブロックに、専用のマクロを挿入します。

トランクス派 (ベテラン)
「マクロ…？派手な柄のトランクスみたいに目立つのか？」

ブリーフ派 (若手)
「目立ちますよ！でも、本番ビルドでは見えないようにコンパイルされます。デバッグ専用です！」

特定の関数やコードブロックの実行時間を計測する最も一般的な方法です。

#include "Tracy.hpp" // Tracyのヘッダをインクルード

// 関数全体を計測する場合
void RenderFrame() {
    // このマクロが呼ばれたスコープ（ブロック）の実行時間を計測する
    ZoneScoped; 
    
    // ... 大量の描画処理 ...
    
    // 他のフレームワークの処理時間も計測できる
    ZoneText("Draw Calls", 10); // Viewaに表示されるラベルを設定
}

// 別途、手動で計測開始/終了を制御したい場合
void UpdatePhysics() {
    // 計測ゾーンのインスタンスを作成
    ZoneScopedN("PhysicsUpdate"); // 任意の名前を付けられる
    
    // ... 複雑な物理計算 ...
    
    // スコープを抜けると自動的に計測が終了する (RAIIの仕組み)
}

Tracyはフレームプロファイラなので、「フレームの始まりと終わり」をマークすることが非常に重要です。

// メインループの最後など、フレームの描画が完了したタイミングで呼び出す
void MainLoop() {
    while(IsRunning) {
        // ... ゲームの更新・描画処理 ...
        
        //  必ず実行する
        FrameMark; // 現在のフレームがここで終了したことをTracyに伝える
    }
}

マルチスレッド環境では、どの処理がどのスレッドで実行されているかを明確にする必要があります。

void WorkerThreadFunc() {
    // スレッドが起動したら、一度だけ呼び出す
    // Viewaでこのスレッドが識別しやすくなる
    tracy::SetThreadName("ResourceLoadingThread"); 
    
    while(true) {
        ZoneScoped;
        // ... 重いリソースのロード処理 ...
    }
}

トランクス派 (ベテラン)
「なるほどな。トランクスが全体的な余裕で快適さを目指すように、全体的なパフォーマンスを把握しつつ…」

ブリーフ派 (若手)
「そして、ブリーフがタイトに細部まで制御して、ボトルネックという名のたるみを一切許さない！それが Tracy の力です！」

Tracy は、ゲーム開発やハイパフォーマンスコンピューティングなど、時間的制約が厳しいソフトウェアにおいて、パフォーマンスの問題を正確かつ低オーバーヘッドで特定し、解決するための強力な武器となります。

ご自身のプロジェクトで速度の改善が必要になったら、ぜひ試してみてくださいね！