Why am I getting R14/R15 errors in NodeJS?

Issue

A NodeJS app is getting R14 or R15 errors via the logs or Dashboard alerts

Resolution

Read more here: https://devcenter.heroku.com/articles/node-memory-use

What happens

An R14 error can indicate either a memory leak, an improperly tuned garbage collector, or an app that is memory-bound and needs vertical scaling.

In this case, the server creates a memory leak by registering a million event listeners each time a request is made. Each listener takes up very little memory, but they add up over time and are never garbage collected. A typical case is usually the inverse: an app that leaks perhaps one or two event listeners per request, but then gets hundreds of thousands of requests over a period of time.

How to fix it

To debug an R14, first you must identify whether your app has a leak, requires a container with more memory, or just needs more aggressive garbage collection settings.

First, you should tune the garbage collector to fit your container's available memory. If this fixes your issue, great! It was just V8's default garbage collection being lazy and greedy.

If your app continues to exceed available memory, you should then run heapdump locally. Run it several times as you simulate traffic to the app, then compare the resulting memory dumps to see what is growing over time in memory. If you see a class of objects (for instance, the above event listeners) growing without reason, then you've identified a memory leak.

It's possible that you won't be able to recreate the leak locally, in which case you can inspect your application's performance directly on the dyno. With Heroku Exec, you can turn inspect on for your live instance after SSHing in. Once inspect is on, you can forward the port using Exec and debug locally.

Finally, if you don't see any type of objects growing beyond what you would expect per request, or being retained for longer than they're necessary, it could be that your app simply requires more memory. If it's on a 1X dyno, try it out on a 2X dyno. If it's on a 2X, try a Performance-M. If this is the necessary solution, you should also consider refactoring - V8 is designed to use about 1.5 GB of memory per process; apps that approach this limit are usually better decoupled into separate services.

Ask on Stack Overflow

Engage with a community of passionate experts to get the answers you need

Ask on Stack Overflow

Heroku Support

Create a support ticket and our support experts will get back to you

Contact Heroku Support