Install APM Insight Java Agent in Azure Web App


  • Create a new directory under <APP_HOME>/WEB-INF/lib, say appmanager.
  • Download latest the APM Insight java agent zip file (apminsight-javaagent.zip) here
  • Extract the zip file to a appmanager directory to find agent jar and its configuration files.
  • Open the apminsight.conf file in any text editor and include the following keys:
    license.key=[LICENSE KEY]
    apm.host=https://[HOST]:[PORT]/

    Example:

    license.key=APMI_74447444b666d7ab5174cc3021a9b68dd4b3364d50f99c2969360810313e8fac
    apm.host=https://app-w8-test:9090/
    To learn more about the configurations, visit our Configuration Guide page.
  • Bundle your application and deploy it in Azure WebApp service.
  • Add the below JVM argument in App Settings under Settings of your WebApp. Refer to screenshot.
  • If using Tomcat server, please add Key "CATALINA_OPTS" and value as
-javaagent:/usr/home/tomcat/webapps/ROOT/WEB-INF/lib/appmanager/apminsight-javaagent.jar
  • If using Jetty server, please add Key "JAVA_OPTIONS" and value as
-javaagent:D:/home/site/wwwroot/webapps/{APP_NAME}/WEB-INF/lib/appmanager/apminsight-javaagent.jar

  • Restart your Webapp once for changes to take effect.