Sun GlassFish Enterprise Manager Performance Monitor 1.0 Getting Started Guide

Performing Common Tasks

When using Performance Monitor, the task you want to perform can vary widely, depending on the kind of problem you've encountered and are trying to diagnose with the help of Performance Monitor. However, there are four tasks that you perform routinely as part of most diagnosis sessions using Performance Monitor:

Connecting to a Remote Host

Follow these steps to connect to a remote host system and add it under the Remote node in the Applications window:

  1. Right-click the Remote node in the Applications window, and then choose Add Remote Host from the context menu that appears.

    The Add Remote Host window is displayed.

  2. In the Host Name box, enter the fully qualified host name or the IP address of the system to connect to. Then, click OK.

    The Add Remote Host window closes, and the remote host appears under the Remote note in the Applications window.

Adding a JMX Connection to a Remote Host

Performance Monitor uses JMX connections to monitor GlassFish domains on remote host systems. Follow these steps to add a JMX connection to a remote host:

  1. In the Applications window, navigate to and select the remote host to which you want to add a JMX connection.

  2. Right-click the remote host, and then choose Add JMX Connection from the context menu that appears.

    The Add JMX Connection window is displayed.

  3. In the Connection box, add the JMX port number after the host name and colon. In default installations of GlassFish, the JMX port number is 8686.

  4. Make sure the Use security credentials box is checked. Then enter the GlassFish administrator user name and password in the Username and Password boxes.

  5. If TLS/SSL security has been set up on the JMX port of the GlassFish domain you are connecting to, check the Use TLS/SSL box.

  6. Click OK.

    The Add JMX Connection window closes, and the JMX connection appears under the remote host in the Applications window.

Setting Monitoring Levels

When GlassFish is installed, monitoring is off by default. Additionally, in many product deployments, GlassFish is often run with monitoring off. Thus, you sometimes need to turn monitoring on so that you can diagnose a problem with the help of Performance Monitor. In Performance Monitor, you turn monitoring on in one of two ways, depending on whether you want to monitor web services or other resources.

Setting Monitoring Levels for Web Services

  1. In the Applications window, navigate to the GlassFish server instance hosting the web services you want to monitor.

  2. Click the plus sign next to the GlassFish server instance to display its resources.

  3. Right-click Web Services, and then choose Open from the context menu that appears.

    The Web Services view opens in the views window.

  4. In the table of web services, check the Monitoring Level setting of the web service you want to monitor. If the setting is OFF, choose LOW.

    Monitoring is turned on for the web service.

Setting Monitoring Levels for Other Resources

  1. In the Applications window, navigate to the GlassFish server instance hosting the resources you want to monitor.

  2. Right-click the GlassFish server instance, and then choose Open from the context menu that appears.

    The Server view opens in the views window.

  3. In the list of monitors under Monitoring Configuration, click the OFF link next to any monitor you want to turn on.

    Each time you click the OFF link for a monitor, the monitoring level is set to LOW and the resources handled by that monitor become available to Performance Monitor.

Displaying the View for a Monitored Item

Follow these steps to display the view for a monitored item, and so see the graphs of performance metrics for the item:

  1. In the Applications window, navigate to the item whose performance metrics you want to see.

  2. Double-click the item.

    The view for the item opens in the views window.