com.oracle.graal.hotspot.debug

Class BenchmarkCounters

java.lang.Object

com.oracle.graal.hotspot.debug.BenchmarkCounters

public class BenchmarkCounters
extends Object

This class contains infrastructure to maintain counters based on DynamicCounterNodes. The infrastructure is enabled by specifying either the GenericDynamicCounters or BenchmarkDynamicCounters option.

The counters are kept in a special area allocated for each native JavaThread object, and the number of counters is configured using -XX:GraalCounterSize=value. -XX:+/-GraalCountersExcludeCompiler configures whether to exclude compiler threads (defaults to true). The subsystems that use the logging need to have their own options to turn on the counters, and insert DynamicCounterNodes when they're enabled. Counters will be displayed as a rate (per second) if their group name starts with "~", otherwise they will be displayed as a total number.

Example

In order to create statistics about allocations within the DaCapo pmd benchmark the following steps are necessary:

• Set -XX:GraalCounterSize=value. The actual required value depends on the granularity of the profiling, 10000 should be enough for most cases.
• Also: -XX:+/-GraalCountersExcludeCompiler specifies whether the numbers generated by compiler threads should be excluded (default: true).
• Start the DaCapo pmd benchmark with "-G:BenchmarkDynamicCounters=err, starting ====, PASSED in " and -G:+ProfileAllocations.
• The numbers will only include allocation from compiled code!
• The counters can be further configured by modifying the NewObjectSnippets.PROFILE_MODE field.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	BenchmarkCounters.CallbackOutputStream
private static class	BenchmarkCounters.Counter
(package private) static class	BenchmarkCounters.Options

Field Summary

Fields

Modifier and Type	Field and Description
static ConcurrentHashMap<String,BenchmarkCounters.Counter>	counterMap
static long[]	delta
private static boolean	DUMP_STATIC
static boolean	enabled

Constructor Summary

Constructors

Constructor and Description
BenchmarkCounters()

Method Summary

Modifier and Type	Method and Description
private static void	clear(long[] counters)
private static void	dump(PrintStream out, double seconds, long[] counters, int maxRows)
private static void	dumpComputerReadable(PrintStream out, boolean staticCounter, String group, long[] array, Set<Map.Entry<String,BenchmarkCounters.Counter>> counterEntrySet)
private static void	dumpCounters(PrintStream out, double seconds, long[] counters, boolean staticCounter, String group, int maxRows)
private static void	dumpHumanReadable(PrintStream out, double seconds, boolean staticCounter, String group, int maxRows, long[] array, Set<Map.Entry<String,BenchmarkCounters.Counter>> counterEntrySet)
private static BenchmarkCounters.Counter	getCounter(String name, String group, HotSpotVMConfig config)
static int	getIndex(String name, String group, HotSpotVMConfig config)
static int	getIndexConstantIncrement(String name, String group, HotSpotVMConfig config, long increment)
private static String	getName(String nameGroup, String group)
static void	initialize(CompilerToVM compilerToVM)
private static long	percentage(long counter, long sum)
static void	shutdown(CompilerToVM compilerToVM, long compilerStartTime)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DUMP_STATIC

private static final boolean DUMP_STATIC

See Also:

Constant Field Values

enabled

public static boolean enabled

counterMap

public static final ConcurrentHashMap<String,BenchmarkCounters.Counter> counterMap

delta

public static long[] delta

Constructor Detail

BenchmarkCounters

public BenchmarkCounters()

Method Detail

getIndexConstantIncrement

public static int getIndexConstantIncrement(String name,
                                            String group,
                                            HotSpotVMConfig config,
                                            long increment)

getIndex

public static int getIndex(String name,
                           String group,
                           HotSpotVMConfig config)

getCounter

private static BenchmarkCounters.Counter getCounter(String name,
                                                    String group,
                                                    HotSpotVMConfig config)
                                             throws JVMCIError

Throws:

JVMCIError

dump

private static void dump(PrintStream out,
                         double seconds,
                         long[] counters,
                         int maxRows)

clear

private static void clear(long[] counters)

dumpCounters

private static void dumpCounters(PrintStream out,
                                 double seconds,
                                 long[] counters,
                                 boolean staticCounter,
                                 String group,
                                 int maxRows)

getName

private static String getName(String nameGroup,
                              String group)

dumpHumanReadable

private static void dumpHumanReadable(PrintStream out,
                                      double seconds,
                                      boolean staticCounter,
                                      String group,
                                      int maxRows,
                                      long[] array,
                                      Set<Map.Entry<String,BenchmarkCounters.Counter>> counterEntrySet)

dumpComputerReadable

private static void dumpComputerReadable(PrintStream out,
                                         boolean staticCounter,
                                         String group,
                                         long[] array,
                                         Set<Map.Entry<String,BenchmarkCounters.Counter>> counterEntrySet)

percentage

private static long percentage(long counter,
                               long sum)

initialize

public static void initialize(CompilerToVM compilerToVM)

shutdown

public static void shutdown(CompilerToVM compilerToVM,
                            long compilerStartTime)