JRockit Mission Control Suite and WebLogic Server

Markus Eisele
12
The JRockit Mission Control tools suite includes tools to monitor, manage, profile, and eliminate memory leaks in your Java application. The best part in this is, that this is done with zero performance overhead in production environments.
This short howto will walk you through the most basic features and introduce you to some (unsupported) experimental plugins.

Installation
You should have a WebLogic Server installation running JRockit R28 in place already. If not, it's time to get the latest 11gR1 (10.3.3) from OTN.
First is to grep a copy of the installer from OTN. Depending on your OS (Linux x86, Linux x86-64, Solaris SPARC 64-bit, Windows x86, Windows x86-64) and Java version you have to download roughly 100 MB. I am using the Oracle JRockit Mission Control 4.0.1 for Windows x86 and Java 6.
Select an installation directory of your choice and if you like, you can choose to install Demos and Samples and the Source Code. The installer comes with a public JRE also. But you don't need it for the things we are going to try next.

Configuration
Normaly you don't have to configure anything on the jrmc itself. Just go to your %RMIC_INSTALL%/bin dir and fire up jrmc.exe.
If you are behind a corporate proxy you have to tell Java to use it. I was not able to find any configuration file, therefore I looked around and added a mc.bat/sh to the %RMIC_INSTALL%/missioncontrol with the following entries:

set JAVA_HOME=%WLSHOME%\jrockit_160_17_R28.0.0-679
set PATH=%WLSHOME%\jrockit_160_17_R28.0.0-679\bin
java -Dhttp.proxyHost=proxy.com -Dhttp.proxyPort=3128 -jar mc.jar

Why? Because of an experimental plug-in we are going to use. Start jrmc and go to "Help - Install Plugins ... (unsupported)" and expand the Experimental Update Site.
Select the Flight Recorder Plug-in WebLogic Tab Pack 0.0.7.
and click next. Accept the OTN Developer License Terms and click next. Click finish. Click install all and restart the jrmc. Please keep in mind, that this feature is an experimental plug-in for JRockit Mission Control. Experimental plug-ins are not supported by Oracle and are either sneak peeks of coming functionality, or useful functionality that is not part of the core distribution of JRockit Mission Control. This feature adds several tabs showing WLS related information.

To make use of the new features you have to enable the related producers within your WebLogic Server.
Check your domain startup files %WLSHOME%/user_projects/domains/your_domain/bin and make shure, you have Oracle as JAVA_VENDOR and add the following as JAVA_OPTIONS

-XX:FlightRecorderOptions=defaultrecording=true

