The Java Tutorials have been written for JDK 8. Examples and practices described in this page don't take advantage of improvements introduced in later releases and might use technology no longer available.
See Java Language Changes for a summary of updated language features in Java SE 9 and subsequent releases.
See JDK Release Notes for information about new features, enhancements, and removed or deprecated options for all JDK releases.
Exposing your Java applications for remote management by using the JMX API can be extremely simple, if you use the out-of-the-box remote management agent and an existing monitoring and management tool such as JConsole.
To expose your application for remote management, you need to start it with the correct properties. This example shows how to expose the
Main
JMX agent for remote management.
For the sake of simplicity, the authentication and encryption security mechanisms are disabled in this example. However, you should implement these security mechanisms when implementing remote management in real-world environments. What Next? provides pointers to other JMX technology documentation that shows how to activate security.
This example requires version 6 of the Java SE platform. To monitor the Main
JMX agent remotely, follow these steps:
jmx_examples.zip
into your work_dir
directory.unzip jmx_examples.zip
work_dir
directory.
javac com/example/*.java
Main
application, specifying the properties that expose Main
for remote management. (For Windows, use the carat (^
) instead of the backslash (\
) to break up a long command into multiple lines):
java -Dcom.sun.management.jmxremote.port=9999 \ -Dcom.sun.management.jmxremote.authenticate=false \ -Dcom.sun.management.jmxremote.ssl=false \ com.example.Main
A confirmation that Main
is waiting for something to happen is generated.
jconsole
The New Connection dialog box is displayed, presenting a list of running JMX agents that you can connect to locally.
hostname:9999
In this address, hostname
is the name of the remote machine on which the Main
application is running and 9999 is the number of the port on which the out-of-the-box JMX connector will be connected.
A summary of the current activity of the Java Virtual Machine (Java VM) in which Main
is running is displayed.
This panel shows all the MBeans that are currently registered in the remote MBean server.
com.example
node in the MBean tree.
You see the example MBean Hello
that was created and registered by Main
. If you click Hello
, you see its associated Attributes and Operations nodes in the MBean tree, even though it is running on a different machine.