Ruby VMの計測

Available on: CRuby 2.0以上

プロセスで割り当てられたRubyオブジェクトの数。UIでは、この測定値はリクエスト数で正規化されており、リクエストごとにいくつのオブジェクトが割り当てられているかを把握することができます。

オブジェクトの割り当て頻度は、Ruby のガベージコレクタの実行頻度を決定する最大の要因の 1 つであるため、これは重要な数値となります。

CRuby では、この値はGC.stat[:total_allocated_object]から派生します。

Available on: CRuby 1.9.2以上、 Rubinius 2.x (JRuby サポートについては下記の注記を参照)

あなたのRubyプロセスでガベージコレクション（マークフェーズとスイープフェーズの両方）に費やされた時間です。

Rubyエージェントでは、この値を実際には2つの異なる方法で測定します。リクエスト処理の途中で発生したガベージコレクション時間と、ガベージコレクション時間の合計です。リクエスト処理の途中で発生したガベージ・コレクション・タイムは、メインの概要グラフ上に帯状に表示され、個々のトランザクションの内訳グラフにも表示されます。総ガベージコレクション時間のウォールクロック時間に対する割合は、「Ruby VMs」タブに表示されます。

この測定値はGC::Profiler.total_timeから導出されます。

Note: この測定値を取得するには、 GC::Profilerを有効にする必要があります。 詳細については、 「GC インストゥルメンテーション」を参照してください。

JRuby note: JRuby または特定のバージョンの JVM のバグと思われるものが原因で、JRuby では GC タイミングが 1000 倍ずれる可能性があります。 このため、現在 JRuby でGC::Profilerを有効にすることはお勧めしません。

Available on: CRuby 1.9.2以上、 JRuby 1.7+、Rubinius 2.x

Ruby プロセスを実行するためにガベージ コレクターが停止する必要がある頻度はどれくらいですか?CRuby 2.1+ では、これはメジャー GC 実行とマイナー GC 実行に分割されます。この数は、GC 実行ごとに処理されるリクエストの数として UI に表示されます。

使用中の Ruby のバージョンに応じて、この値はGC.countまたはGC.stat[:minor_gc_count]とGC.stat[:major_gc_count]から導出されます。

Available on: CRuby 1.9.2 以上

Ruby インタープリタはオブジェクトを ヒープ に格納し、各オブジェクトは ヒープスロット を 1 つ占有します。ヒープ内のスロットがオブジェクトでいっぱいになると、必要に応じてRuby VMによってヒープが拡張されます。

Rubyエージェントは、ヒープ内のライブオブジェクトの数と、ヒープの未使用スロットの数を定期的に測定します。

一般的に、ヒープ上のオブジェクトが多ければ多いほど、各GCの実行に時間がかかります（ヒープ上のすべてのオブジェクトを調べる必要があるため）。また、ヒープ上のオブジェクトが多いと、アプリケーションのメモリ使用量が多くなります。

この値は、 GC.stat[:heap_live_slot]またはGC.stat[:heap_live_num] 、およびGC.stat[:heap_free_slot]またはGC.stat[:heap_free_num]から導出されます。

Available on: 任意のRubyバージョン

この測定値は、Rubyプロセスのメモリ使用量（レジデント・セット・サイズ）を、インスタンス（プロセス）ごとの平均サイズで表示します。メモリ使用量をチェックすることは、Ruby VMの設定を調整する際の重要な考慮事項です。メモリ使用量が大きくなりすぎると、ホストマシンがディスクへのページングを開始したり、ソフトウェアによるメモリ制限に抵触したりする可能性があります。

Linux ホストでは、これは/proc/PID/statusのVmRSSフィールドから導出されます。

Available on: CRuby 2.1以上

オブジェクト上でメソッドが呼び出されるたびに、Ruby はそのオブジェクトの祖先の連鎖を検索してメソッドの実装を見つけなければなりません。これらの検索にはコストがかかるため、Ruby VM は検索結果をキャッシュします。

CRuby の古いバージョン (2.0 より前) では、単一のグローバル メソッド キャッシュがあり、キャッシュ全体を無効にするさまざまな操作がありました。

CRuby 2.1 以降では、グローバル キャッシュがクラスごとの小さなキャッシュ セットに分割されているため、1 つのクラスに対するキャッシュ無効化の変更によって、関連のない他のクラスのキャッシュ エントリが破棄されることはありません。

しかし、すべてのメソッド・キャッシュを無効にしてしまう操作もあります。Rubyエージェントはこれらの無効化の頻度を測定し、リクエスト数で正規化して報告します。これにより、リクエストごとに何回メソッド・キャッシュが無効化されるかを知ることができます。

詳細については、Aman Gupta による ブログ投稿を 参照してください。

この値はRubyVM.stat[:global_method_state]から導出されます。

Available on: CRuby 2.1以上

Ruby では、上述のメソッドキャッシュの動作と同様の方法で定数の位置をキャッシュします。Ruby エージェントは、グローバル定数キャッシュが無効化された回数を測定し、リクエストごとの平均無効化回数として報告することもできます。

この値はRubyVM.stat[:global_constant_state]から導出されます。

Available on: CRuby 1.9.2以上、 JRuby 1.7+、Rubinius 2.x

Ruby エージェントは、Ruby プロセスのスレッド数を把握することができます。マルチスレッドの Web サーバを使用している場合、この機能を使って、スレッドプールが実際に設定したサイズになっているかどうかを確認できます。また、スレッドリーク（削除されないスレッドを生成すること）が発生しているかどうかを確認することもできます。