Heroku Java Metrics Agent

A lightweight (no dependencies, ~22KiB) JVM agent that is used to collect metrics for Heroku's JVM runtime metrics feature.

It is automatically added to JVM applications by the language buildpacks for JVM, Java, Gradle, Scala and Clojure. Users of these buildpacks don't need to work with this agent directly.

Manual Setup

Users that use custom buildpacks or Heroku's container runtime can set up this agent manually to get JVM runtime metrics in Heroku's dashboard. Add -javaagent:/path/to/heroku-metrics-agent.jar to your main java process (i.e. in your app's Procfile or your Dockerfile's CMD instruction). It will automatically configure itself when run on Heroku and does nothing when run elsewhere.

Debugging

To enable more detailed logging, set the HEROKU_METRICS_DEBUG environment variable to true.