Next is to fire up your wls (startWebLogic.cmd/sh) and launch the admin console (http://localhost:7001/console).
Goto: your_domain - configuration - general - advanced and enable the following two checkboxes (don't forget to save your changes):
Next is to go to your server instance and change the diagnostic volume to "High". Goto: Environment - configuration - general.
Now everything is configured, and you can start using jrmc with WebLogic server.


JRMC Features at a glance
The JRMC has a lot of features. Most basic functions are explained here. Later on I am going to describe the new WebLogic integration.

The Flight Recorder
The JRockit Flight Recorder is a performance monitoring and profiling tool that makes diagnostics information always available, even after catastrophic failure, such as a system crash. At its most basic, Flight Recorder is a rotating buffer of diagnostics and profiling data that you can access whenever you need it. You might consider it a sort of "time machine" that enables you to go back in time to gather diagnostics data leading up to an event. The data stored in the rotating buffer includes JVM and application events. The JRockit Flight Recorder is designed to be always on and its default configuration will not result in any performance overhead because it uses data that is collected by the JVM anyway.

The Management Console
To view real-time behavior of your application and of Oracle JRockit JVM, you can connect to an instance of the JRockit JVM and view real-time information through the JRockit Management Console. Typical data that you can view is thread usage, CPU usage, and memory usage. All graphs are configurable and you can both add your own attributes and redefine their respective labels. In the Management Console you can also create rules that trigger on certain events, for example, an mail will be sent if the CPU reaches 90% of the size.

The Memory Leak Detector
To find memory leaks in your Java application, you connect the JRockit Memory Leak Detector to the running JRockit JVM process. The Memory Leak Detector connects to the JMX (RMP) Agent that instructs to start a Memory Leak server where all further communication takes place.

WebLogic Flight Recorder Tab Pack for Mission Control (Unsupported)
The most interesting part is the new WebLogic integration. Start experiencing it with downloading the Default Recording, you enabled with the corresponding JAVA_OPTION. Right click on your WebLogic Server JVM and select "Dump Default Recording". Choose a timeframe and wait for the recording to be processed. select the blue icon (WebLogic) and see the general overview. You can now inspect all relevant events from the WLDF in a very conveniant gui based way.
The events produced by the WebLogic Diagnostics Framework (WLDF) are throttled per ECID (Execution Context Identifier). If an ECID is picked out by the throttler you will see all WLDF-events generated for a request flow with that ECID. You can control the number of ECIDs that are collected by setting the Diagnostic Volume to Low, Medium or High.

There are a couple of new tabs available.
Overview
This is a new tab providing an overview of the WLDF related events.
ECID
This is a new tab providing an overview of the events grouped by ECID.
Users
This is a new tab listing events on a per user basis.
Database
This is a new tab listing database related events.
EJB
This is a new tab listing EJB (enterprise java bean) related events.
JMS
This is a new tab listing JMS (message service) related events.
JTA
This is a new tab listing JTA (transaction) related events.
Webservices
This is a new tab listing JAXRPC/JAXWS (webservices) related events.
Servlets
This is a new tab listing servlet related events.
HTTP Requests
This is a new tab listing http related events from DMS. Some data may be unavailable unless the DMS producer was active during the recording.

Licensing and the future
JRockit Mission Control is a great tool. You are free to use it under the terms of the OTN License. The productive licensing changed a bit in the past. Latest statement from Oracle regarding the can be found in the JRockit FaQ:
JRMC will be included in various packages that include the JRockit technology. It will not be sold stand-alone under new licensing agreements, but will continue to be bundled with Oracle products.
(Source: FaQ)
Have seen the WebLogic Plugin? Wanting more? I do! I am wanting the same integration for the GlassFish. Anyway. There has not been any anouncements on this. The basic integration architecture allows for many integrations points and GlassFish can run on a JRockit. Let's wait for the future.


Links and Readings
Oracle JRockit Family Downloads
JRockit Mission Control Suite
Using WLDF with JRockit Flight Recorder

Post a Comment

12Comments

  1. FYI, it's important that you get version JRockit Mission Control 4.0.1 as my installation of 4.0.0 did not have the experimental plugins available as an extra installation option. Once I installed 4.0.1 the option was there. Thanks, James

    ReplyDelete
  2. A useful post Markus.

    James - yes, but curiously you can only get 4.0.1 from OTN not via e-Delivery (which is 4.0.0). 4.0.1 has a slightly newer version of JRockit too (build R28.0.1-21-133393-1.6.0_20-20100512 as compared to R28.0.0-679-130297-1.6.0_17-20100312 on x86_64 anyway)

    Regarding licensing: at the time of writing JRMC is in the "Diagnostics Pack for Oracle Middleware" which this is included with WebLogic Server Enterprise and WebLogic Suite. I think this pack can be bought as an extra for WebLogic Server Basic (for people migrating from OAS/iAS) or WebLogic Server Standard Edition.

    ReplyDelete
  3. Thanks Simon, great to have you here :)
    I will have a more detailed look at licensing the next days :)

    ReplyDelete
  4. Hi there, i already managed to run glassfish on jrockit...but how can i have the monitoring tools of mission control?? or somethig similar??

    thanks a lot

    ReplyDelete
  5. Hi Camilo,

    as far as I know, the mcs is only available for WebLogic server at the moment. GF will probably follow ...

    Rgds
    M

    ReplyDelete
  6. Hmmm,
    Can't seem to get the plugin to work...

    Believe I'm running the correct version of everything

    JRockit R28 which comes with JRMC 4.0.1.
    In JRMC I installed WebLogic Tab Pack (0.0.7) plugin.

    I'm able to produce a flight record dump against Weblogic and I can see events for JVM.

    However, when I tried to narrow down the events by unselecting Java events and filtering on Weblogic events I found that I do not have that entry in left-hand gui pane (Event Types).

    Only event types I have are:
    Flight Recorder, Java Application, Java Virtual Machine, and Operating System.

    I don't have the the "WebLogic Server" event type as
    indicated in this video:
    http://www.youtube.com/watch?v=Dqht4rFP9mM


    I confirmed the server was started with the -XX option above and I set the additional options in Weblogic console as indicated above and restarted the server.


    Anything I might have missed?

    ReplyDelete
  7. frazzled,

    which version of WLS are you using?

    M

    ReplyDelete
  8. myfear,
    10.3.3.0
    with Jan patches:
    ./bsu.sh -report | grep 'Patch Set'
    Patch Set ID.............. B1WK
    Patch Set ID.............. P2MT

    ReplyDelete
  9. Hm, should work. Have you configured to WLS attributes (MBean, Diagnostics Volume)?
    I once had this, when one of both was not set correctly.

    ReplyDelete
  10. Yes, I just confirmed.

    Not sure why that would cause the "Weblogic Server" Event type in the JRMC Webloigc plugin to not show up.

    I attempted to install the plugin again but, JRMC knows its installed and no longer presents it in the list of plugins. I'll try to manually remove it and try again.

    If I get it sorted out I'll try to remember to post back with my solution.

    ReplyDelete
  11. If the event types don't show up in the Event Types View it means the WLDF event producer was not registered with the JVM during the recording.

    It's most likely a WLS configuration thing.

    ReplyDelete
Post a Comment