Install the Ruby microagent on Heroku applications

Heroku's behavior change since Datadog's Sqreen acquisition

Since Sqreen has joined Datadog, signing up through Heroku, or creating new Heroku applications, is not possible anymore. Click here to learn more.

Heroku is a Platform as a Service (PaaS) that hosts web applications. Sqreen supports Heroku for Rails applications.

  1. Review Ruby microagent compatibility to confirm that the Sqreen Microagent for Ruby is compatible with your Rails application.
  2. Sign up to create your Sqreen account.
  3. Fetch your organization token. From the Sqreen Dashboard, access Account Settings > Environments & Tokens. Your token begins with env_org_. Take note of the token.
  4. After deploying your app on Heroku, install the microagent by adding the gem to the Gemfile.
    gem 'sqreen'
  5. Install the gem from your application's root directory.
    bundle install
  6. From Terminal, in your application root directory, commit your changes and push them to Heroku. This triggers Heroku to deploy your modifications.
    git commit -m 'Add Sqreen to my application' Gemfile Gemfile.lock
    git push heroku master
  7. Add your SQREEN_TOKEN environment variable to your environment.

Learn more about using Sqreen with Heroku: