Sun GlassFish Enterprise Manager Performance Monitor (Performance Monitor) is a client application that connects to and monitors both local and remote installations of Sun GlassFish Enterprise Server, providing a rich set of real-time performance metrics about servers, domains, clusters, instances, web applications, JVMs, and so on.
Built on the NetBeans framework and encapsulating VisualVM, Performance Monitor presents the performance metrics in convenient, easy-to-interpret graphs, and organizes the monitored objects in a way familiar to users of the GlassFish Admin Console.
This document contains the following sections:
After upgrading to JDK 6 Update 12, Performance Monitor does not display applications (6802057)
After a connection is restored, existing inactive views block new views (6794019)
Using the Profiler adversely affects server performance (6802071)
Online help is not available when there is no internet connection (6802082)
On Windows Vista, Performance Monitor fails to run after being unzipped using cygwin (6790266)
Version |
Date |
Description of Changes |
---|---|---|
10 |
January 2009 |
Initial release version. |
Performance Monitor is a Java application, and requires the Java SE Development Kit (JDK) version 6 update 7 (1.6.0_7) or later.
Performance Monitor 1.0 has been tested on and is supported to run on the following platforms.
Platform |
Minimum Memory / Disk Space |
Recommended Memory / Disk Space |
JVM Version |
---|---|---|---|
Solaris 10 (SPARC and x86) |
512 MB RAM / 250 MB free |
512 MB / 500 MB free |
Java SE 6 Update 7 |
Red Hat Enterprise Linux 4.0 (x86) |
512 MB RAM / 250 MB free |
1GB / 500 MB free |
Java SE 6 Update 7 |
SUSE Linux Enterprise Server 10 SP1 (x86) |
512 MB RAM / 250 MB free |
1GB / 500 MB free |
Java SE 6 Update 7 |
Windows XP (x86) |
1 GB RAM / 500 MB free |
2 GB RAM / 1 GB free |
Java SE 6 Update 7 |
Windows Vista (x86) |
1 GB RAM / 500 MB free |
2 GB RAM / 1 GB free |
Java SE 6 Update 7 |
Mac OS X 10.5.4 (64–bit x86) |
512 MB RAM/ 250 MB free |
512 MB RAM / 500 MB free |
Java SE 6 Update 7 |
Performance Monitor 1.0 has been tested with and is supported to work with Sun GlassFish Enterprise Server 2.1.
After upgrading to JDK 6 Update 12 (1.6.0_12), Performance Monitor does not display any applications in the Applications window. This issue appears when any application on the system is running JDK 6 Update 12, even if Performance Monitor is running JDK 6 Update 11 or earlier.
Workaround: Uninstall JDK 6 Update 12, reverting back to JDK 6 Update 11 (1.6.0_11).
When Performance Monitor loses the connection to a monitored item, it does not close any open view for that item. Later, if the connection is restored, trying to open a view of the item fails. Instead, Performance Monitor brings the existing inactive view of the item to the front.
Workaround: Close the existing inactive view, and then open a new view.
You can use the Close Inactive Views command on the Window menu to close all inactive views without having to locate and select each one.
After adding a JMX connection and then expanding it in the tree pane, the items under the connection can sometimes take more than a minute to display.
Workaround: None. When a JMX connection is added, Performance Monitor sends several JMX messages to the connection to build the list of items the connection has available for monitoring. The elapsed response time of these messages depends on many factors, including: the load on the system hosting the domain or instance, the load on the domain or instance hosting the connection, and network bandwidth.
Even when a web application is available and enabled on a cluster, only the domain administration server instance of the cluster displays a JDBC connection pool. The other instances do not.
Workaround: In the GlassFish Admin Console, select the JDBC resource assoiciated with the web application. Then, use the Manage Targets command to make the resource available and enabled on the cluster.
When a cluster is started using the asadmin start-cluster command or the Start Cluster command in the GlassFish Admin Console, GlassFish starts all the cluster instances simultaneously. In some cases, this simultaneous startup causes some of the instances to start without monitoring available. In Performance Monitor, such instances display "Unavailable" in their Memory and Uptime fields on the cluster view.
This issue has been observed on clusters of 8 instances with JMX over SSL, with the instances distributed on uniform hardware. It might also occur on larger clusters without SSL.
Workaround: Start the instances individually at staggered intervals. For example, using a script that starts the instances 10 to 20 seconds apart prevents this issue from occurring. (The exact delay time is hardware dependent.)
Using the Profiler (available on local GlassFish domains and JVMs) adversely affects performance of the profiled application. When profiling is started, the profiled application is suspended while profiling instrumentation is enabled, and when profiling is stopped, the profiled application is again suspended while profiling instrumentation is disabled. While profiling is active, performance of the profiled application is reduced.
Workaround: None. Using the Profiler is not advised on production servers. For preproduction and development systems, here are some tips:
If you want to profile a web application (not the entire server), use the NetBeans Profiler with its GlassFish integration instead of the Profiler in Performance Monitor. The NetBeans Profiler automatically constrains the profiling instrumentation to the application, so overall server performance is not as greatly affected.
If you need to profile the server, try to define small rootsets (method entry points) so that only parts of the server get instrumented for profiling. Also, make as much memory and CPU time as possible available to the profiled server and to Performance Monitor.
When running Performance Monitor on a system that does not have an internet connection, online help (available at http://wikis.sun.com/display/PerfMonitorOLH) is inaccessible.
Workaround: None.
On Windows Vista, after downloading Performance Monitor and unzipping it using the cygwin command shell, Performance Monitor fails to run. Instead, Windows Vista displays this message:
Windows cannot access the specified device, path or file. You may not have the appropriate permissions to access the item.
Workaround: Do not use the cygwin command shell to unzip Performance Monitor.
On Windows XP, if both Performance Monitor and Cisco VPN are running, attempts to start a local GlassFish domain might fail, producing a series of exceptions.
Workaround: Follow these steps:
Exit Performance Monitor.
Stop any residual Java VMs related to the failed server startup.
Start the GlassFish domain.
Wait for server startup to complete.
Start Performance Monitor.
The Sun web site provides information about the following additional resources:
Documentation (http://www.sun.com/documentation/)
Support (http://www.sun.com/support/)
Training (http://www.sun.com/training/)
Third-party URLs are referenced in this document and provide additional, related information.
Sun is not responsible for the availability of third-party web sites mentioned in this document. Sun does not endorse and is not responsible or liable for any content, advertising, products, or other materials that are available on or through such sites or resources. Sun will not be responsible or liable for any actual or alleged damage or loss caused or alleged to be caused by or in connection with use of or reliance on any such content, goods, or services that are available on or through such sites or resources.
Sun is interested in improving its documentation and welcomes your comments and suggestions.
To share your comments, go to http://docs.sun.com and click Feedback. In the online form, provide the document title and part number. The part number is a seven-digit or nine-digit number that can be found on the title page of the book or at the top of the document.