How to monitor JBoss BRMS/BPMS deployed on JBoss EAP through JBoss ON 3?

Solution Verified - Updated -

Environment

  • Red Hat JBoss Operations Network (ON) 3.3
  • Red Hat JBoss Enterprise Application Platform (EAP) 6
  • Red Hat JBoss BRMS (BRMS) Deployable 6
  • Red Hat JBoss BPM Suite (BPMS) Deployable 6
  • Red Hat JBoss BRMS
    • 5.3.x

Issue

  • How to monitor JBoss BxMS deployed on JBoss EAP through JBoss ON 3?

Resolution

BRMS 5.3.x

In order to monitor JBoss BRMS 5.3.x deployed on JBoss EAP 6 Standalone through JBoss ON, JMX module has to be deployed and enabled. See steps below:

  1. Download BRMS Plugin Pack for JBoss ON 3.3 from Customer Portal and install it in JBoss ON.
  2. Start JBoss EAP 6 enabling Drools MBeans. To enable it in the command line, use: -Ddrools.mbeans=enabled
  3. Start JBoss ON agent on the machine that the drools application is running.
  4. In JON UI, select the platform resource's child resources inventory page.
  5. Select the import button located at the bottom of the page and select JMX Server.
  6. Set connections settings template to default. Refer to "Can I create a generic JMX server resource in JBoss ON that connects to JBoss EAP 6?" in order to set up the JMX module properly to JBoss EAP 6.
  7. If JBoss BRMS is running, you can force the JON Agent discover the Drools service by executing the following command from the terminal which you have started the agent (if this has been started via script): discovery --full
  8. Go to JON UI and refresh it. The newly imported JMX server resource should now appear on the server inventory page and under its parent platform's navigation tree.

Note: If your ksession is a short-lived object, you may not be able to find your ksession MBean. This plugin is only meaningful when you maintain long-living ksession. It has been reported in BUG 918031, you can also refer to "Issues by monitoring JBoss BRMS 5.x through JBoss ON 3.1.x" for further details.

BxMS 6.0.0

A JBoss Operations Network plug-in can be used to monitor rules sessions for JBoss BRMS/BPMS. The plug-in uses Java Management Extensions (JMX) to monitor rules sessions.

  1. Download JBoss ON for BRMS 3.3.0 and install it as described in 8.3. Installing the BRMS Plug-in into JBoss ON;
  2. After that, start BRMS 6 using -Dkie.mbeans=enabled (i.e. ./standalone.sh -Dkie.mbeans=enabled) or add it to standalone.conf. You can also add it via API as described in 8.4. Monitoring Kie Bases and Kie Sessions;
  3. Start JBoss ON Agent on the machine that BRMS application is running on;
  4. In JON UI, select the platform resource's child resources inventory page:
    JON UI -> Inventory -> Platforms -> Click on the platform where brms is running on -> Inventory -> Child Resources
  5. Click on the import button located at the bottom of the page and select JMX Server;
  6. Set connections settings template to default. Refer to Can I create a generic JMX server resource in JBoss ON that connects to JBoss EAP 6? in order to set up the JMX module properly to JBoss EAP 6;
  7. If JBoss BRMS is running, you can force the JON Agent discover the Drools service by executing the following command from the terminal which you have started the agent (if this has been started via script): discovery --full;
  8. Go to JON UI and refresh it. The newly imported JMX server resource should now appear on the server inventory page and under its parent platform's navigation tree.

BxMS 6.4

The procedure how to monitor BxMS 6.4.x is explained in documentation

This solution is part of Red Hat’s fast-track publication program, providing a huge library of solutions that Red Hat engineers have created while supporting our customers. To give you the knowledge you need the instant it becomes available, these articles may be presented in a raw and unedited form.