Products
Solutions
Resources
Customers
Company

Sign in
My Account.
The JMX Monitoring extension collects metrics from a JMX based messaging server and uploads them to the AppDynamics Metric Browser.
Before the extension is installed, the prerequisites mentioned here need to be met. Please do not proceed with the extension installation if the specified prerequisites are not met.
JMX must be enabled in your JMX based server for this extension to gather metrics. Please make sure you have all the permissions before deploying the extension. In order to use this extension, you do need a Standalone JAVA Machine Agent or SIM Agent. For more details on downloading these products, please visit download.appdynamics.com.
The extension needs to be able to connect to the JMX based server in order to be collect and send metrics. To do this, you will have to either establish a remote connection in between the extension and the product, or have an agent on the same machine running the product in order for the extension to collect and send the metrics.
<MACHINE_AGENT_HOME>/monitors/
.NOTE: Please place the extension in the "monitors" directory of your Machine Agent installation directory. Do not place the extension in the "extensions" directory of your Machine Agent installation directory.
Note : Please make sure to not use tab (\t) while editing yaml files. You may want to validate the yaml file using a yaml validator
Configure the JMX connection parameters by editing the config.yml file in <MACHINE_AGENT_HOME>/monitors/JMXMonitor/
.
There are a few fields that you need to make sure are filled in correctly. Once done with them, they should allow you to establish a successful connection with your server. They are :
servers:
- displayName: ""
host: ""
port:
# serviceUrl: ""
username: ""
password: ""
#encryptedPassword: ""
You should either use HOST AND PORT or just the SERVICEURL in order to establish a connection.
encryptedPassword: In case you would like to use an encrypted password, use this field.
#Encryption key for Encrypted password.
encryptionKey: "axcdde43535hdhdgfiniyy576"
numberOfThreads: 15
encryptionKey: If you use an encryptedPassword, please provide the key here as well in order for the system to decrypt your password.
You should either use the Normal PASSWORD or the encryptedPassword and encryptionKey in order to establish a connection. Please read below to find more information on Password Encryption.
<TIER NAME OR TIER ID>
in metricPrefix: "Server|Component:<TIER NAME OR TIER ID>
|Custom Metrics|JMX Monitor". For example, metricPrefix: "Server|Component:Extensions tier|Custom Metrics|JMX Monitor"
You can use this extension to get all metrics that are available through the JMX Messaging service. In order to do so though, you will have to make sure that all metrics are defined correctly. Please follow the next few steps in order to get this right.
- name: "StorePercentUsage"
alias: "Store Percent Usage"
2. There are several properties that are associated with each metric. They are:
* alias
* aggregationType
* timeRollUpType
* clusterRollUpType
* multiplier
* convert
* delta
This format enables you to change some of the metric properties from what the default configurations are.
In Order to use them for each metric, please use the following example.
- name: "AverageEnqueueTime"
alias: "Average Enqueue Time"
clusterRollUpType: "AVERAGE"
timeRollUpType: "SUM"
aggregationType: "SUM"
``` - objectName: "java.lang:type=Memory"
mbeanKeys: ["type"]
metrics:
include:
- name: "HeapMemoryUsage.committed"
alias: "Heap Memory Usage|Committed"
- name: "HeapMemoryUsage.used"
alias: "Heap Memory Usage|Used"
This extension can be used to get values from Map Objects as well. To do so, list the metrics you would like to retrieve from the map in the following manner.
- objectName: "java.lang:type=Memory"
mbeanKeys: ["type"]
metrics:
include:
# Map Metric Level 1
- name: "MapOfString.key1"
alias: "Map 1|Key 1"
- name: "MapOfString.key2"
alias: "Map 1|Key 2"
# Map Metric Level 2
- name: "MapOfString.map2.key2"
alias: "Map 1|Map 2|Key 2"
# Map Metric Level 3
- name: "MapOfString.map2.map3.key32"
alias: "Map 1|Map 2|Map 3|Key 32"
multiplier: "20"
delta: false
aggregationType: "OBSERVATION"
timeRollUpType: "AVERAGE"
clusterRollUpType: "INDIVIDUAL"
convert : {
"ENDANGERED" : "1",
"NODE-SAFE" : "2",
"MACHINE-SAFE" : "3"
}
This extension can be used to get data from List Objects as well. To do so, the metric in the list should be separated with a separator such as a ":" and should be in a key value pair form. If your metric is not in the form listed about, the extension will not be able to extract that data.
- objectName: "java.lang:type=Memory"
mbeanKeys: ["type"]
metrics:
include:
# List Metrics Can be set in the following ways:
- name: "listOfString.metric one"
alias: "listOfString|metric one"
- name: "listOfString.metric two"
alias: "listOfString|metric two"
- name: "listOfString.metric three"
alias: "listOfString|metric three"
Please visit this page to get detailed instructions on configuring Metric Path Character sequence replacements in Extensions.
Always feel free to fork and contribute any changes directly here on GitHub.
Find out more in the AppDynamics Exchange community.
Please follow the steps listed in this troubleshooting-document in order to troubleshoot your issue. These are a set of common issues that customers might have faced during the installation of the extension. If these don't solve your issue, please follow the last step on the troubleshooting-document to contact the support team.
Please visit Encryption Guidelines to get detailed instructions on password encryption. The steps in this document will guide you through the whole process. If you want to use password encryption, please send arguments as connectionProperties. You will have to fill in the encrypted Password and Encryption Key fields in the config but you will also have to give an empty "" value to the password field and the encrypted password will be automatically picked up.
Workbench is an inbuilt feature provided with each extension in order to assist you to fine tune the extension setup before you actually deploy it on the controller. Please review the following document on How to use the Extensions WorkBench
Product | Version |
---|---|
Extension Version | 1.2.1 |
Agent Compatibility | 4.5.13+ |
Controller Compatibility | 4.5+ |
Last Updated | Jan 15, 2021 |
List of Changes can be found in the Changelog.md
v1.2.1 - Updated to work with MachineAgent 21.x