API
Sign In

Puma

On this page, we get you up and running with Sentry's SDK, so that it will automatically report errors and exceptions in your application.

Install

Sentry captures data by using an SDK within your application’s runtime:

Add the sentry-ruby gem to your Gemfile:

Gemfile
Copied
gem "sentry-raven"

Configure

Configure Sentry as early as possible in your app. Once this is done, the Sentry SDK captures all unhandled exceptions.

Puma provides a config option for handling low level errors.

puma.rb
Copied
lowlevel_error_handler do |ex, env|
  Raven.capture_exception(
    ex,
    :message => ex.message,
    :extra => { :puma => env },
    :transaction => "Puma"
  )

  # note the below is just a Rack response
  [500, {}, ["An error has occurred, and engineers have been informed. Please reload the page. If you continue to have problems, contact support@example.com\n"]]
end

Verify

This snippet includes an intentional error, so you can test that everything is working as soon as you set it up:

The simplest way to verify your setup is to create an exception:

Copied
begin
  1 / 0
rescue ZeroDivisionError => exception
  Raven.capture_exception(exception)
end

To view and resolve the recorded error, log into sentry.io and open your project. Clicking on the error's title will open a page where you can see detailed information and mark it as resolved.

You can edit this page on GitHub.