Reference › Test Document Reference › Metrics › JMX Metrics

JMX Metrics

The JMX metrics use the Java Management Extension (JMX) API to provide metrics.

These JMX connectors are provided for an easy setup:

• Any JSR 160 RMI connection
• JBoss 3.2-4.0
• JSE 5 Connector
• Oracle AS (OCJ4)
• Tomcat 5.0.28
• WebLogic 6.1-8.1
• WebLogic 9.x
• WebSphere 5.x
• ITKO JMX Agents

Each of these applications requires slightly different connection parameters. The values that you require for your server are available from your server administrator. Each provider provides slightly different metrics. To use other JMX features, you can invoke them as RMI steps.

Only numerical attributes are supported.

The following example uses JBoss.

Follow these steps:

1. Select JMX Attribute Reader from the dialog.
2. Click OK.

   The Select and Configure JMX Agent dialog opens.

3. Select JBoss from the list of JMX Connectors.
4. Enter the Server Naming URL and Agent RMI name for your installation.
5. The values that you enter in the remaining fields depend on whether your JBoss server requires authentication to access JMX data.
   • If your JBoss server does not require authentication for JMX access, use the default context factory "org.jnp.interfaces.NamingContextFactory".
   • If your JBoss server does require authentication:
     1. Change the context factory to "org.jboss.security.jndi.JndiLoginInitialContextFactory".
     2. Enter the username and password (principal and credentials) needed for the authentication.
     3. Enter the JAAS login module that will authenticate these credentials.
6. Click OK.

   The JMX Object Attribute Viewer opens.

   

   On the left is the JMX Domain hierarchy for JBoss. JMX metrics use an object-attribute model. In this model, domain objects are published by the specific application server (for example, "system"), and attributes are name/value pairs inside the object.

   When you select an object from this tree, then the base attributes of that object are also displayed in the tree. After you select a base attribute, the rest of the attribute name appears in the list in the top right Object Attribute panel.

   In the previous example, we selected the domain object to be jboss.system, the base attribute to be ServerInfo, and the rest of the attribute name to be FreeMemory. The attributes for ServerInfo are displayed in the Object Attribute panel.

7. To select one of these attributes (metrics), select the metric, and click Add .

   This metric is added to the list of selected metrics in the Selected Attributes to Monitor panel at the bottom of the window.

   To remove an attribute from this panel, click Delete .

8. Repeat this process until all of your chosen metrics appear in your list (bottom panel).
9. Click OK to return to the main metrics panel.

   Notice that the JMX metrics are now on the list of metrics.

   Depending on the application server, vendor-specific JARs could be required to enable the JMX communication with that application server.

10. Similarly, you can also select the JSE 5 Connector from the JMX Connector list.
11. Click OK to connect to the JMX Agent.