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 ADSelfService Plus?

        Resources

            • 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 Troubleshooting tips - Java Agent

              Check out our APM Insight User Guide for Java Agent More FAQs 1. How to add an APM Insight Monitor?           After you deploy APM Insight agent in your Application Server with suitable Applications Manager credentials in apminsight.conf, APM Insight ...
            • APM Insight Troubleshooting - DotNet Agent

              Check out our User Guide for APM Insight DotNet Agent 1.) Which version of Agent should I use? The 32 bit or the 64 bit? Agent should be chosen based on the application that you need to monitor. If 32 bit applications are to be monitored in IIS then ...
            • APM Insight Troubleshooting Tips - Ruby on Rails Agent

              Check out our APM Insight User Guide for Ruby on Rails Agent More FAQs 1. How can I install APM Insight Agent for Ruby on Rails Applications?       Install the APM Insight Agent for Ruby on Rails Applications by using the command: gem install ...