Slowpoke

Rack::Timeout enhancements for Rails

• safer service timeouts
• dynamic timeouts
• custom error pages

Add this line to your application’s Gemfile:

gem "slowpoke"

And run:

rails generate slowpoke:install

This creates a public/503.html you can customize.

To try out custom error pages in development, temporarily add to config/environments/development.rb:

config.slowpoke.timeout = 1
config.consider_all_requests_local = false

And add a sleep call to one of your actions:

sleep(2)

The custom error page should appear.

The default timeout is 15 seconds. You can change this in config/environments/production.rb with:

config.slowpoke.timeout = 5

For dynamic timeouts, use:

config.slowpoke.timeout = lambda do |env|
  request = Rack::Request.new(env)
  request.path.start_with?("/admin") ? 15 : 5
end

Subscribe to timeouts with:

ActiveSupport::Notifications.subscribe "timeout.slowpoke" do |name, start, finish, id, payload|
  # report timeout
end

To learn more, see the Rack::Timeout documentation.

Rack::Timeout can raise an exception at any point in the code, which can leave your app in an unclean state. The safest way to recover from a request timeout is to spawn a new process. This is the default behavior for Slowpoke.

For threaded servers like Puma, this means killing all threads when any one of them times out. This can have a significant impact on performance.

You can customize this behavior with:

Slowpoke.on_timeout do |env|
  next if Rails.env.development? || Rails.env.test?

  exception = env["action_dispatch.exception"]
  if exception && exception.backtrace.first.include?("/active_record/")
    Slowpoke.kill
  end
end

Note: To access env["action_dispatch.exception"] in development, temporarily add to config/environments/development.rb:

config.consider_all_requests_local = false

It’s a good idea to set a statement timeout and a connect timeout. For Postgres, your config/database.yml should include something like:

production:
  connect_timeout: 3 # sec
  variables:
    statement_timeout: 5s

View the changelog

Everyone is encouraged to help improve this project. Here are a few ways you can help:

• Report bugs
• Fix bugs and submit pull requests
• Write, clarify, or fix documentation
• Suggest or add new features

To get started with development:

git clone https://github.com/ankane/slowpoke.git
cd slowpoke
bundle install
bundle exec rake test