HP (Hewlett-Packard) 5992-1918 Manual Do Utilizador

example, the following file names are created: java_27298.hprof.1152743593943 and
java_27298_060712_153313_heapDump.hprof.txt

.

If JAVA_BINARY_HEAPDUMP is set and the -Xrunhprof:heap=dump command is given, then
both hprof ASCII and binary files are produced for this option.

1.27.3 -XX:+HeapDumpOnOutOfMemoryError

The-XX:+HeapDumpOnOutOfMemoryError option is available beginning with SDK 1.4.2.11
and JDK 1.5.0.04. This option enables dumping of the Java heap when an “Out Of Memory” error
condition occurs in the Java VM. The heap dump file name defaults to java_pid<pid>.hprof
in the current working directory. The option -XX:HeapDumpPath=file may be used to specify
the heap dump file name or a directory where the heap dump file should be created. The only
heap dump format generated by the -XX:+HeapDumpOnOutOfMemoryError option is the
hprof binary format.

One known issue exists: the-XX:+HeapDumpOnOutOfMemoryError option does not work with
the low-pause collector (option -XX:+UseConcMarkSweepGC).

1.27.4 -XX:+HeapDumpOnly

Starting with SDK 1.4.2.11 and JDK 1.5.0.05, the -XX:+HeapDumpOnly option or the
_JAVA_HEAPDUMP_ONLY

environment variable can be used to enable heap dumps using the

SIGVTALRM signal (signal 20). This interface is provided to separate the generation of thread
and trace information triggered via SIGQUIT from the heap dump information. If
the-XX:+HeapDumpOnly option is specified or the _JAVA_HEAPDUMP_ONLY environment
variable is set, then the heap dump functionality is triggered by sending SIGVTALRM to the
process. The printing of thread and trace information to stdout is suppressed.

The heap dump is written to a file with the following filename format:
java_<pid>_<date>_<time>_heapDump.hprof.txt

.

The default output format is ASCII. The output format can be changed to hprof binary format
by setting the _JAVA_BINARY_HEAPDUMP environment variable. This environment variable can
also be used with the -XX:+HeapDump option to generate hprof binary format with the SIGQUIT
signal.

1.27.5 Using Heap Dumps to Monitor Memory Usage

By creating a series of heap dump snapshots, you can see how the number and size of objects
varies over time. It is a good idea to collect at least three snapshots. The first one serves as a
baseline. It should be taken after the application has finished initializing and has been running
for a short time. The second snapshot should be taken after the residual heap size has grown
significantly. Monitor this using

and

. Try to take the last snapshot just

before the heap has grown to a point where it causes problems resulting in the application
spending the majority of its time doing full GCs. If you take other snapshots, spread them out
evenly based on residual heap size throughout the running of the application.

Once you have collected the snapshots, read them into

(run with

to

monitor memory usage). Use small heap sizes so that the analysis with HPjmeter requires less
memory. Read two files in and compare them using the File->Compare option. You should
be able to find out the types of objects that are accumulating in the Java heap. Select a type using
the Mark to Find option and go back to a view of one of the snapshots. Go to the
Metric->Call Graph Tree

option and do a Find. You should be able to see the context of

the object retention.

1.28 -XX:OnError

When a fatal error occurs, the Java VM can optionally execute a user-supplied script or command.
The script or command is specified using the -XX:OnError:<string> command-line option,

1.28 -XX:OnError

49