Self monitor Applications Manager using APM Insight Java Agent

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.
  1. Download the appropriate APM Insight Java Agent (apminsight-javaagent.zip) file.
  2. Extract the downloaded file (apminsight-javaagent.zip) to any folder. in the server where the Applications Manager is installed.
    Sample location: D:\ManageEngine\JavaAgent
  3. From the extracted files, open a file named "apminsight.conf".
    1. 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
    2. 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
      1. To fetch the license key:
        Applications Manager UI > "APM" tab > "Add New Monitor" > Copy the license key present in the page
    3. 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
    4. Save and close the "apminsight.conf" file.
    5. 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

  1. Navigate to <AppManager_Home>/working/conf folder.
  2. Open wrapper.conf file in a text editor.
  3. Add the java agent property to the conf file, under the key  wrapper.java.additional.<argument_number>, as mentioned below.
    1. 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

  1. Navigate to Applications Manager installed directory.
  2. Open startApplicationsManager.bat file in a text editor.
  3. 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

  1. Navigate to Applications Manager installed directory.
  2. Open startApplicationsManager.sh file in a text editor.
  3. 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 ADManager Plus?

          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) ...
            • 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 ...
            • APM Insight Java agent setup in K8s via Persistent Volumes

              Prerequisites 1. A persistent volume (with a capacity of 100mb). 2. The persistent volume mounted on all deployment pods (via persistent volume claim). 3. The Applications Manager APM Insight Java agent zip file was downloaded, moved, and extracted ...
            • Troubleshooting communication between APM Insight Agent and Applications Manager

              APM Insight agent communicates to the Applications Manager through the HTTP/HTTPS protocol. Make sure the communication between Applications Manager server and agent server via HTTP/HTTPS is allowed in firewall.To check , open a browser in the APM ...
            • APM Insight Troubleshooting - FAQs

              Monitor Addition - FAQs 1. How to add an APM Insight Monitor? After you deploy the APM Insight agent in your Application Server with suitable Applications Manager credentials in the apminsight.conf file, APM Insight monitors will automatically be ...