SpringSource AMS Documentation : ui-Monitor.Server.MbeanBrowser
This page last changed on Aug 27, 2008 by mmcgarry.
The JMX Console allows you to search for MBeans, display their attributes, and invoke selected MBean operations on them.
When AMS alerts you of availability or health issues with a JVM resource or service, you can use the JMX Console to troubleshoot and resolve the problem.
The MBean attributes displayed in the JMX Console are read-only; the console does not support attribute editing. In this version of AMS, support for MBean operations is limited to operations with one or no arguments of primitive or simple type.
The JMX Console is available on the Views tab when you have a JVM server selected in the AMS portal. These instructions assume that your JVM is in AMS inventory. Note that JVMs are not auto-discovered by AMS. For related instructions, see Importing a Sun JVM into Inventory.
To access specific MBean attributes and operations, you enter search patterns in the these text boxes in the JMX Console page:
Click the Query MBeans button to execute the search.
For MBeans whose object name matches the Object Name Pattern, attributes and operations that match your filter criteria will be listed. For example:
If you wish the console to periodically refresh the attribute values, select an interval from the Refresh Interval pulldown.
If you expect to perform the same search frequently, you can create an XML file that specifies the search criteria. You name the file according to a predefined convention, and store it in a specific directory in your AMS Server installation. Queries you define in this way will appear in the console's Preset Searches drop-down menu.
When you run a saved search, the Object Name Pattern, Attribute Regex Filter, and Operation Regex Filter it comprises will be displayed in the corresponding text boxes at the top of the view.
Name the file that contains a saved search like this:
where SearchID is the name of the search that will appear in the Preset Searches drop-down menu. Save the file in:
The following topics defines the XML schema for saved MBean searches.
A saved MBean search criteria consists of:
Your Sun JVM must be configured for JMX monitoring. For instructions, see Monitoring and Management Using JMX on the Sun web site.
Once your JVM is configured for JMX monitoring, define it as a server in AMS. Browse to the platform where the JVM is located view its monitoring page. Select "New Server" from the "Tools Menu" in the upper right corner. On the next page, name your JVM and select "Sun JVM 1.5" from the drop-down menu. In the "Install Path" field, enter your $JAVA_HOME.
On the subsequent page, click the "Configuration Properties" link, highlighted in yellow. If you've set up password authentication for your JMX monitoring, you'll have to input your user and password here. Double-check the jmx.url field and set the port number accordingly. To track configuration and log files, add in the appropriate info after checking the boxes "server.log_track.enable" and "server.config_track.enable". Make sure the box for "Auto-Discover Garbage Collectors and Memory Pools?" is checked. After clicking ok, AMS Server will start receiving the default metrics for that JVM, although it will take a few minutes for them to appear.
Return to UI Reference.
jmx console.png (image/png)
|Document generated by Confluence on Aug 27, 2008 10:23|