[Webinar] Discover key trends and best practices in Kubernetes observability with DevOps expert, Viktor Farcic.Register now
Our recognition in the inaugural Gartner MQ for DEM

Install APM Insight Java Agent via system Environment


Note:
  • This approach is suitable for monitoring a single Java application on a machine using our APM Insight Java Agent.
  • Ensure that the specified host, port, application name, license key, and server port are configured correctly based on your APM Insight account details. Adjust the examples accordingly.
  • For monitoring multiple applications or additional configurations, consult the appropriate Application servers documentation.
  • Download latest the APM Insight java agent zip file (apminsight-javaagent.zip) here.
  • Extract the zip file contents to the below appropriate path to find agent jar.
    • For Windows: C:\ManageEngine\
    • For Linux: \opt\ManageEngine\
  • Configure the following agent configuration keys with appropriate value
    • For Windows: Open System properties → Advanced → Environment Variables → Add System variables like below.
      • Variable Name: JAVA_TOOL_OPTIONS
      • Variable Value:
        -javaagent:C:\ManageEngine\apminsight-javaagent\apminsight-javaagent.jar -Dapminsight.apm.host=http://HOST]:[PORT] -
        Dapminsight.application.name="[APPLICATION NAME]" -Dapminsight.license.key=[LICENSE KEY] -Dapminsight.agent.server.port=8080
      • Example:
        -javaagent:C:\ManageEngine\apminsight-javaagent\apminsight-javaagent.jar -Dapminsight.apm.host=http://apmuser:9090 -
        Dapminsight.application.name="My Application" -
        Dapminsight.license.key=APMI_d04e6cf87bc6e4b9429c03426c485dd4f1edd1f813bd332b45955c6b0ef70d59 -
        Dapminsight.agent.server.port=8080

 

  • For Linux: Open ~/.bashrc and add below variables like given in the last line.
    • export JAVA_TOOL_OPTIONS="-javaagent:/opt/ManageEngine/apminsight-javaagent/apminsight-javaagent.jar -
      Dapminsight.apm.host=http://HOST]:[PORT] -Dapminsight.application.name='[APPLICATION NAME]' -Dapminsight.license.key=[LICENSE KEY] -
      Dapminsight.agent.server.port=8080"
    • Example:
      export JAVA_TOOL_OPTIONS="-javaagent:/opt/ManageEngine/apminsight-javaagent/apminsight-javaagent.jar -
      Dapminsight.apm.host=http://apmuser-9771-t:9100 -Dapminsight.application.name='My Application' -
      Dapminsight.license.key=APMI_d04e6cf87bc6e4b9429c03426c485dd4f1edd1f813bd332b45955c6b0ef70d59 -
      Dapminsight.agent.server.port=8080"
    • Execute "source ~/.bashrc" to apply changes.

     

     

  • Restart the appropriate Java Application to take effect
Back to Top