IBM Tivoli Composite Application Manager for Application Diagnostics, Version 7.1.0.1

Configure data collection for specific custom MBeans

You may define specific MBeans. Data collection will be enabled for these MBeans only.

Data collection for the J2EE Domain MBean is not available in an WAS environment.

To customize the generic configuration for JMX data collection:

  1. Make a copy of...

      DC_home/itcamdc/etc/was/app_server_version/mbeanconfig_app_server_version.xml

    ...in a temporary location. Open the copy in a text editor.

  2. Modify the parameters to fit your custom MBean.

    Element Nested within Description
    Version DomainList Defines the version of the application server
    Name Domain Defines a domain. If the asterisk (*) is defined, all MBeans that match the query ObjectName will be returned; otherwise, only the MBeans that belong to this domain name will be returned.
    Description Domain Describes the domain. This can be any text string.
    MBean Domain Defines the MBeans to be collected.
    ObjectName MBean Defines the MBean object name for collection. If the MBean element is used within an Attr element (which indicates the embedded MBean), then the object name is any symbolic name, such as $ATTRIBUTE_VALUE. This symbolic name will be replaced with the actual object name internally.
    Category MBean Unique key for the MBean. Each MBean must have a unique key, which is used in the JMXAcquireAttribute to get the MBean attributes.
    RetrieveAllAttrs MBean A value of true indicates that all the attributes for the MBean must be collected. If you set this to false, define the attributes in the Attr element.
    Attr MBean Defines the attributes to be collected. There may be multiple Attr elements, defining multiple attributes.
    Name Attr The attribute name.
    MappedKey Attr Unique key for the attribute. Each attribute must have a unique key, which is used in the JMXAcquireAttribute to get the specific attribute.
    MBean Attr Defines the embedded MBean within this attribute. This tag is used when an attribute has an embedded MBean, which points to another MBean with the object name.
    JavaBean Attr Defines the embedded MBean within this attribute. This tag is used when an attribute has an embedded MBean, which refers to another java object. The references java object has the elements of a JavaBean (setter, getter).
    TargetType Attr Defines the type of the attribute. This is usually specified for the JavaBean type to determine the attribute type.

  3. Complete one of the following steps:

    • Save the file in...

        DC_home/runtime/app_server_version.node_name.server_name/custom

      Then, in the toolkit custom properties file set the property...

        am.camtoolkit.jmxe.custom

      ...o the name (without path) of the file you modified in Step 2.

    • Save the file in any directory on the monitored host. Then, in the toolkit custom properties file set the property...

        am.camtoolkit.jmxe.custom

      ...to the path and name for the file you modified in Step 2.


Parent topic:

Customize monitoring of custom MBeans