Update your JVM args: Application Insights for Java

Azure App Service

For more information, see Application monitoring for Azure App Service and Java.

Azure Functions

For more information, see Monitoring Azure Functions with Azure Monitor Application Insights.

Spring Boot

For more information, see Using Azure Monitor Application Insights with Spring Boot.

Third-party container images

If you're using a third-party container image that you can't modify, mount the Application Insights Java agent jar into the container from outside. Set the environment variable for the container JAVA_TOOL_OPTIONS=-javaagent:/path/to/applicationinsights-agent.jar.

Tomcat 8 (Linux)

Tomcat installed via apt-get or yum

If you installed Tomcat via apt-get or yum, you should have a file /etc/tomcat8/tomcat8.conf. Add this line to the end of that file:

JAVA_OPTS="$JAVA_OPTS -javaagent:path/to/applicationinsights-agent-3.4.10.jar"

Tomcat installed via download and unzip

If you installed Tomcat via download and unzip from https://tomcat.apache.org, you should have a file <tomcat>/bin/catalina.sh. Create a new file in the same directory named <tomcat>/bin/setenv.sh with the following content:

CATALINA_OPTS="$CATALINA_OPTS -javaagent:path/to/applicationinsights-agent-3.4.10.jar"

If the file <tomcat>/bin/setenv.sh already exists, modify that file and add -javaagent:path/to/applicationinsights-agent-3.4.10.jar to CATALINA_OPTS.

Tomcat 8 (Windows)

Run Tomcat from the command line

Locate the file <tomcat>/bin/catalina.bat. Create a new file in the same directory named <tomcat>/bin/setenv.bat with the following content:

set CATALINA_OPTS=%CATALINA_OPTS% -javaagent:path/to/applicationinsights-agent-3.4.10.jar

Quotes aren't necessary, but if you want to include them, the proper placement is:

set "CATALINA_OPTS=%CATALINA_OPTS% -javaagent:path/to/applicationinsights-agent-3.4.10.jar"

If the file <tomcat>/bin/setenv.bat already exists, modify that file and add -javaagent:path/to/applicationinsights-agent-3.4.10.jar to CATALINA_OPTS.

Run Tomcat as a Windows service

Locate the file <tomcat>/bin/tomcat8w.exe. Run that executable and add -javaagent:path/to/applicationinsights-agent-3.4.10.jar to the Java Options under the Java tab.

JBoss EAP 7

Standalone server

Add -javaagent:path/to/applicationinsights-agent-3.4.10.jar to the existing JAVA_OPTS environment variable in the file JBOSS_HOME/bin/standalone.conf (Linux) or JBOSS_HOME/bin/standalone.conf.bat (Windows):

    JAVA_OPTS="-javaagent:path/to/applicationinsights-agent-3.4.10.jar -Xms1303m -Xmx1303m ..."

Domain server

Add -javaagent:path/to/applicationinsights-agent-3.4.10.jar to the existing jvm-options in JBOSS_HOME/domain/configuration/host.xml:

    <jvm name="default">
        <heap size="64m" max-size="256m"/>
            <option value="-server"/>
            <!--Add Java agent jar file here-->
            <option value="-javaagent:path/to/applicationinsights-agent-3.4.10.jar"/>
            <option value="-XX:MetaspaceSize=96m"/>
            <option value="-XX:MaxMetaspaceSize=256m"/>

If you're running multiple managed servers on a single host, you'll need to add applicationinsights.agent.id to the system-properties for each server:

    <server name="server-one" group="main-server-group">
        <!--Edit system properties for server-one-->
            <property name="applicationinsights.agent.id" value="..."/>
    <server name="server-two" group="main-server-group">
        <socket-bindings port-offset="150"/>
        <!--Edit system properties for server-two-->
            <property name="applicationinsights.agent.id" value="..."/> 

The specified applicationinsights.agent.id value must be unique. It's used to create a subdirectory under the Application Insights directory. Each JVM process needs its own local Application Insights config and local Application Insights log file. Also, if reporting to the central collector, the applicationinsights.properties file is shared by the multiple managed servers, so the specified applicationinsights.agent.id is needed to override the agent.id setting in that shared file. The applicationinsights.agent.rollup.id can be similarly specified in the server's system-properties if you need to override the agent.rollup.id setting per managed server.

Jetty 9

Add these lines to start.ini:


Payara 5

Add -javaagent:path/to/applicationinsights-agent-3.4.10.jar to the existing jvm-options in glassfish/domains/domain1/config/domain.xml:

<java-config ...>
    <!--Edit the JVM options here-->

WebSphere 8

  1. Open Management Console.

  2. Go to Servers > WebSphere application servers > Application servers. Choose the appropriate application servers and select:

    Java and Process Management > Process definition >  Java Virtual Machine
  3. In Generic JVM arguments, add the following JVM argument:

  4. Save and restart the application server.

OpenLiberty 18

Create a new file jvm.options in the server directory (for example, <openliberty>/usr/servers/defaultServer), and add this line:



See your application server documentation on how to add JVM args.