Node.js APM with Heroku

This document details how to install the Node.js APM Profiler in your Node.js application running on Heroku.

Node.js Application Setup

Add Stackify APM Module

Add the Stackify APM module to each application to monitor.

npm install stackify-node-apm --save

Configure Application

Copy node_modules/stackify-node-apm/stackify.js into your application's root directory and modify Application Name and Environment Name.

Initialize Profiler

Add require('stackify-node-apm') to the top of your application's main module.

Add Buildpack

heroku buildpacks:add -i=1 https://github.com/stackify/heroku-buildpack-stackify.git

Configure Buildpack

heroku config:set STACKIFY_KEY="XXXXXXXXXX"
heroku config:set STACKIFY_APPLICATION_NAME="My Application" 
heroku config:set STACKIFY_ENVIRONMENT_NAME="Production" 

Set STACKIFY_KEY to your Stackify Activation Key.

Verify

Deploy changes to Heroku and make requests. You can then verify results in the Retrace dashboard.