Java APM agent in Apache Tomcat

​

Linux installation steps

1. Download the latest Java agent from
   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.
   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%>"
   export CATALINA_OPTS="$CATALINA_OPTS -Datatus.notify_host=YOUR_ON_PREMISE_URL"
   
   c) Optional: Set your application package path to find exact source line in Java Exceptions.
    export CATALINA_OPTS="$CATALINA_OPTS -Datatus.application_packages=<YOUR_PACKAGE_PATH>"
   
3. Restart your Tomcat server to view your performance data within minutes.