com.oracle.graal.compiler.test

Class AllocSpy

java.lang.Object

com.oracle.graal.compiler.test.AllocSpy

All Implemented Interfaces:

AutoCloseable

public final class AllocSpy
extends Object
implements AutoCloseable

Tool for analyzing allocations within a scope using the Java Allocation Instrumenter. Allocation records are aggregated per stack trace at an allocation site. The size of the stack trace is governed by the value of the "AllocSpy.ContextSize" system property (default is 5).

Using this facility requires using -javaagent on the command line. For example:

 mx --vm server unittest -javaagent:lib/java-allocation-instrumenter.jar -dsa -DAllocSpy.ContextSize=6 BC_iadd2
 

See Also:

SampleBytes, SampleInstances, HistogramLimit, NameSize, BarSize, NumberSize

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
(package private) static class	AllocSpy.CountedValue A value and a frequency.
(package private) static class	AllocSpy.GraalContextSampler

Field Summary

Fields

Modifier and Type	Field and Description
private static int	BarSize The width of the histogram bar column.
(package private) Map<String,AllocSpy.CountedValue>	bytesPerGraalContext
private static int	ContextSize The size of context to record for each allocation site in terms of Graal frames.
(package private) static ThreadLocal<AllocSpy>	current
private static boolean	ENABLED
private static String[]	Excluded
private static int	HistogramLimit Only the HistogramLimit most frequent values are printed.
(package private) Map<String,AllocSpy.CountedValue>	instancesPerGraalContext
(package private) Object	name
private static int	NameSize The width of the allocation context column.
private static int	NumberSize The width of the frequency column.
(package private) AllocSpy	parent
private static boolean	SampleBytes Determines if bytes per allocation site are recorded.
private static boolean	SampleInstances Determines if allocations per allocation site are recorded.

Constructor Summary

Constructors

Modifier	Constructor and Description
private	AllocSpy(Object name)

Method Summary

Modifier and Type	Method and Description
(package private) AllocSpy.CountedValue	bytesPerGraalContext(String context)
void	close()
private static boolean	excludeFrame(String className)
protected static AllocSpy.CountedValue	getCounter(String desc, Map<String,AllocSpy.CountedValue> map)
(package private) AllocSpy.CountedValue	instancesPerGraalContext(String context)
static boolean	isEnabled()
static AllocSpy	open(Object name)
private static void	print(PrintStream ps, Map<String,AllocSpy.CountedValue> map, String name, int limit, int nameSize, int barSize)
private static void	printLine(PrintStream printStream, char c, int lineSize)
(package private) static String	prop(String sfx)

Methods inherited from class java.lang.Object

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

Field Detail

current

static ThreadLocal<AllocSpy> current

ENABLED

private static final boolean ENABLED

SampleBytes

private static final boolean SampleBytes

Determines if bytes per allocation site are recorded.

SampleInstances

private static final boolean SampleInstances

Determines if allocations per allocation site are recorded.

ContextSize

private static final int ContextSize

The size of context to record for each allocation site in terms of Graal frames.

HistogramLimit

private static final int HistogramLimit

Only the HistogramLimit most frequent values are printed.

NameSize

private static final int NameSize

The width of the allocation context column.

BarSize

private static final int BarSize

The width of the histogram bar column.

NumberSize

private static final int NumberSize

The width of the frequency column.

name

final Object name

parent

final AllocSpy parent

bytesPerGraalContext

final Map<String,AllocSpy.CountedValue> bytesPerGraalContext

instancesPerGraalContext

final Map<String,AllocSpy.CountedValue> instancesPerGraalContext

Excluded

private static final String[] Excluded

Constructor Detail

AllocSpy

private AllocSpy(Object name)

Method Detail

isEnabled

public static boolean isEnabled()

prop

static String prop(String sfx)

open

public static AllocSpy open(Object name)

close

public void close()

Specified by:

close in interface AutoCloseable

printLine

private static void printLine(PrintStream printStream,
                              char c,
                              int lineSize)

print

private static void print(PrintStream ps,
                          Map<String,AllocSpy.CountedValue> map,
                          String name,
                          int limit,
                          int nameSize,
                          int barSize)

bytesPerGraalContext

AllocSpy.CountedValue bytesPerGraalContext(String context)

instancesPerGraalContext

AllocSpy.CountedValue instancesPerGraalContext(String context)

getCounter

protected static AllocSpy.CountedValue getCounter(String desc,
                                                  Map<String,AllocSpy.CountedValue> map)

excludeFrame

private static boolean excludeFrame(String className)