Monitor your Java apps in Heroku

Heroku is platform as a service (PaaS) providing support for several programming languages. You can use Atatus APM with your Heroku apps. Atatus APM supports PHP, Java, Ruby, Python and Node.js languages. Follow the below mentioned steps to install Atatus in Heroku Java app.

From Heroku dashboard, select the relevant application you have created and choose Atatus from the add-on page. There are two ways to choose the add-on.
- From UI, you can click on the Configure add-ons and then select the subscription plan.
- From Command line
heroku addons:create atatus:$planlevel -a YOUR_APP
Go to Atatus dashboard by clicking on the Atatus add-on and navigate to the Settings » Account Settings » License Keys in Atatus and copy the Atatus APM License key.

From your terminal, go to your Java app directory and set the license key and application name in heroku config as follows.

heroku config:set ATATUS_APP_NAME='Java App' -a YOUR_APP

heroku config:set ATATUS_LICENSE_KEY='Your APM License Key' -a YOUR_APP
heroku config:set ATATUS_NOTIFY_HOST='YOUR_ON_PREMISE_URL' -a YOUR_APP

# Verify config
heroku config

Download the latest Java agent to your app directory.

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

Create a Procfile in your root directory and add the following line.
web: java -javaagent:/app/atatus-java-agent.jar -jar my-app.jar
Change my-app.jar to your jar file name.

Run the following commands to commit and push the ‘atatus-java-agent.jar’ file into Heroku

git add atatus-java-agent.jar
git commit -m "Add Atatus Agent"
git push heroku main && heroku logs --tail

Access your server from your web app or mobile app or curl. You will visualize your application’s metrics within minutes.