Meaning of the hs_gc profiler counters in JMH

garbage-collection, java, jmh

Solution

The Serviceability in HotSpot: HotSpot Jvmstat Performance Counters has the following warning about this:

The counters have structured names such as `sun.gc.generation.1.name`, `java.threads.live`, `java.cls.loadedClasses`. The names of these counters and the data structures used to represent them are considered private, uncommitted interfaces to the HotSpot JVM. Users should not become dependent on any counter names, particularly those that start with prefixes other than "java.".

Additional warning: all source code links below point to the specific hg.openjdk.java.net/jdk7u/jdk7u60 branch and the specific file revisions. The links themselves should work forever, but as the JVM evolves the new file versions can make information in this post obsolete.

The first source of information is the `jstat` documentation (jstat 8 unix docs, jstat 8 windows docs, jstat 7 docs). It provides a human-readable albeit short description for a lot of performance counters, for example:

FGC: Number of full GC events.

The second source of information is the `jstat` source code (jstat source code, jdk7u60 branch) and specifically its resource files: jstat_options and jstat_unsupported_options. For example, searching for `FGC` in `jstat_options` results in the following snippet:

column {
  header "^FGC^"    /* Full Collections */
  data sun.gc.collector.1.invocations
  align center
  width 5
  scale raw
  format "0"
}

Using `jstat_options` source code and `jstat` documentation it is possible to map most of internal counter names with prefixes `sun.gc.collector` and `sun.gc.generation` to human-readable descriptions or at least get some additional information from the comments inside `jstat_options` file.

Most of the counters with `sun.gc.policy` prefix are defined in gcPolicyCounters.cpp and gcAdaptivePolicyCounters.cpp and also in the GC-specific implementations (look for `somethingCounters.cpp` files in GC-specific folders located on the same level as shared folder) but i was not able to find human-readable descriptions for them.

I was not able to find where counters with `sun.gc.tlab` prefix are defined. Checking-out the full JDK source code and grepping it for relevant counter names should do the trick for those inclined to find everything.

Problem

Original source