V8 CPU とメモリのプロファイリング
RubyMine を使うと、 V8 のサンプルベースプロファイラーを利用して、 Node.jsアプリケーションの CPU プロファイルおよびヒープスナップショットを取得・分析できます。
Google Chrome DevTools でクライアントサイドコード用にキャプチャしたスナップショットも開いて調査できます。
始める前に
CPU プロファイリング
CPU プロファイリングは、コード内のどの部分が最も多く CPU 時間を消費しているか、また V8 JavaScript エンジンによってどのようにコードが実行・最適化されているかを把握するのに役立ちます。
RubyMine の Node.js CPU プロファイリングは V8 組み込み CPU プロファイラーに基づいており、ガベージコレクションサイクル、コンパイルと再コンパイル、コード最適化など、コードの実行や JavaScript エンジン自体の挙動についての情報を提供します。
プロファイラは、ティックと呼ばれる一定の間隔でスナップショットを撮ります。 測定は、コードの作業だけでなく、コンパイル、システムライブラリの呼び出し、最適化、ガベージコレクションなど、エンジン自体によって実行されるアクティビティについても行われます。
CPU プロファイリングを有効にする
アプリケーションの起動時に V8 CPU プロファイリングを呼び出すには、 Node.js 実行構成で追加設定を指定する必要があります。
に進みます。 または、ツールバーの 実行 ウィジェットから 実行構成の編集 を選択します。
開いた 実行構成の編集 ダイアログで、ツールバーの 追加 ボタン (
) をクリックし、リストから Node.js を選択します。リストから Node.js 実行構成を選択して CPU プロファイリングを有効にするか、 Node.js の実行とデバッグ の説明に従って新しい設定を作成します。
V8 プロファイリング タブに切り替えて、 CPU プロファイリング情報を記録する チェックボックスを選択します。 ログフォルダー フィールドに、記録されたログの保存先フォルダーのパスを指定します。ログファイルは
isolate-<session number>という名前で保存されます。
CPU プロファイリング情報を収集する
メインツールバーのリストから実行構成を選択して
をクリックするか、メインメニューから を選択します。プロファイルする必要があるシナリオが実行されたら、ツールバーの
をクリックしてプロセスを停止します。
CPU プロファイリングログの分析
アプリケーションを停止すると、RubyMine は自動的に V8 プロファイリング ツールウィンドウを開き、収集したプロファイリングデータを表示します。 ウィンドウが既に開いていて他のセッションの収集データが表示されている場合、RubyMine は新しいタブを開きます。 自動的に開かれたタブには、アプリケーションの実行を制御し、プロファイリングデータを収集する実行構成に基づいて名前が付けられます。
以前に保存したプロファイリングデータを開いて分析するには、 に移動して（または Ctrl+Shift+A を押して）、 V8 と入力し始め、リストから V8 プロファイリングログの解析 を選択します。
次に、関連する V8 ログファイル isolate-<session number> を選択します。 RubyMine は、選択したログファイル名で別のタブを作成します。
収集したプロファイリングデータに基づき、RubyMine は呼び出しツリーを三つ作成し、それぞれを個別のペインに表示します。 これらの呼び出しツリーを使うことで、アプリケーションの実行をふたつの視点から分析できます。ひとつは「どの呼び出しが時間を多く消費したか ("重い")」、もうひとつは「誰が誰を呼び出したのか」です。
コールツリーのメトリクスを理解する
コールツリーは、関数内のティック数またはその合計実行時間に対する比率を表す 合計および セルフメトリクスを使用します。
Total は、関数内で費やされた時間とそれが呼び出した関数を示します。
Self は、子ノードを考慮せずに、関数自体の内部でのみ費やされた時間を示します。
親メトリクスは、それを呼び出した関数の実行時間に対する関数の純粋な実行時間の比（親 ）を示します。
V8 オプティマイザー
場合によっては、V8 でコードを最適化できます。 詳細については、 V8 の最適化(英語)を参照してください。
機能名の前のアスタリスク
*は、その機能が最適化されたことを示します。チルダ
~は、関数が最適化を必要としている可能性があるが、最適化されていないことを示します。 コードが短期間の場合、エンジンは最適化を延期するかスキップする場合がありますが、パフォーマンスを向上させるためにコードを書き直すことができる場所をチルダで示します。
トップコールツリー
トップ呼び出し数 ペインには、実行されたアクティビティが セルフメトリクスでソートされた降順で一覧表示されます。 各活動について、その 合計、 合計 %、 自己 % メトリクスが表示されます。 関数呼び出しごとに、RubyMine はその関数が定義されているファイル名、行、列を表示します。
概要 ペインのダイアグラムは、 自己 % メトリクスが 1% を超えるコールの セルフ時間の分布を示しています。
ボトムアップツリー
ボトムアップ ペインには、 セルフメトリクスによって降順にソートされた実行済みアクティビティも一覧表示されます。 トップ呼び出し数 ペインとは異なり、 ボトムアップ ペインには、 合計 % メトリクスが 2 を超えるアクティビティと呼び出した関数のみが表示されます。
アクティビティごとに、 ティックでの実行時間と 親メトリクスが表示されます。
関数呼び出しごとに、RubyMine はその関数が定義されているファイル名、行、列を表示します。
トップダウンツリー
トップダウン ペインには、呼び出し階層全体が表示され、上部には実行エントリポイントである関数が表示されます。 各活動について、その 合計、 合計 %、 セルフ、 自己 % メトリクスが表示されます。 関数呼び出しごとに、RubyMine はその関数が定義されているファイル名、行、列を表示します。
コールツリーを移動する
機能のソースコードに移動するには、この機能を選択してツールバーの F4 または
を押すか、コンテキストメニューから ソースに移動 を選択します。別のペインに切り替えて別の観点から呼び出しを調べるには、呼び出しを選択し、呼び出しのコンテキストメニューから 次に移動 を選択してから、宛先を選択します。 RubyMine は選択されたペインに切り替え、フォーカスを呼び出しに移します。
ノードを展開または折りたたむ
RubyMine がプロファイリングセッションのタブを開くと、デフォルトで最も負荷の高いコールを持つノードが展開されます。 ツリーを探索しているときに、これらのノードの一部を折りたたんだり、他のノードを展開したりすることもできます。
ノードを展開または折りたたむには、そのコンテキストメニューから ノードを展開 または ノードを折りたたむ を選択します。
アクティブペイン内のすべてのノードを折りたたむには、ツールバーの
をクリックします。元のツリー表示に戻すには、
をクリックします。
軽量な呼び出しをフィルタリングする
パフォーマンスの問題を引き起こすコールだけを確認するには、これを実行してください。
ツールバーの
をクリックしてから、スライダを使用して、表示される呼び出しの 合計 % または 親 % の最小値を指定し、 完了 をクリックします。
プロファイリングデータを保存して比較する
関数とそのメトリクスを含む行を保存するには、その関数のコンテキストメニューから コピー を選択します。 これは、たとえばコードを改善した後など、2 つのセッションからの関数の測定値を比較したい場合に役立ちます。
関数名とそれが定義されているファイルの名前だけを保存するには、関数のコンテキストメニューから 呼び出しのコピー を選択します。
アイテムをクリップボードの内容と比較するには、アイテムのコンテキストメニューから クリップボードと比較 を選択します。 RubyMine は 差分ビューアー を開きます。
現在のログを他のログと比較するには、ツールバーの
をクリックします。 開いたダイアログで、現在のものと比較するためにアイソレートを選択します。 検索対象を絞り込むには、ターゲット分離株が現在の分離株の前後どちらにあるかを指定します。
コールツリーをエクスポートする
現在のペインのコールツリーをテキストファイルに保存するには、ツールバーの
をクリックして、表示されるダイアログでターゲットファイルを指定します。
フレームチャートの分析
多色 フレームチャート を使用して、アプリケーションがどこで一時停止したかを見つけ、これらの一時停止を引き起こした呼び出しを調べます。
チャートは 四つの領域で構成されています：
上部の領域には、調査するフラグメントの先頭と最後を制限する 2 つのスライダを持つタイムラインが表示されます。
下の領域には、多色のチャートの形で呼び出しのスタックが表示されます。 最初に呼び出されると、各関数にはランダムな色が割り当てられ、現在のセッション内のこの関数のすべての呼び出しがこの色で表示されます。
中央の領域には、 ガベージコレクタからの呼び出し、エンジン、外部呼び出し、実行自体の概要が表示されます。 これらの活動のために予約されている色はエリアの上にリストされています。
右側のペインには、選択した断片内の呼び出しが一覧表示されます。各呼び出しについて、リストにはその所要時間、呼び出された関数の名前、および関数が定義されているファイルが表示されます。
下部と右側の領域は同期しています。下部領域のスライダーをタイムライン上でドラッグすると、右側のペインのフォーカスがそのとき実行されていたコールに移動します。
さらに、下部の領域でコールをクリックすると、スライダーが自動的にそのコールに移動し、右側のペインのフォーカスが対応する機能に切り替わり、必要に応じてリストが自動的にスクロールします。 逆にリスト内の項目をクリックすると、RubyMine は下部領域で該当するコールを選択し、スライダーを自動的にそこへ移動します：
タイムラインでフラグメントを選択する
特定の期間内のプロセスを調べるには、タイムラインで対応するフラグメントを選択する必要があります。 これを行うには、スライダーをドラッグするか、2 つのスライダー間の ウィンドウをクリックして、必要なフラグメントまでドラッグします。
いずれの場合も、下部の多色チャートが選択したフラグメント内のコールスタックを示します。
チャートを拡大するには、選択したフラグメントをクリックし、ツールバーの
をクリックします。 RubyMine は新しいタブを開き、選択したフラグメントをタブ幅に合わせて拡大表示し、より詳細に確認できます。
フレームチャートを移動する
右側領域のコールから、呼び出された関数のソースコード、ツールウィンドウの他のペイン、特定のメトリクスを持つフレームチャート内の領域へジャンプできます。
呼び出された関数のソースコードに移動するには、呼び出しのコンテキストメニューから ソースに移動 を選択してください。
呼び出しの特定のメトリクスを持つフラグメントでフレームチャートを拡大するには、呼び出しを選択し、呼び出しのコンテキストメニューから 次に移動 を選択してから、メトリクスを選択します。
呼び出しのスタックトレースに移動して、例外を表示および分析することもできます。 それには、呼び出しのコンテキストメニューから スタックトレースとして表示 を選択します。 RubyMine はスタックトレースを別タブで開きます。 フレームチャート ペインに戻るには、下部の V8 CPU プロファイリング ツールウィンドウボタンをクリックしてください。
メモリプロファイリング
メモリプロファイリングにより、メモリリークや動的メモリの問題を検出し、それを引き起こしたコード断片を特定できます。
メモリプロファイリングを有効にする
アプリケーション起動時にメモリスナップショットの取得を起動するには、 Node.js 実行構成で追加設定を指定する必要があります。
に進みます。 または、ツールバーの 実行 ウィジェットから 実行構成の編集 を選択します。
開いた 実行構成の編集 ダイアログで、ツールバーの 追加 ボタン (
) をクリックし、リストから Node.js を選択します。リストから、 Node.js の実行構成を選択して CPU プロファイリングをアクティブにするか、 Node.js 実行 / デバッグ構成を作成する に従って新しいコンフィギュレーションを作成します。
V8 プロファイリング タブに切り替えて、 ヒープスナップショットの取得を許可する チェックボックスを選択します。
メモリプロファイリング情報を収集する
メインツールバーのリストから実行構成を選択して
をクリックするか、メインメニューから を選択します。アプリケーションの実行中はいつでも、 実行 ツールウィンドウのツールバーの
をクリックします。表示されるダイアログで、スナップショットの名前と保存先フォルダーへのパスを指定します。 スナップショットの分析をすぐに開始するには、 スナップショットを開く チェックボックスを選択します。
メモリスナップショットの分析
スナップショットを取得して分析を選択すると、RubyMine は収集データとともに V8 ヒープ ツールウィンドウを開きます。 ウィンドウが既に開いていて他のセッションの収集データが表示されている場合、RubyMine は新しいタブを開きます。
以前に保存したメモリプロファイリングデータを開いて分析するには、 に移動します（または Ctrl+Shift+A を押して、 V8 の入力を開始し、リストから V8 ヒープスナップショットの解析 を選択します。
次に、関連する .heapsnapshot ファイルを選択します。 RubyMine は、選択したファイル名で別のタブを作成します。
ツールウィンドウには、さまざまな視点から収集情報を表示するタブが三つあります。
包含 タブには、アプリケーション内のオブジェクトが複数のトップレベルエントリー（DOMWindow オブジェクト、 ネイティブブラウザーオブジェクト、 GC Roots （Garbage Collector が実際に使用するルート））の下にグループ化されて表示されます。 詳細は Containment View を参照してください。
各オブジェクトについて、このタブは GC ルートからの距離 （つまりそのオブジェクトと GC ルート間のノードの最短単純パス）、オブジェクトの シャローサイズ 、および 保持サイズ を表示します。 オブジェクトサイズの絶対値に加え、RubyMine はそのオブジェクトが占有するメモリの割合も表示します。
最大オブジェクト タブでは、 保持サイズでソートされた最もメモリを消費するオブジェクトが表示されます。 このタブでは、グローバルオブジェクトにデータを蓄積することによって引き起こされるメモリリークを見つけることができます。
要約 タブには、アプリケーション内のオブジェクトがタイプ別にグループ化されて表示されます。 タブには、各タイプのオブジェクトの数、サイズ、占有しているメモリの割合が表示されます。 この情報は、メモリ状態の手掛かりになる場合があります。
各タブには 詳細 ペインがあり、GC ルートから現在選択されているオブジェクトへのパスとオブジェクトの リテイナのリスト、つまり選択されたオブジェクトへのリンクを保持するオブジェクトが表示されます。 すべてのヒープスナップショットには多くの「バック」参照とループがあるため、オブジェクトごとに多数のリテイナーが常に存在します。
オブジェクトにテキストラベルを付ける
ラベルを利用すると、コンテキストを失わずにオブジェクトを区別したり、移動したりできます。
オブジェクトにラベルを設定するには、オブジェクトを選択してツールバーの
をクリックするか、コンテキストメニューから マーク を選択します。 次に開いたダイアログでテキストラベルを指定します。
スナップショットを移動する
オブジェクトに対応する関数または変数に移動するには、このオブジェクトを選択してツールバーの
をクリックするか、コンテキストメニューから ソースの編集 を選択します。 ボタンおよびメニューオプションが無効な場合、RubyMine は選択されたオブジェクトに対応する関数や変数を見つけられなかったことを意味します。複数の関数または変数が見つかった場合、RubyMine はこれらを候補リストに表示します。
Containment の観点からオブジェクトを調査してオブジェクト間のリンクに集中できるよう、RubyMine では 最大オブジェクト または 要約 タブ、 出現箇所 ビューのオブジェクトから 包含 タブの同じオブジェクトへジャンプできます。
これを行うには、オブジェクトを選択し、コンテキストメニューから メインツリー内の移動 を選択します。
スナップショットを検索する
包含 タブで、ツールバーの
をクリックします。表示される V8 ヒープ検索 ダイアログで、検索パターンと検索範囲を指定します。 使用可能な範囲は次のとおりです。
すべての場所： すべてのスコープで検索する場合は、このチェックボックスを選択してください。 このチェックボックスを選択すると、他の検索タイプはすべて無効になります。
リンク命名：: C++ ランタイムを呼び出すときに V8 が作成するオブジェクト名の中から検索するには、このチェックボックスを選択します。
V8 ヒープ ツールウィンドウでは、リンク名は
%文字%<link name>でマークされています。クラス命名：: このチェックボックスを選択すると、関数コンストラクターを検索できます。
テキスト文字列：: このチェックボックスを選択すると、オブジェクトの内容でテキスト検索が実行されます。
スナップショットのオブジェクト ID：: このチェックボックスを選択すると、オブジェクトの一意の識別子を検索できます。 V8 は、オブジェクトが作成されるときにその形式でそのような固有の ID を各オブジェクトに割り当て、オブジェクトが破棄されるまでそれを保存します。 つまり、同じセッション内で作成された複数のスナップショットで同じオブジェクトを見つけて比較することができます。
V8 ヒープ ツールウィンドウでは、オブジェクト ID は
@文字@<object id>でマークされています。マーク：: このチェックボックスを選択して、 包含 タブのツールバーの
をクリックして、オブジェクトに手動で設定したラベルを検索します。
検索結果は、 詳細 ペインに別の 「<検索パターン>」の出現； ビューで表示されます。 指定した検索範囲で検索結果をグループ化して表示するには、ツールバーの タイプ別にグループ化 トグルボタンを押します。
次回ダイアログを開くと、前回の検索設定が表示されます。