Sun Java Solaris Communities My SDN Account
 
Code sample

jvmstat 3.0

What's New
 

This is the new home for jvmstat technology.
 
 

The jvmstat technology adds light weight performance and configuration instrumentation to the HotSpot JVM and provides a set of monitoring APIs and tools for monitoring the performance of the HotSpot JVM in production environments. The instrumentation is designed such that it is 'always on', yet has negligible performance impact. The monitoring interfaces added to the HotSpot JVM are proprietary and may or may not be supported in future versions of the HotSpot JVM.
 

The instrumented HotSpot JVM ships with J2SE 1.4.2 and later, providing always-on instrumentation. The HotSpot JVM, verion 1.4.1, also includes the the instrumentation, but it must be enabled with the -XX:+UsePerfData flag.

As of J2SE 5.0 and later, a subset of the jvmstat tools is included with the JDK (jps, jstat, jstatd). The visualgc tool is not included with the J2SE 5.0 distribution, but is instead provided in this unbundled jvmstat 3.0 distribution.

The jvmstat tools included with J2SE 5.0, and the visualgc tool included with the jvmstat 3.0 distribution, are capable of monitoring Java applications running on HotSpot 1.4.1 and later JVMs. Only this distribution and a J2SE 5.0 JDK (or later) are needed to monitor any version of an instrumented HotSpot JVM. Therefore, jvmstat versions 1.1 and 2.0 will be discontinued.

Some features of the jvmstat tools require the existance of specific counter instances in the HotSpot JVM. Older HotSpot JVMs may not contain these specific counters. When encountering an older JVM, some features of the jvmstat tools may be disabled or warning messages may be issued.


Bundled Experimental JDK Tools and Utilities

You can use the following tools from the Java SE 6 JDK to monitor JVM performance and resource consumption. The tools described in this section are unsupported and experimental, and should be used with that in mind. They may not be available for future JDK versions.

Platform support:

  • jps, jstat, and jstatd: all platforms except Windows 98 and Windows ME.

Tool Name Brief Description
jps Experimental: JVM Process Status Tool - Lists instrumented HotSpot Java virtual machines on a target system. (formerly jvmps)
jstat Experimental: JVM Statistics Monitoring Tool - Attaches to an instrumented HotSpot Java virtual machine and collects and logs performance statistics as specified by the command line options. (formerly jvmstat)
jstatd Experimental: JVM jstat Daemon - Launches an RMI server application that monitors for the creation and termination of instrumented HotSpot Java virtual machines and provides a interface to allow remote monitoring tools to attach to Java virtual machines running on the local system. (formerly perfagent)

Unbundled Experimental JDK Tools and Utilities

You can use the following tools from the jvmstat 3.0 distribution to monitor JVM performance and resource consumption. The tools described in this section are unsupported and experimental, and should be used with that in mind. They may not be available for future JDK versions.

Platform support:

  • visualgc: all platforms except Windows 98 and Windows ME.

Tool Name Brief Description
visualgc Experimental: Visual Garbage Collection Monitoring Tool - a graphical tool for monitoring the HotSpot Garbage Collector, Compiler, and class loader. It can monitor both local and remote JVMs.


 

Click here to download jvmstat 3.0 (153616 bytes, build: b07, md5sum: 93c445dd89c824b5f67d36f12ccfc3b6 )
Download

 

This distribution of the jvmstat tools requires Java SE 5.0 (or later) with the HotSpot JVM. Before configuring and using the jvmstat tools, first download and install the Java SE 6 JDK for your operating environment. You must choose the JDK distribution as the class files needed by the monitoring tools are not included with the JRE. Once you have a working JDK installation, you are ready to install the jvmstat distribution. Follow the platform specific instructions for UNIX platforms and Windows platforms.

 

The instrumented HotSpot JVM exports a set of instrumentation objects, or counters as they are typically called. The set of counters exported by a JVM is not static, as a JVM may create certain counters only when appropriate arguments are specified on the command line. Furthermore, different versions of a JVM may export very different sets of instrumentation. The names of these counters and the data structures used to represent them are considered private, uncommitted interfaces to the HotSpot JVM. Users should not become dependent on any counter names, particularly those that start with prefixes other than "java.".

 

The jvmstat tools are officially unsupported. If you are expericencing a problem, please check the jvmstat FAQ for solutions. If you are still experiencing problems, or have additional questions, please send an email to jvmstat-support@sun.com.



Oracle is reviewing the Sun product roadmap and will provide guidance to customers in accordance with Oracle's standard product communication policies. Any resulting features and timing of release of such features as determined by Oracle's review of roadmaps, are at the sole discretion of Oracle. All product roadmap information, whether communicated by Sun Microsystems or by Oracle, does not represent a commitment to deliver any material, code, or functionality, and should not be relied upon in making purchasing decisions. It is intended for information purposes only, and may not be incorporated into any contract.