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 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 ...
    • 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 ...
    • How to enable or disable thread profiling in the Java agent?

      The APM Insight Java agent v5.6 is designed to enable thread profiling by default and runs every eight hours (since JVM start) for five minutes to identify and instrument the slow methods in your application. You can also disable thread profiling by ...
    • What does Java agent troubleshooting operation do and what are the additional arguments that can be given?

      Troubleshooting operation will perform the below mentioned checks: Checks whether agent directory has read/write operations Checks whether apminsight.conf has license key mentioned Checks whether agent state, unmanaged, deleted or managed Checks ...
    • APM Insight agent log paths

      Folder path to view One agent logs One agent logs can be found only in the common application folder in Windows (usually under C:\ProgramData from Vista onwards). Check the following folder path in Windows: C:\ProgramData\Site24x7APMOneAgent\Logs  ...