This add-on is operated by Tilde, Inc.

Skylight monitors your application and distills performance data into answers.


Last Updated: 07 May 2015

This article is a work in progress, or documents a feature that is not yet released to all users. This article is unlisted. Only those with the link can access it.

The Skylight add-on is currently in beta.

Table of Contents

Skylight is an add-on for monitoring your application’s performance.

Skylight distills your performance data into answers. We show you sensible and sophisticated visualizations that get to the heart of the matter, not endless data dumps.

Skylight integrates with your Rails application via the skylight gem.

Provisioning the add-on

Skylight can be attached to a Heroku application via the CLI:

A list of all plans available can be found here.

$ heroku addons:create skylight
-----> Adding skylight to sharp-mountain-4005... done, v18 (free)

Once Skylight has been added a SKYLIGHT_AUTHENTICATION setting will be available in the app configuration and will contain the authentication token for your application. This can be confirmed using the heroku config:get command.


After installing Skylight the application should be configured to fully integrate with the add-on.

Using with Rails 3 and 4

Ruby on Rails applications will need to add the following entry into their Gemfile specifying the Skylight client library.

gem 'skylight'

Update application dependencies with bundler.

$ bundle install


For more information on the features available within the Skylight dashboard please see the docs at

The Skylight dashboard allows you to view your endpoints' response times and view traces to see what’s slow.

The dashboard can be accessed via the CLI:

$ heroku addons:open skylight
Opening skylight for sharp-mountain-4005…

or by visiting the Heroku dashboard and selecting the application in question. Select Skylight from the Add-ons menu.

Migrating between plans

Use the heroku addons:upgrade command to migrate to a new plan.

$ heroku addons:upgrade skylight:large
-----> Upgrading skylight:large to sharp-mountain-4005... done, v18 ($49/mo)
       Your plan has been updated to: skylight:large

Removing the add-on

Skylight can be removed via the CLI.

This will destroy all associated data and cannot be undone!

$ heroku addons:destroy skylight
-----> Removing skylight from sharp-mountain-4005... done, v20 (free)


All Skylight support and runtime issues or feedback should be submitted via