To instrument Rack applications AppSignal provides an instrumentation middleware which can be added to any Rack application.

To integrate AppSignal in a Rack application we first need to load, configure and start AppSignal.

1
2
3
4
5
6
7
8
9
10

require 'appsignal'                           # Load AppSignal

Appsignal.config = Appsignal::Config.new(
  File.expand_path('../', __FILE__),          # Application root path
  'development',                              # Application environment
  :name => 'logbrowser'                       # Optional configuration hash
)

Appsignal.start                               # Start the AppSignal integration
Appsignal.start_logger                        # Start logger

Lastly we need to add the instrumentation middleware to the application.

1

use Appsignal::Rack::GenericInstrumentation

By default all HTTP requests/actions are grouped under the 'unknown' group. You can override this for an action by setting the route in the request environment.

1

env['appsignal.route'] = '/homepage'

For better insights it's recommended to add additional instrumentation to the Rack application.

Want to help us improve this documentation page? Create a pull request