Java Tool Tutorials - Herong's Tutorial Notes
Dr. Herong Yang, Version 5.11

'jstat' Command Options and Parameters

This section describes JVM statistics monitoring tool 'jstat' command and its command options and parameters.

"jstat": A JVM statistics monitoring tool that displays performance statistics of a given JVM process with a specified sampling interval. "jstat" tool is distributed as part of the Sun JDK package and represented by the \Progra~1\java\jdk1.6.0_02\bin\jstat.exe program file. "jstat" can be executed with the following syntax:

jstat [options] vmid interval [count]
  • "options" - List of "jstat" command options.
  • "vmid" - Virtual machine identifier string to identify a local or a remote JVM process.
  • "interval" - Sampling interval in seconds (s) or mimilliseconds (ms).
  • "count" - Number of samples to collect. Default value is infinity; that is, jstat displays statistics until the target JVM terminates or the jstat command is terminated.

Some "jstat" options are listed below:

  • "-t" - Display a timestamp column as the first column of output. The timestamp is the the time since the start time of the target JVM.
  • "-class" - Display multiple columns of statistics on the behavior of the class loader.
  • "-compiler" - Display multiple columns of statistics of the behavior of the HotSpot Just-in-Time compiler.
  • "-gc" - Display multiple columns of statistics of the behavior of the garbage collected heap.
  • "-gcutil" - Display multiple columns of summary of garbage collection statistics.
  • "-gccapacity" - Display multiple columns of statistics of the capacities of the generations and their corresponding spaces.

See the next section on how to use "jstat" to collect statistic samples of a given JVM process.

Sections in This Chapter

'jps' - JVM Process Status Tool

Listing JVM Processes on the Local Machine with "jps"

'jstatd' - JVM Remote Monitoring Server

Starting 'jstatd' with a Security Policy File

Connecting to 'jps' to Remote 'jstatd'

'jstat' Command Options and Parameters

Garbage Collection Testing Program

'jstat -gcutil' - Garbage Collection Statistics

Accessing Remote JVM Processes with 'jstat'

Dr. Herong Yang, updated in 2008
'jstat' Command Options and Parameters