Java APM agent in Apache Tomcat

Supported versions

• 7.x
• 8.5.x
• 9.x

Linux installation steps

1. Download the latest Java agent from

   copy

   wget https://atatus-artifacts.s3.amazonaws.com/atatus-java/downloads/latest/atatus-java-agent.jar
   

2. Add the application name and license key in Catalina environment, or CATALINA_OPTS variable, as follows.

   a) Create/Modify the bin/setenv.sh and make sure the file is executable.

   touch bin/setenv.sh
   chmod +x bin/setenv.sh
   

   b) Add the following lines in setenv.sh file.

   copy

   export CATALINA_OPTS="$CATALINA_OPTS -javaagent:/path/to/atatus-java-agent.jar"
   export CATALINA_OPTS="$CATALINA_OPTS -Datatus.license_key=<%APM_LIC_KEY%>"
   export CATALINA_OPTS="$CATALINA_OPTS -Datatus.app_name=<%YOUR_APP_NAME%>"
   

   c) Optional: Set your application package path to find exact source line in Java Exceptions.

   copy

    export CATALINA_OPTS="$CATALINA_OPTS -Datatus.application_packages=<YOUR_PACKAGE_PATH>"
   

3. Restart your Tomcat server to view your performance data within minutes.

Windows installation steps

1. Download the latest Java agent from

   copy

   wget https://atatus-artifacts.s3.amazonaws.com/atatus-java/downloads/latest/atatus-java-agent.jar
   

2. Add the application name and license key in Catalina environment, or CATALINA_OPTS variable, as follows.

   a) Create/Modify the bin\setenv.bat file.

   b) Add the following lines in bin\setenv.bat file.

   copy

   set CATALINA_OPTS=%CATALINA_OPTS% -javaagent:C:\path\to\atatus-java-agent.jar
   set CATALINA_OPTS=$CATALINA_OPTS -Datatus.license_key=<%APM_LIC_KEY%>
   set CATALINA_OPTS=$CATALINA_OPTS -Datatus.app_name=<%YOUR_APP_NAME%>
   

   c) Optional: Set your application package path to find exact source line in Java Exceptions.

   copy

   set CATALINA_OPTS=%CATALINA_OPTS% -Datatus.application_packages=<YOUR_PACKAGE_PATH>
   

3. Restart your Tomcat server to view your performance data within minutes.