.\" Automatically generated by Pandoc 2.3.1
.\"
.TH "JCONSOLE" "1" "2024" "JDK 17.0.12" "JDK Commands"
.hy
.SH NAME
.PP
jconsole \- start a graphical console to monitor and manage Java
applications
.SH SYNOPSIS
.PP
\f[CB]jconsole\f[R] [\f[CB]\-interval=\f[R]\f[I]n\f[R]] [\f[CB]\-notile\f[R]]
[\f[CB]\-plugin\f[R] \f[I]path\f[R]] [\f[CB]\-version\f[R]]
[\f[I]connection\f[R] ...
] [\f[CB]\-J\f[R]\f[I]input_arguments\f[R]]
.PP
\f[CB]jconsole\f[R] \f[CB]\-help\f[R]
.SH OPTIONS
.TP
.B \f[CB]\-interval\f[R]
Sets the update interval to \f[CB]n\f[R] seconds (default is 4 seconds).
.RS
.RE
.TP
.B \f[CB]\-notile\f[R]
Doesn\[aq]t tile the windows for two or more connections.
.RS
.RE
.TP
.B \f[CB]\-pluginpath\f[R] \f[I]path\f[R]
Specifies the path that \f[CB]jconsole\f[R] uses to look up plug\-ins.
The plug\-in \f[I]path\f[R] should contain a provider\-configuration file
named \f[CB]META\-INF/services/com.sun.tools.jconsole.JConsolePlugin\f[R]
that contains one line for each plug\-in.
The line specifies the fully qualified class name of the class
implementing the \f[CB]com.sun.tools.jconsole.JConsolePlugin\f[R] class.
.RS
.RE
.TP
.B \f[CB]\-version\f[R]
Prints the program version.
.RS
.RE
.TP
.B \f[I]connection\f[R] = \f[I]pid\f[R] | \f[I]host\f[R]\f[CB]:\f[R]\f[I]port\f[R] | \f[I]jmxURL\f[R]
A connection is described by either \f[I]pid\f[R],
\f[I]host\f[R]\f[CB]:\f[R]\f[I]port\f[R] or \f[I]jmxURL\f[R].
.RS
.IP \[bu] 2
The \f[I]pid\f[R] value is the process ID of a target process.
The JVM must be running with the same user ID as the user ID running the
\f[CB]jconsole\f[R] command.
.IP \[bu] 2
The \f[I]host\f[R]\f[CB]:\f[R]\f[I]port\f[R] values are the name of the host
system on which the JVM is running, and the port number specified by the
system property \f[CB]com.sun.management.jmxremote.port\f[R] when the JVM
was started.
.IP \[bu] 2
The \f[I]jmxUrl\f[R] value is the address of the JMX agent to be
connected to as described in JMXServiceURL.
.RE
.TP
.B \f[CB]\-J\f[R]\f[I]input_arguments\f[R]
Passes \f[I]input_arguments\f[R] to the JVM on which the
\f[CB]jconsole\f[R] command is run.
.RS
.RE
.TP
.B \f[CB]\-help\f[R] or \f[CB]\-\-help\f[R]
Displays the help message for the command.
.RS
.RE
.SH DESCRIPTION
.PP
The \f[CB]jconsole\f[R] command starts a graphical console tool that lets
you monitor and manage Java applications and virtual machines on a local
or remote machine.
.PP
On Windows, the \f[CB]jconsole\f[R] command doesn\[aq]t associate with a
console window.
It does, however, display a dialog box with error information when the
\f[CB]jconsole\f[R] command fails.