Java APM agent in Jetty servers

Supported versions

• 9.2
• 9.3
• 9.4

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

   Option 1: start.ini (For Jetty Version 8.x or 9.x)

   a) Set app name and license key in start.ini as follows

   copy

   --exec
   -javaagent:/path/to/atatus-java-agent.jar
   -Datatus.license_key=APM_LIC_KEY
   -Datatus.app_name=YOUR_APP_NAME
   

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

   copy

   -Datatus.application_packages=<YOUR_PACKAGE_PATH>
   

   Option 2: jetty.sh (For Jetty version 6.x or 7.x)

   a) Set app name and license key in jetty.sh as follows

   copy

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

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

   copy

   export JAVA_OPTIONS="${JAVA_OPTIONS} -Datatus.service_name=<YOUR_PACKAGE_PATH>"
   

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