先に何を集めた図かを確認する
フレームグラフは、スタックのような階層を持つデータを、出現量に応じた幅でまとめる図です。CPUのサンプルを使う場合もあれば、待機時間や割り当て量を使う場合もあります。見た目が似ていても、幅が表す単位は同じではありません。最初にサンプルの種類、対象プロセスやスレッド、観測期間、集計方法を確認します。CPU上の実行だけを集めた図から、寝て待っている時間の全内訳を直接求めたことにはなりません。図の色や高さから印象で原因を決めず、どの観測を変換したものなのかを出発点にします。
横軸は通常の時間順ではない
通常のフレームグラフでは、似たスタックを横へまとめて配置します。左側の関数が先に実行され、右側が後に実行されたという意味ではありません。時間順を残したフレームチャートなどとは区別します。幅が広い領域は、選んだ量で大きい割合を占めた経路です。横へ離れた二つの領域が同じ時間帯に重なって動いたかどうかも、この配置だけでは分かりません。呼び出しの時系列が必要なら、トレースや時間付きの別表示を使います。図の並びをそのままイベントの順番へ読み替えないことが、最初の重要な注意点です。
親の幅に子の処理が含まれる
下の枠が呼び出し元、上の枠がその経路で呼ばれた関数という形を考えます。親の幅は子孫を含む集計になり、各階層の幅をすべて足して全体時間にすることはできません。例えば説明用に100サンプル中60がparseを含み、そのうち40がdecodeを含むなら、60と40を足して100の独立した仕事と考えないようにします。親自身で使った量と、呼び出した先で使った量を区別します。幅の広い入口関数は、単に多くの仕事をまとめて呼んでいるだけの場合もあります。どの下位経路へ量が集まるかまで追って仮説を立てます。
深いスタックと高い費用は同じではない
スタックが深いことは呼び出しの段数を示しますが、それだけで多くのCPU時間を使うとは限りません。浅いが非常に幅の広い関数の方が、対象量を多く占めることもあります。また、最適化やインライン化、シンボル情報の不足で、名前やスタックの見え方が変わる場合があります。unknownの領域が大きいときは、その意味を無視して既知の小さな部分だけを最適化しません。サンプルを取る方法やスタック復元の条件も確認します。図にない関数が存在しないことや、一回も実行されなかったことを、限られた標本だけで証明したとは扱いません。
同じ仕事で変更前後を比べる
変更前後の比較では、入力、要求数、同時実行数、観測期間、サンプル設定をそろえます。全体が速くなっても割合だけの図では別の関数の割合が大きく見える場合があります。parseが減ったためserializeの割合が増えただけで、serializeが遅くなったとは限りません。絶対量や経過時間、処理件数と合わせて読みます。測定自体のオーバーヘッドも無視せず、同じ条件で反復します。幅が大きい経路を見つけたら、出力を変えずに処理回数を減らせるか、不要な再計算かなど、変更で確かめられる具体的な仮説へ落とし込みます。
保存するプロファイルも情報として扱う
プロファイルには関数名、パス、引数に由来する識別情報などが含まれる場合があります。共有前に収集対象と出力内容を確認し、必要以上の秘密や利用者情報を含めないようにします。CPUを観察する目的なら、まず局所的で短い観測から始め、負荷と権限の条件を明示します。ここで示した100サンプルの数字は読み方の例であり、特定サービスの実測ではありません。原因を確定するときは、図の形に加え、変更後に同じ正しい仕事が短時間で終わったかという検証を使います。見やすい図を作れたことと、改善を実証したことを分けます。