Java Agent in AWS Elastic Beanstalk

Prerequisites:

• Amazon Web Services (AWS) account.
• Atatus license key. If you do not have a license key, create a new account

Installation Steps:

Instructions on how to install the Atatus Java APM for AWS Elastic Beanstalk apps.

Option 1:

1. Create a folder called .ebextensions inside the Beanstalk app followed by creating a new file inside it called atatus.config.

2. Add following contents to download the java agent in .ebextensions/atatus.config:

   copy

   container_commands:
       01_download_atatus_jar:
           command: "sudo wget -P /usr/local/atatus/ https://atatus-artifacts.s3.amazonaws.com/atatus-java/downloads/latest/atatus-java-agent.jar"
   

3. Create/Update Procfile file with agent options

   copy

   web: java -javaagent:/usr/local/atatus/atatus-java-agent.jar -Datatus.license_key=your_license_key -Datatus.app_name=your_java_app_name -jar my-server.jar
   

4. Add and commit the .ebextensions folder and Procfile file in your Beanstalk application.

5. Then deploy your app to AWS Elastic Beanstalk.

   copy

   eb deploy
   

Option 2:

1. Download the latest Java agent

   copy

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

2. Create/Update Procfile file with agent options

   copy

   web: java -javaagent:/var/app/current/atatus-java-agent.jar -Datatus.license_key=your_license_key -Datatus.app_name=your_java_app_name -jar /var/app/current/my-server.jar
   

3. Bundle server Jar, agent Jar and Procfile into single zip file

   copy

   zip my-app.zip  atatus-java-agent.jar My-application.jar Procfile
   

4. Upload the zip file from AWS Elastic Beanstalk UI.