Skip to main content


IBM Monitoring and Diagnostic Tools for Java - Diagnostics Collector

 Downloadable files
 
Abstract
The Diagnostics Collector gathers documentation and diagnostic data associated with Java™ Virtual Machine (JVM) problems. At JVM start up it runs a Diagnostic Configuration Check.
 
Download Description
The JVM automatically starts the Diagnostics Collector after detecting a runtime problem and producing diagnostic data. The Diagnostics Collector gathers diagnostic data files produced by the JVM and stores them in a single zip file.

If a system dump is produced, the Diagnostics Collector runs jextract on the dump and collects the jextract output. There is an option to disable this behaviour if jextract is not required. All actions are logged in a text file, which is also copied into the output zip file.

The Diagnostics Collector gathers system dumps, Javadumps, heap dumps, verbose GC log (if present) and JVM trace files that match the timestamp for the Java problem that caused the collector to start. The Diagnostics Collector copies the diagnostic files it finds into a single output zip file. The output file is named using the type of problem that occurred, the timestamp of the problem event and the process ID of the Java application, for example:
java.gpf.20081219.105104.9221.zip

At JVM start up, the Diagnostics Collector runs a Diagnostic Configuration Check. It checks for any settings that disable Java diagnostics. If any are found, a warning is printed on stderr and in the JavaDiagnosticsCollector.log file. Fix the settings identified by any warning messages before restarting your Java application. Fixing warnings makes it more likely that the right data is available for IBM Support to diagnose a Java problem.

The UserGuide.txt file in the download package gives more detailed information.
 
Prerequisites
IBM SDK for Java version 5.0 or version 6.0
 
 
Installation Instructions
These instructions apply to Java 6 up to and including SR5, and to Java 5 up to and including SR10. If you are using a newer Java version, refer to the Diagnostic Guide (http://www.ibm.com/developerworks/java/jdk/diagnosis/) for instructions on how to enable the Diagnostics Collector.
To enable the Diagnostics Collector for Java 6 up to and including SR5, or Java 5 up to and including SR10:
  1. Choose an install directory that is accessible to the user id that your Java application runs with.
  2. Create the install directory if necessary.
  3. Copy the download package to the install directory.a
  4. Unzip the download package:
    unzip JavaDiagnosticsCollector_v1.0.zip
  5. Ensure the user id that your Java application runs with has read permission for the installed files.

Configuration Instructions
  1. Edit the options file:
    java_dc_options.txt
    Replace the string <INSTALL_DIR> in the options file with the path to the directory where you installed the package.
  2. In your Java application runtime configuration, add the following java command line option to enable the Java Diagnostics Collector:
    -Xoptionsfile=<INSTALL_DIR>/java_dc_options.txt
    Again, replace <INSTALL DIR> with the path to the directory where you unzipped the package.

    If you already use a -Xoptionsfile setting, add the contents of java_dc_options.txt to your existing java options file.
 
Download package
Download RELEASE DATE LANGUAGE SIZE(Bytes) Download Options
DC Download v1.028/09/2009English109619FTP
 
Technical support
Send email to javatool@uk.ibm.com for Technical Support and Queries.
 
  

Copyright and trademark information

IBM, the IBM logo and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.

Rate this page

Please take a moment to complete this form to help us better serve you.

This material provides me with the information I need.






This material is clear and easy to understand.






Did the information help you to achieve your goal?

What updates, improvements, or related information would you like to see in this document?

Your response will be used to improve our document content. Requests for assistance, if applicable, should be submitted through your normal support channel as we cannot respond from this site.

Input the verification number to submit feedback:


Close [x]

Maintenance Window

  • The IBM Technical support pages, including the Downloads and Drivers Finders will be temporarily unavailable for up to 2 hours due to planned maintenance. This will take place between Saturday December 5, 2009 9:00 PM ET and Sunday, December 6, 2009 4:30 AM ET. During the maintenance, you will not be able to search or download from these pages.

Close [x]

Unscheduled Maintenance Window

There is no unscheduled maintenance scheduled at this time.

Document information

Product categories:

Software

Application Servers

Distributed Application Support

Runtimes for Java Technology

Java SDK

Operating system(s):

AIX, Linux, Windows, z/OS

Software version:

5.0, 6.0

Software edition:

J2SE

Reference #:

4019419

IBM Group:

Software Group

Modified date:

2008-07-21

Translate my page

Rate this page

Availability Notices