Monitoring JMX MBeans in the PATROL

You can use the JMX-based MBeans with the PATROL for Apache Tomcat and Generic Server KM to configure additional parameters that can collect information about the Apache Tomcat or Generic Java Server environment.

Thousands of MBeans exist, and any of them could be monitored by this product, but in most environments, only a small number of those MBeans are important for monitoring purposes. To effectively use this product, you must set up some configuration options and to identify those MBeans that you want monitored. PATROL calls this process of identifying and specifying MBeans for monitoring as defining a condition.

These MBeans enable you to configure rules that will provide you information that is not supplied by the application class parameters included with the KM. This information from the MBean parameters include:

  • Performance
  • Resource usage
  • Application configurations or properties
  • Notifying events (like faults or state changes)

After you have configured a monitoring environment, you can configure additional MBean rules.

Related topic

Registering-an-Apache-Tomcat-environment-in-PATROL

Registering-a-Generic-JVM-environment-in-PATROL

To activate custom JMX MBeans in the Patrol console

Select the monitored environment in which you want to enable JMX MBeans and choose KM Commands > Custom MBean > Activate Custom MBean.

Under the environment name, a new MBeans node appears that contains a ConfigurationStatus object.

MBeans and ConfigurationStatus node

MBeans object.png

To define conditions for MBean monitoring

When you define conditions, you

  • Establish the criteria for PATROL to monitor one or more MBeans
  • Create icons in the console

Perform the following steps to define conditions for monitoring JMX MBeans.

  1. Select the MBeans node under the monitored environment, right-click, and choose KM Commands > Discover MBeans from the menu. The MBean Management dialog box is displayed.
    MBean Management dialog box
    MBean Management.png

  2. Enter the MBean domain (example: java.lang). If you do not enter a name, "*" is used as the default domain name.
  3. Select the MBeans that you want to monitor from the list.
    All of the Mbeans are shown. You can reduce the list by entering an property and a value that the MBean must match.
  4. After you have selected the MBeans to monitor, click Select and a dialog box appears with the information for the selected MBeans.
    MBean Information dialog box
    MBean Attributes.png

  5. From the dialog box, select the attributes for the MBeans and click Select.

    Note

    The PATROL for Apache Tomcat and Generic Server KM only supports the following MBean attribute types: Numeric, String, Boolean, and Object.

  6.  After you have selected the attributes, enter a condition condition name.
    Define Condition dialog box
    Define Condition.png
    The contents of this dialog box vary depending on the type of data contained in the object (string, Boolean, or numeric).
  7. Enter a name for the condition.
    You can also enter a string value if you are defining an MBean that can use a string value to filter the MBean list.
  8. Click OK and the condition name is used as an instance name for icons created in the BMC PATROL console, and is used to refer to this condition if you need to perform future updates.
    MBean condition name and attributes
    MBean Condition.png

 

 

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*