Chapter 1 Sun GlassFish Enterprise Manager DTrace Monitoring 3.0 Beta Release Notes
Sun GlassFish Enterprise Manager DTrace Monitoring 3.0 Beta Release Notes provide late-breaking information about the software and documentation for DTrace Monitoring. The document includes requirements for obtaining and using DTrace Monitoring. Descriptions and workarounds for known issues and limitations are also provided.
Read this document before installing, setting up, and using Sun GlassFish Enterprise Manager DTrace Monitoring 3.0 Beta.
The following topics are addressed here:
Revision History
This section provides a record of changes in these Release Notes.
Table 1–1 Revision History|
Date |
Description of Changes |
|---|---|
|
December 2009 |
Beta release. |
About DTrace Monitoring
DTrace Monitoring enables you to use the DTrace utility of the SolarisTM Operating System (OS) to monitor the performance of Sun GlassFishTM Enterprise Server.
Note –
DTrace Monitoring is beta release software. Use this software for evaluation purposes only. Do not use this software in production deployments.
Requirements for Obtaining and Using DTrace Monitoring
Before you can download and install DTrace Monitoring, you must have a Sun Online Account.
For information about how to download DTrace Monitoring, see Downloading and Installing DTrace Monitoring in Sun GlassFish Enterprise Manager DTrace Monitoring 3.0 Beta Installation and Quick Start Guide. Before downloading DTrace Monitoring, ensure that you have your account username and password.
DTrace Monitoring 3.0 Beta requires the following software:
-
Sun GlassFish Enterprise Server v3
-
JDKTM release 7
Before installing DTrace Monitoring, ensure that JDK release 7 is installed and that Enterprise Server uses this release of the JDK. JDK release 7 is available for download from the Java Early Access Downloads site.
The remaining hardware and software requirements for DTrace Monitoring are identical to the requirements for using Sun GlassFish Enterprise Server v3. For more information, see Hardware and Software Requirements in Sun GlassFish Enterprise Server v3 Release Notes.
DTrace Monitoring Documentation
For information about installation and basic use of DTrace Monitoring, see Sun GlassFish Enterprise Manager DTrace Monitoring 3.0 Beta Installation and Quick Start Guide.
For information about Enterprise Server, see the Sun GlassFish Enterprise Server v3 documentation.
For information about DTrace, see the following documentation:
-
The dtrace(1M) man page
Known Issues
This section lists the following known issues with DTrace Monitoring:
Omission of DynamicImport-Package entry in manifest causes probes for the JavaMailTM service not to fire (Issue 11069)
Description
The DynamicImport-Package: org.glassfish.flashlight.provider entry is omitted from the manifest for the mail.jar file. As a result, the probes for the JavaMail service are not fired.
For details, see GlassFish project Issue 11069.
Workaround
None.
Keep-alive probes for network listeners are not fired as expected (6886579)
Description
When an HTTP request with the connection header Connection: keep-alive is sent to a network listener for whose HTTP protocol Comet support is enabled, keep-alive probes are not fired.
Workaround
None.
Jersey probes are not fired (6908856)
Description
The following Jersey probes are not fired:
-
glassfish:jersey:server:requestStart
-
glassfish:jersey:server:requestEnd
-
glassfish:jersey:server:ruleAccept
Workaround
None.
How to Report Problems and Provide Feedback
If you have problems with Sun GlassFish Enterprise Manager DTrace Monitoring 3.0 Beta, provide feedback through one of the following mechanisms:
-
Feedback Submittal form — A form for submitting feedback on the Enterprise Server product
-
Java Technology Forums — An interactive message board for sharing knowledge and questions about Java technologies and programming techniques; use the Java EE SDK forum for discussions related to the Sun GlassFish Enterprise Server v3 product
-
Sun Software Support services — Links to the Knowledge Base, Online Support Center, and Product Tracker, as well as to maintenance programs and support contact numbers
-
The telephone dispatch number associated with your maintenance contract
So that we can best assist you in resolving problems, please have the following information available when you contact support:
-
A description of the problem, including the situation where the problem occurs and its impact on your operation
-
Machine type, operating system version, and product version, including any patches and other software that might be affecting the problem
-
Detailed steps on the methods you have used to reproduce the problem
-
Any error logs or core dumps
-
Additional Resources
Useful information can be found at the following locations:
Third-Party Web Site References
Third-party URLs are referenced in this document and provide additional, related information.
Note –
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 by or in connection with the use of or reliance on any such content, goods, or services that are available on or through such sites or resources.
Accessibility Features
To obtain accessibility features that have been released since the publication of these media, consult Section 508 product assessments available from Sun upon request to determine which versions are best suited for deploying accessible solutions. Updated versions of applications can be found at http://sun.com/software/javaenterprisesystem/get.html.
For information on Sun's commitment to accessibility, visit http://sun.com/access.
- © 2010, Oracle Corporation and/or its affiliates