Add APM Insight Java agent

How to add APM Insight Java agent without application restart?

In general, after installing the APM Insight Java agent, you have to restart your application for the agent to capture monitoring data.


But in case of critical issues in the app, like sudden application slowness, where you haven't installed APM Insight agent previously and an application restart would mean losing the issue at hand, you can use the below suggested method to install the agent without a restart. This would enable you to identify the issue at hand without restarting your application.


We DO NOT recommend this method of installation until it is necessary. Also, kindly avoid this method when your JVM has low free memory or high CPU usage. Loading the Java agent via this approach would consume high memory & CPU for a short period during initialization.


  1. Must have JDK (not JRE) installed on the machine.
  2. APM Insight Java version 5.3 & above.

Installation steps:

  1. Download the agent zip file from Site24x7 web client (APM > APM Insight > Java).

  2. Extract the agent zip anywhere on the machine. Ensure that the user running the app server has read-write permission over this directory.

  3. Identify the app server Process ID (PID) that needs to be monitored.

  4. Execute the following command from the agent directoryjava -jar apminsight-javaagent.jar -start PID

Note: This installation works only one time. If you restart your application, you won't be able to see the monitoring data again. In such cases, we recommend you to install the APM Insight agent following the usual installation procedure.

    • Related Articles

    • How to upgrade the APM Insight Java agent to the latest version that supports Java 6 and 7?

      Java agent version 5.7.0 and above deprecates support for Java applications running on Java 6 and 7. Please see this community post for more details. If you don't want to upgrade to Java 8, you can stick with Java 6 or 7. Since Java agent version ...
    • How to rename an APM Insight application?

      Site24x7 APM Insight 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 the agent associated with that instance will ...
    • DC migration steps for APM Insight agents

      For Server based installations 1. Obtain the new device key. 2. Update the license.key value in the APM Insight configuration file (or the environment variable mentioned) with the new device key. The location varies for each agent, as listed below: ...
    • Steps to troubleshoot when you get NO DATA message for Java applications.

      After adding APM Insight Java agent, if you get NO DATA message, it could be because of probable reasons like network issues or zero traffic in your application. Kindly read through the below given instructions to troubleshoot.  Reason Cause Solution ...
    • DC migration steps for APM Insight Java agent

      Obtain the new device key. Update the license.key value in the apminsight.conf file located at < Extracted Directory>/. Log in to the server and delete the existing instance information file located at ...