Show nav
Heroku Dev Center
  • Get Started
  • Documentation
  • Changelog
  • Get Started
    • Node.js
    • Ruby
    • Java
    • PHP
    • Python
    • Go
    • Scala
    • Clojure
  • Documentation
  • Changelog
  • More
    Additional Resources
    • Elements
    • Products
    • Pricing
    • Careers
    • Help
    • Status
    • Events
    • Podcasts
    Heroku Blog

    Heroku Blog

    Find out what's new with Heroku on our blog.

    Visit Blog
  • Log inorSign up
  • Documentation

    • Heroku Architecture
    • Deployment
    • Command Line
    • Language Support
    • Monitoring & Metrics
    • Databases & Data Management
    • App Performance
    • Add-ons
    • Collaboration
    • Security
    • Heroku Enterprise
    • Heroku Labs
    • Extending Heroku
    • Accounts & Billing
    • Troubleshooting & Support
Language Support › Java Support › Java Advanced Topics

JVM Runtime Metrics

Last updated 17 April 2018

Table of Contents

  • General Information
  • Getting Started
  • Available Metrics
  • Performance implications
  • Using with JRuby
  • Disabling Metrics Collection
  • Removing the Runtime Metrics Buildpack

The JVM Runtime Metrics feature allows you to view heap and non-heap memory, as well as garbage collection activity, for any app that runs inside of the Java Virtual Machine (JVM). This includes (but is not limited to) apps written in Java, Clojure, Gradle, Lein, Maven, Scala, and JRuby,

JVM Runtime Metrics are available for all paid dynos (Hobby and above) and Private Spaces.

General Information

For general information on language specific metrics, please refer to the language runtime metrics parent document.

Getting Started

The heroku/metrics buildpack is no longer required for JVM Runtime Metrics as of Monday, December 11th, 2017.

Once you have enabled the Enhanced Language Metrics feature (by following these instructions), re-deploy your application using an empty commit.

$ git commit --allow-empty -m "Enable Heroku Metrics"
$ git push heroku master

Afterwards, your application should begin exporting memory metrics for the JVM.

Available Metrics

It may take a few minutes for these metrics to become available after the steps above are completed.

Heap Memory Usage

This chart plots, in megabytes (MB) the overall memory quota and the maximum heap memory usage across all dynos in the currently selected process type. Summary metrics for the selected time interval, including latest, average and maximum memory, are also displayed.

jvmmetrics1

How to use this chart

Heap memory is where dynamically allocated memory resides. If you see heap memory growing unexpectedly, that’s typically an indication of a memory leak. You can use tools like Heroku Java CLI for further diagnosis.

Non-heap Memory Usage

This chart plots, in megabytes (MB) the overall memory quota (note: the memory quota time series is toggled off in this screenshot), the maximum non-heap memory usage, the maximum buffer pool direct memory usage, and the maximum buffer pool mapped memory usage, across all dynos in the currently selected process type. Summary metrics for the selected time interval, including latest, average and maximum memory, are also displayed.

jvmmetrics2

The buffer pool mapped and direct time series will only show up if you have any memory usage of those types during the selected timeframe.

How to use this chart

The non-heap memory usage chart can be used to identify memory leaks or excessive consumption of Metaspace and buffer pools. For more information on debugging these kinds of problems, see the article on Troubleshooting Memory Issues in Java Applications.

Aggregate Time Spent in Garbage Collection

This chart plots the aggregate amount of time that was spent doing garbage collection during each roll up, broken down by Young and Old generations. In the legend, you will see a breakdown of the percentage of time during the roll up was spent running the garbage collector.

jvmmetricsgc

Aggregate Garbage Collections

This chart plots the aggregate number of times that the garbage collector ran during each roll up, broken down by Young and Old generations.

jvmmetricsgc2

How to use these charts

The garbage collection charts can be used to tune both the GC and the heap. Like many performance issues, choosing a heap size is a matter of balance. If the heap is too small, the program will spend too much time performance GC. But a very large heap will increase the duration of those pauses. A good rule of thumb is to size the heap so that it is 30% occupied after a full GC, as indicated by the GC chart.

Performance implications

Language runtime metrics collects data from the JVM running on your dyno. The overall impact of JVM metrics collection on application performance is minimal. In our testing we observed the following:

  • an estimated 1MB of additional peak heap usage
  • ~300 additional classes loaded, resulting in < 1MB of additional Metaspace (off-heap) memory
  • 9 additional threads (3 running, 5 parked, 1 waiting)

Using with JRuby

To use this feature with JRuby, you must include the heroku/jvm buildpack with your app by running:

$ heroku buildpacks:add -i 1 heroku/jvm

Then redeploy your application.

Disabling Metrics Collection

To disable JVM metrics collection, simply toggle off the Enhanced Language Metrics toggle via the Metrics Preferences panel, or using this CLI command:

$ heroku labs:disable "runtime-heroku-metrics" -a "my-app-name"

Removing the Runtime Metrics Buildpack

The heroku/metrics buildpack is no longer required for JVM Metrics, so you may want to remove it from your application. This can be done through the CLI or the dashboard

You can remove the buildpack through the Dashboard by going to your app’s Settings page, or by using the command line interface (CLI) and running the following:

$ heroku buildpacks:remove heroku/metrics -a "my-app-name"

Lastly, for your buildpack removal to take effect, you must create a new commit and re-deploy.

$ git commit --allow-empty -m "Remove Runtime Metrics Buildpack"
$ git push heroku master

Keep reading

  • Java Advanced Topics
  • Language Runtime Metrics
  • Dynos and the Dyno Manager
  • Application Metrics

Feedback

Log in to submit feedback.

HTTP Caching in Java with JAX-RSReducing the Slug Size of Java Applications

Information & Support

  • Getting Started
  • Documentation
  • Changelog
  • Blog
  • Podcasts
  • Support Channels
  • Status

Language Reference

  • Node.js
  • Ruby
  • Java
  • PHP
  • Python
  • Go
  • Scala
  • Clojure

Other Resources

  • Careers
  • Elements
  • Products
  • Pricing

Subscribe to our monthly newsletter

  • RSS
    • Dev Center Articles
    • Dev Center Changelog
    • Heroku Blog
    • Heroku News Blog
    • Heroku Engineering Blog
  • Twitter
    • Dev Center Articles
    • Dev Center Changelog
    • Heroku
    • Heroku Status
  • Facebook
  • Instagram
  • Github
  • LinkedIn
Heroku is acompany

© Salesforce.com

  • heroku.com
  • Terms of Service
  • Privacy
  • Cookies