AppDynamics Application Intelligence Platform

3.8.x Documentation

PDFs

Videos

Release Notes

This topic describes how to import or export your existing JMX configurations or create new JMX configurations.

Prerequisite for Configuring JMX Metric Rules

To create a New JMX Configuration

This is useful if you want to separate out the custom metrics from the out-of-the-box metrics.

  1. In the left navigation menu, click Servers -> JMX.
     
  2. Click Select Node, in the Node Browser click the node, and then click Select. All the Domains for the node appear.
  3. In the Domain tree, expand the domains to locate the MBean you want to  use as the basis for a JMX metric.
     
  4. Click the MBean attribute you want to work with, and then click Create New JMX Configuration.

    The Create JMX Configuration dialog appears. 
  5.  Enter the Name and Description for the JMX configuration, and click Enabled if you want the new configuration to be immediately accessible and usable.

To import a JMX metrics configuration

1. Click Configure -> Instrumentation.

2. Click the JMX tab.

3. Click the Import JMX Configuration icon.

4. In the JMX Configuration Import screen, click Select JMX Config. File and select the XML configuration file for your JMX metrics.

5. Click Import.

To export a JMX metrics configuration

1. Click Configure -> Instrumentation.

2. Click the JMX tab.

3. Click the Export JMX Configuration icon.

The configuration is downloaded as an XML file.

To use a pre-3.3 configuration file for JMX metrics

In AppDynamics Pro Version 3.3 the structure of the XML-based configuration file for JMX metrics changed. As a result, if you use a pre-3.3 version, you must provide additional attributes in the configuration file.

The following screenshot shows a sample XML configuration file for the JMX metrics for pre-3.3 versions of AppDynamics:

Beginning with AppDynamics version 3.3, the structure for this XML file is the following:

To be able to import your existing configurations for JMX metrics, add the following attributes for <server> element and each of the <metric> elements in your XML file.

The attributes for each element are listed below:

Attributes for the <server> element

Attribute Name

Attribute Type

Allowed Values

Mandatory/Optional

description

String

 

Mandatory

enabled

Boolean

true/false

Mandatory

name

String

 

Mandatory

Attributes for each <metric> element

For each <metric> element, add the mandatory attributes from the following list to your existing configuration file:

Attribute Name

Attribute Type

Allowed Values

Mandatory/Optional

name

String

 

Mandatory

domain-name

String

true/false

Mandatory

mbean-name-pattern

String

 

Mandatory

category

String

 

Mandatory
All those <metric> elements that
have same value for this attribute will
be grouped together on the metric browser.

enabled

Boolean

true/false

Mandatory

exclude

Boolean

true/false

Mandatory

bean-name

String

 

Optional

query-attribute

String

 

Optional

query-expression-type

 

Use any one from the following values:

  • any-substring
  • final-substring
  • equals
  • initial-substring

Optional

query-value

String

 

Optional

instance-identifier

String

 

Optional

instance-name

String

 

Optional