Ruby APM with Heroku

  • 1 minute(s) read
Prev Next

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

Ruby Application Setup

Add Stackify APM Module

Modify application Gemfile:

gem 'stackify-ruby-apm'

Configure Application

Add config/stackify_apm.yml to your application, modify application_name and environment_name.

application_name: 'Ruby Application'
environment_name: 'Production'

Rails

Profiler will startup automatically, no additional configuration.

Non-Rails

Include StackifyRubyAPM::Middleware when starting your application:

# config.ru

require 'stackify-ruby-apm'
use StackifyRubyAPM::Middleware
StackifyRubyAPM.start

# application startup

at_exit { StackifyRubyAPM.stop }

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.