Self monitor Applications Manager using APM Insight Java Agent
Applications Manager is built with Java, hence we can monitor it using APM Insight Java Agent to measure it's performance continuously, which can be very much useful.
Setting up APM Insight Java Agent
Follow the below steps to download and set up the Java agent.
Note: All the below mentioned steps refer to the Applications Manager to which the monitoring data is to be sent.
- Download the appropriate APM Insight Java Agent (apminsight-javaagent.zip) file.
- Extract the downloaded file (apminsight-javaagent.zip) to any folder. in the server where the Applications Manager is installed.
Sample location: D:\ManageEngine\JavaAgent - From the extracted files, open a file named "apminsight.conf".
- Update the URL of the Applications Manager (to which the monitoring data is to be sent) in the key "apm.host"
Ex: apm.host=https://localhost:8443 - Update the license key of the Applications Manager (to which the monitoring data is to be sent) in the key "license.key"
Ex: license.key=APMI_95ef70db7c637dd75f1b922bd7c9725d1ab59785987a35328af380447bf81e3f - To fetch the license key:
Applications Manager UI > "APM" tab > "Add New Monitor" > Copy the license key present in the page - Provide a name for this application in the key "application.name". This will be used as the display name.
Ex: application.name=APM Self Monitoring - Save and close the "apminsight.conf" file.
- Restart the Applications Manager after these changes.
Example:
Once the above steps are completed, we need to map this agent to the Applications Manager, which you want to monitor. Please follow the steps below, based on the installation type.
Applications Manager - Standalone Installation
Follow the steps given below to add monitor the Applications Manager which is installed as standalone (non OPM Plugin installations). Steps vary a little based on the System OS (Windows/Linux) and start up method (Service/Non-Service).
Note: All the below mentioned steps need to performed on the Applications Manager which the user wants to monitor.
Applications Manager - Service startup
Windows installations
- Navigate to <AppManager_Home>/working/conf folder.
- Open wrapper.conf file in a text editor.
- Add the java agent property to the conf file, under the key wrapper.java.additional.<argument_number>, as mentioned below.
- Ensure that the <argument_number> is unique, and doesn't exist already in the conf file.
Ex: wrapper.java.additional.40=-javaagent:D:/<agent_directory_full_path>/apminsight-javaagent/apminsight-javaagent.jar
Note: Replace <agent_directory_full_path> with the full directory path where the APM Insight agent is installed.
Applications Manager - Non-Service start up
Windows installations
- Navigate to Applications Manager installed directory.
- Open startApplicationsManager.bat file in a text editor.
- Search for the "start javaw" command, and add the following entry next to the class path and save it.
-javaagent:<agent_directory_full_path>/apminsight-javaagent.jar
Example:
Linux installations
- Navigate to Applications Manager installed directory.
- Open startApplicationsManager.sh file in a text editor.
- Search for JAVA_OPTS, add the below argument at the start of the JAVA_OPTS property.
-javaagent:<agent_directory_full_path>/apminsight-javaagent.jar
Example:
Applications Manager - Plugin Installation
Navigate to the Applications Manger folder inside OpManager installed directory, and follow the above mentioned instructions based on the System OS and start up mode.
New to ADSelfService Plus?
Related Articles
Self monitor Applications Manager using Real User Monitoring
We can monitor the Applications Manager using Real User Monitoring with a Java Script injection and this can be used to measure the Applications Manager's performance continuously. All you need is to install and setup the Real User Monitoring (RUM) ...How to rename an existing APM - Java agent application's monitor?
In Applications Manager's APM(Application Performance Monitoring) doesn't support renaming applications/monitors from the web client. However, the application name of an existing application instance can be renamed in the `apminsight.conf` file and ...Uninstrumented Block of Code - APM Insight
In the traces tab --> Slowest Method Calls and Count we show if you find Un-instrumented block of code the reason is as follows: Basically, What is un-instrumented block of code in APM Insight? By default, APM Insight agent monitors known frameworks ...Adding APM Insight Java agent in a Kubernetes environment
There are three methods for installing the APM Insight Java agent in a Kubernetes environment: Using Dockerfile Using InitContainers Using Persistent Volumes Prerequisites Download the latest APM Insight Java agent ZIP file. Extract the ZIP file and ...How to add an APM Insight Java agent in Kubernetes via InitContainers?
Step 1. Create a secret to access the APM Insight license key in your application namespace: kubectl create secret generic app-secret --from-literal=s247licensekey='your_APMInsight_license_key' -n petclinic The license key can be obtained from the ...