GSpaceCounters 及びその補助クラス (GSpaceCounters, GenerationUsedHelper)

これらは, 保守運用機能のためのクラス. より具体的に言うと, Generation オブジェクトに関する情報を PerfData 形式で出力するためのクラス (See: here for details) (See: PerfData).

クラス一覧(class list)

GSpaceCounters

概要(Summary)

Generation と1対1対応するような Space に関する PerfData を格納しておくためのクラス (実際の使われ方としては, CompactibleFreeListSpace に関する PerfData を格納しておくためのクラス).

    ((cite: hotspot/src/share/vm/gc_implementation/shared/gSpaceCounters.hpp))
    // A GSpaceCounter is a holder class for performance counters
    // that track a space;

    class GSpaceCounters: public CHeapObj {

使われ方(Usage)

インスタンスの格納場所(where its instances are stored)

各 ConcurrentMarkSweepGeneration オブジェクトの _space_counters フィールドに(のみ)格納されている.

    ((cite: hotspot/src/share/vm/gc_implementation/concurrentMarkSweep/concurrentMarkSweepGeneration.hpp))
    class ConcurrentMarkSweepGeneration: public CardGeneration {
    ...
      GSpaceCounters*          _space_counters;

生成箇所(where its instances are created)

    ((cite: hotspot/src/share/vm/gc_implementation/concurrentMarkSweep/concurrentMarkSweepGeneration.cpp))
    void ConcurrentMarkSweepGeneration::initialize_performance_counters() {
    ...
      _space_counters = new GSpaceCounters(gen_name, 0,
                                           _virtual_space.reserved_size(),
                                           this, _gen_counters);

    ((cite: hotspot/src/share/vm/gc_implementation/concurrentMarkSweep/cmsPermGen.cpp))
    void CMSPermGenGen::initialize_performance_counters() {
    ...
      _space_counters = new GSpaceCounters(gen_name, 0,
                                           _virtual_space.reserved_size(),
                                           this, _gen_counters);

内部構造(Internal structure)

内部には, 記録対象の Generation と, そのパフォーマンスカウンタとして使う PerfVariable 2 個を保持している.

    ((cite: hotspot/src/share/vm/gc_implementation/shared/gSpaceCounters.hpp))
      PerfVariable*      _capacity;
      PerfVariable*      _used;

    ((cite: hotspot/src/share/vm/gc_implementation/shared/gSpaceCounters.hpp))
      Generation*       _gen;

これらの PerfVariable には, (そのフィールド名の通り) 対応する Generation の最大量(capacity)と現在使用量(used)が記録される.

    ((cite: hotspot/src/share/vm/gc_implementation/shared/gSpaceCounters.hpp))
      inline void update_capacity() {
        _capacity->set_value(_gen->capacity());
      }

      inline void update_used() {
        _used->set_value(_gen->used());
      }

正確には, 可変でない項目も入れると, 各 Space の以下の情報が格納されている (現在の領域長や現在の使用量は実行時に変わるので GC 後などに変更している. それ以外は生成時に指定した値で固定).

それぞれ以下の名前でアクセス可能 (${n} や ${m} の箇所には 0, 1, ... といった数字が入る. 例えば sun.gc.generation.0.space.1.name 等)

    ((cite: hotspot/src/share/vm/gc_implementation/shared/gSpaceCounters.cpp))
        const char* cns = PerfDataManager::name_space(gc->name_space(), "space",
                                                      ordinal);

        _name_space = NEW_C_HEAP_ARRAY(char, strlen(cns)+1);
        strcpy(_name_space, cns);

        const char* cname = PerfDataManager::counter_name(_name_space, "name");
        PerfDataManager::create_string_constant(SUN_GC, cname, name, CHECK);

        cname = PerfDataManager::counter_name(_name_space, "maxCapacity");
        PerfDataManager::create_constant(SUN_GC, cname, PerfData::U_Bytes,
                                         (jlong)max_size, CHECK);

        cname = PerfDataManager::counter_name(_name_space, "capacity");
        _capacity = PerfDataManager::create_variable(SUN_GC, cname,
                                                     PerfData::U_Bytes,
                                                     _gen->capacity(), CHECK);

        cname = PerfDataManager::counter_name(_name_space, "used");
        if (sampled) {
          _used = PerfDataManager::create_variable(SUN_GC, cname, PerfData::U_Bytes,
                                                   new GenerationUsedHelper(_gen),
                                                   CHECK);
        }
        else {
          _used = PerfDataManager::create_variable(SUN_GC, cname, PerfData::U_Bytes,
                                                   (jlong)0, CHECK);
        }

        cname = PerfDataManager::counter_name(_name_space, "initCapacity");
        PerfDataManager::create_constant(SUN_GC, cname, PerfData::U_Bytes,
                                         _gen->capacity(), CHECK);

詳細(Details)

GenerationUsedHelper

概要(Summary)

Generation を PerfLongSampleHelper (のサブクラス) として使うためのラッパークラス (より具体的に言うと, Generation の使用量情報(used)を PerfVariable で記録するためのクラス).

    ((cite: hotspot/src/share/vm/gc_implementation/shared/gSpaceCounters.hpp))
    class GenerationUsedHelper : public PerfLongSampleHelper {

内部構造(Internal structure)

やってることは, PerfLongSampleHelper::take_sample() を Generation::used() に変換するだけ.

    ((cite: hotspot/src/share/vm/gc_implementation/shared/gSpaceCounters.hpp))
        inline jlong take_sample() {
          return _gen->used();
        }