This tutorial will cover the basics of the G1 (Garbage First) collector.
Garbage-First is a server-style garbage collector, targeted for mufti-processors with large memories, that meets a soft real-time goal
with high probability [Detlefs04]. It does this while also achieving
high throughput, which is an important point when comparing it to other
real-time collectors.
The G1 garbage collector is fully supported in Oracle JDK 7 update 4 and later releases. The G1 collector is designed for applications that:
Can operate concurrently with applications threads like the CMS collector.
Compact free space without lengthy GC induced pause times.
Need more predictable GC pause durations.
Do not want to sacrifice a lot of throughput performance.
Do not require a much larger Java heap.
G1 is the replacement for the Concurrent Mark-Sweep
Collector (CMS). Comparing G1 with CMS, there are differences that make
G1 a better solution. One difference is that G1 is a compacting
collector. G1 compacts sufficiently to completely avoid the use of
fine-grained free lists for allocation, and instead relies on regions.
This considerably simplifies parts of the collector, and mostly
eliminates potential fragmentation issues. Also, G1 offers more
predictable garbage collection pauses than the CMS collector, and allows
users to specify desired pause targets.
How does the G1 work:
The older garbage collectors (serial, parallel, CMS) all
structure the heap into three sections: young generation, old
generation, and permanent generation of a fixed memory size.
The G1 collector takes a different approach The heap is partitioned into a set of equal-sized heap regions, each a contiguous range of virtual memory
(see Figure 1). In the strictest sense, the heap doesn't contain
generational areas, although a subset of the regions can be treated as
such. This provides flexibility in how garbage collection is performed,
which is adjusted on-the-fly according to the amount of processor time
available to the collector.
Figure 1
As shown above the regions are again broken down into 512 byte sections called cards (see Figure 2). Each
card has a corresponding one-byte entry in a global card table, which is
used to track which cards are modified by mutator threads. Subsets of
these cards are tracked, and referred to as Remembered Sets (RS).
Figure 2
When performing garbage collections, G1 operates in a manner
similar to the CMS collector. G1 performs a concurrent global marking
phase to determine the liveness of objects throughout the heap. After
the mark phase completes, G1 knows which regions are mostly empty. It
collects in these regions first, which usually yields a large amount of
free space. As the name suggests, G1 concentrates its collection and
compaction activity on the areas of the heap that are likely to be full
of reclaimable objects, that is, garbage. G1 uses a pause prediction
model to meet a user-defined pause time target and selects the number of
regions to collect based on the specified pause time target.
The regions identified by G1 as ripe for reclamation are garbage
collected using evacuation. G1 copies objects from one or more regions
of the heap to a single region on the heap, and in the process both
compacts and frees up memory. This evacuation is performed in parallel
on multi-processors, to decrease pause times and increase throughput.
Thus, with each garbage collection, G1 continuously works to reduce
fragmentation, working within the user defined pause times. This is
beyond the capability of both the previous methods. CMS (Concurrent Mark
Sweep ) garbage collector does not do compaction. ParallelOld garbage
collection performs only whole-heap compaction, which results in
considerable pause times.
It is important to note that G1 is not a real-time collector. It
meets the set pause time target with high probability but not absolute
certainty. Based on data from previous collections, G1 does an estimate
of how many regions can be collected within the user specified target
time. Thus, the collector has a reasonably accurate model of the cost of
collecting the regions, and it uses this model to determine which and
how many regions to collect while staying within the pause time target.
Note: G1 has both concurrent (runs along with application
threads, e.g., refinement, marking, cleanup) and parallel
(multi-threaded, e.g., stop the world) phases. Full garbage collections
are still single threaded, but if tuned properly your applications
should avoid full GCs.
Step by step process of G1
G1 Heap Structure
The heap is one memory area split into many fixed sized regions.
Region size is chosen by the JVM at startup. The JVM generally targets around 2000 regions varying in size from 1 to 32Mb. G1 Heap Allocation
In reality, these regions are mapped into logical representations of Eden, Survivor, and old generation spaces.
The colors in the picture shows which region is associated
with which role. Live objects are evacuated (i.e., copied or moved) from
one region to another. Regions are designed to be collected in parallel
with or without stopping all other application threads.
As shown regions can be allocated into Eden, survivor, and
old generation regions. In addition, there is a fourth type of object
known as Humongous regions. These regions are designed to hold objects
that are 50% the size of a standard region or larger. They are stored as
a set of contiguous regions. Finally the last type of regions would
be the unused areas of the heap. Note: At the time of this writing, collecting
humongous objects has not been optimized. Therefore, you should avoid
creating objects of this size.
Young Generation in G1
The heap is split into approximately 2000 regions. Minimum
size is 1Mb and maximum size is 32Mb. Blue regions hold old generation
objects and green regions hold young generation objects.
Note that the regions are not required to be contiguous like the older garbage collectors. A Young GC in G1
Live objects are evacuated (i.e., copied or moved) to one or
more survivor regions. If the aging threshold is met, some of the
objects are promoted to old generation regions.
This is a stop the world (STW) pause. Eden size and survivor
size is calculated for the next young GC. Accounting information is kept
to help calculate the size. Things like the pause time goal are taken
into consideration.
This approach makes it very easy to resize regions, making them bigger or smaller as needed.
End of a Young GC with G1
Live objects have been evacuated to survivor regions or to old generation regions.
Recently promoted objects are shown in dark blue. Survivor regions in green.
In summary, the following can be said about the young generation in G1:
The heap is a single memory space split into regions.
Young generation memory is composed of a set of non-contiguous regions. This makes it easy to resize when needed.
Young generation garbage collections, or young GCs, are
stop the world events. All application threads are stopped for the
operation.
The young GC is done in parallel using multiple threads.
Live objects are copied to new survivor or old generation regions.
Old Generation Collection with G1
Like the CMS collector, the G1 collector is designed to be a low
pause collector for old generation objects. The following table
describes the G1 collection phases on old generation.
The G1 collector performs the following phases on the old
generation of the heap. Note that some phases are part of a young
generation collection.
Phase
Description
(1) Initial Mark (Stop the World Event)
This is a stop the world event. With G1, it is piggybacked on a
normal young GC. Mark survivor regions (root regions) which may have
references to objects in old generation.
(2) Root Region Scanning
Scan survivor regions for references into the old generation.
This happens while the application continues to run. The phase must be
completed before a young GC can occur.
(3) Concurrent Marking
Find live objects over the entire heap. This happens while the
application is running. This phase can be interrupted by young
generation garbage collections.
(4) Remark (Stop the World Event)
Completes the marking of live object in the heap. Uses an
algorithm called snapshot-at-the-beginning (SATB) which is much faster
than what was used in the CMS collector.
(5) Cleanup (Stop the World Event and Concurrent)
Performs accounting on live objects and completely free regions. (Stop the world)
Scrubs the Remembered Sets. (Stop the world)
Reset the empty regions and return them to the free list. (Concurrent)
(*) Copying (Stop the World Event)
These are the stop the world pauses to evacuate
or copy live objects to new unused regions. This can be done with young
generation regions which are logged as [GC pause (young)]. Or both young and old generation regions which are logged as [GC Pause (mixed)].
G1 Old Generation Collection Step by Step
With the phases defined, let's look at how they interact with the old generation in the G1 collector. Initial Marking Phase
Initial marking of live object is piggybacked on a young generation garbage collection. In the logs this is noted as GC pause (young)(inital-mark).
Concurrent Marking Phase
If empty regions are found (as denoted by the "X"), they are
removed immediately in the Remark phase. Also, "accounting" information
that determines liveness is calculated.
Remark Phase
Empty regions are removed and reclaimed. Region liveness is now calculated for all regions.
Copying/Cleanup Phase
G1 selects the regions with the lowest "liveness", those
regions which can be collected the fastest. Then those regions are
collected at the same time as a young GC. This is denoted in the logs as
[GC pause (mixed)]. So both young and old generations are collected at the same time.
After Copying/Cleanup Phase
The regions selected have been collected and compacted into the dark blue region and the dark green region shown in the diagram.
Summary of Old Generation GC
In summary, there are a few key points we can make about the G1 garbage collection on the old generation.
Concurrent Marking Phase
Liveness information is calculated concurrently while the application is running.
This liveness information identifies which regions will be best to reclaim during an evacuation pause.
First, since this is the beginning of a new collection, the current
marking bitmap is copied to the previous marking bitmap, and then the
current marking bitmap is cleared.
Next, all mutator threads are paused while the current TAMS
pointer is moved to point to the same byte in the region as the top
(next free byte) pointer.
Next, all objects are traced from their roots, and live objects
are marked in the marking bitmap. We now have a snapshot of the heap.
Next, all mutator threads are resumed.
Next, a write buffer is inserted for all mutator threads. This
barrier records all new object allocations that take place after the
snapshot into change buffers.
Remark Phase
Uses the Snapshot-at-the-Beginning (SATB) algorithm which is much faster then what was used with CMS.
When all filled buffers have been processed, the mutator threads are paused.
Next, the remaining (partially filled) buffers are processed, and those objects are marked also.
Completely empty regions are reclaimed.
Copying/Cleanup Phase
Next, all mutator threads are paused.
Next, all live-object counts are finalized per region.
The TAMS pointer for the current collection is copied to the
previous TAMS pointer (since the current collection is basically
complete).
The heap regions are sorted for collection priority according
to a cost algorithm. As a result, the regions that will yield the
highest numbers of reclaimed objects, at the smallest cost in terms of
time, will be collected first. This forms what is called a collection
set of regions.
All mutator threads are resumed.
Command Line options
In this section let's take a look at the various command line options for G1.
Basic Command Line
To enable the G1 Collector use: -XX:+UseG1GC
Here is a sample command line for starting the Java2Demo included in the JDK demos and samples download: java -Xmx50m -Xms50m -XX:+UseG1GC -XX:MaxGCPauseMillis=200 -jar c:\javademos\demo\jfc\Java2D\Java2demo.jar
Key Command Line Switches
-XX:+UseG1GC - Tells the JVM to use the G1 Garbage collector.
-XX:MaxGCPauseMillis=200 - Sets a target for the maximum
GC pause time. This is a soft goal, and the JVM will make its best
effort to achieve it. Therefore, the pause time goal will sometimes not
be met.
The default value is 200 milliseconds. -XX:InitiatingHeapOccupancyPercent=45 - Percentage of
the (entire) heap occupancy to start a concurrent GC cycle. It is used
by G1 to trigger a concurrent GC cycle based on the occupancy of the
entire heap, not just one of the generations. A value of 0 denotes 'do
constant GC cycles'. The default value is 45 (i.e., 45% full or
occupied).
Best Practices
There are a few best practices you should follow when using G1. Do not Set Young Generation Size
Explicitly setting young generation size via -Xmn meddles with the default behavior of the G1 collector.
G1 will no longer respect the pause time target for
collections. So in essence, setting the young generation size disables
the pause time goal.
G1 is no longer able to expand and contract the young
generation space as needed. Since the size is fixed, no changes can be
made to the size.
Response Time Metrics
Instead of using average response time (ART) as a metric to set the XX:MaxGCPauseMillis=<N>,
consider setting value that will meet the goal 90% of the time or more.
This means 90% of users making a request will not experience a response
time higher than the goal. Remember, the pause time is a goal and is
not guaranteed to always be met.
What is an Evacuation Failure?
A promotion failure that happens when a JVM runs out of heap
regions during the GC for either survivors and promoted objects. The
heap can't expand because it is already at max. This is indicated in the
GC logs when using -XX:+PrintGCDetails by to-space overflow. This is expensive!
GC still has to continue so space has to be freed up.
Unsuccessfully copied objects have to be tenured in place.
Any updates to RSets of regions in the CSet have to be regenerated.
All of these steps are expensive.
How to avoid Evacuation Failure
To avoid evacuation failure, consider the following options.
Increase heap size
Increase the -XX:G1ReservePercent=n, the default is 10.
G1 creates a false ceiling by trying to leave the reserve memory free in case more 'to-space' is desired.
Start the marking cycle earlier
Increase the number of marking threads using the -XX:ConcGCThreads=n option.
Complete List of G1 GC Switches
This is the complete list of G1 GC switches. Remember to use the best practices outlined above.
Option and Default Value
Description
-XX:+UseG1GC
Use the Garbage First (G1) Collector
-XX:MaxGCPauseMillis=n
Sets a target for the maximum GC pause time. This is a soft goal, and the JVM will make its best effort to achieve it.
-XX:InitiatingHeapOccupancyPercent=n
Percentage of the (entire) heap occupancy to start a
concurrent GC cycle. It is used by GCs that trigger a concurrent GC
cycle based on the occupancy of the entire heap, not just one of the
generations (e.g., G1). A value of 0 denotes 'do constant GC cycles'.
The default value is 45.
-XX:NewRatio=n
Ratio of new/old generation sizes. The default value is 2.
-XX:SurvivorRatio=n
Ratio of eden/survivor space size. The default value is 8.
-XX:MaxTenuringThreshold=n
Maximum value for tenuring threshold. The default value is 15.
-XX:ParallelGCThreads=n
Sets the number of threads used during parallel
phases of the garbage collectors. The default value varies with the
platform on which the JVM is running.
-XX:ConcGCThreads=n
Number of threads concurrent garbage collectors
will use. The default value varies with the platform on which the JVM is
running.
-XX:G1ReservePercent=n
Sets the amount of heap that is reserved as a false
ceiling to reduce the possibility of promotion failure. The default
value is 10.
-XX:G1HeapRegionSize=n
With G1 the Java heap is subdivided into uniformly
sized regions. This sets the size of the individual sub-divisions. The
default value of this parameter is determined ergonomically based upon
heap size. The minimum value is 1Mb and the maximum value is 32Mb.
Logging GC with G1
Logging GC with G1
The final topic we need to cover is using logging information to
analyze performance with the G1 collector. This section provides a quick
overview of the switches you can use to collect data and the
information that is printed in the logs.
Setting the Log Detail
You can set the detail to three different levels of detail. (1) -verbosegc (which is equivalent to -XX:+PrintGC) sets the detail level of the log to fine. Sample Output
(3) -XX:+UnlockExperimentalVMOptions -XX:G1LogLevel=finest sets the detail level to its finest. Like finer but includes individual worker thread information.
A couple of switches determine how time is displayed in the GC log. (1) -XX:+PrintGCTimeStamps - Shows the elapsed time since the JVM started. Sample Output
To understand the log, this section defines a number of terms
using actual GC log output. The following examples show output from the
log with explanations of the terms and values you will find in it.
Parallel Time – Overall elapsed time of the main parallel part of the pause Worker Start – Timestamp at which the workers start Note: The logs are ordered on thread id and are consistent on each entry
External Root Scanning
External root scanning - The time taken to scan the external root (e.g., things like system dictionary that point into the heap.) Update Remembered Set
Update Remembered Set - Any buffers that are completed but have not yet been processed by the concurrent refinement thread before the start of the
pause have to be updated. Time depends on density of the cards. The more cards, the longer it will take.
Scanning Remembered Sets
Termination time - When a worker thread is finished with its
particular set of objects to copy and scan, it enters the termination
protocol. It looks for work to steal and once it's done with that work
it again enters the termination protocol. Termination attempt counts all
the attempts to steal work. GC Worker End
GC worker other – The time (for each GC thread) that can't
be attributed to the worker phases listed previously. Should be quite
low. In the past, we have seen excessively high values and they have
been attributed to bottlenecks in other parts of the JVM (e.g.,
increases in the Code Cache occupancy with Tiered).
Clear CT
[Clear CT: 0.6 ms]
Time taken to clear the card table of RSet scanning meta-data
Other
[Other: 6.8 ms]
Time taken for various other sequential phases of the GC pause. CSet
[Choose CSet: 0.1 ms]
Time taken finalizing the set of regions to collect. Usually very small; slightly longer when having to select old. Ref Proc
[Ref Proc: 4.4 ms]
Time spent processing soft, weak, etc. references deferred from the prior phases of the GC. Ref Enq
[Ref Enq: 0.1 ms]
Time spent placing soft, weak, etc. references on to the pending list. Free CSet
[Free CSet: 2.0 ms]
Time spent freeing the set of regions that have just been collected, including their remembered sets.