Skip to main content
Sinatra applications are officially supported. Instrumenting Sinatra applications requires some manual setup. Follow the installation steps in AppSignal, starting by clicking ‘Add app’ on the accounts screen.
Is your application using a combination of Rails, Grape, Hanami, Padrino or Sinatra? Follow our guide for instrumenting multiple Rack applications.

​
Installation

After installing the AppSignal gem, add the AppSignal integration after requiring sinatra (or sinatra/base).
Then, create the AppSignal configuration file. For more details on configuring AppSignal, see the Ruby configuration page. After these steps, start your Sinatra app and wait for data to arrive in AppSignal.

​
Ignoring errors

To ignore a specific Sinatra error, set the Sinatra.skip_appsignal_error flag in the request environment. This flag will tell AppSignal to ignore the error that occurs during the request and not report it to AppSignal. Only ignore errors like this if you need to ignore errors from a Sinatra app using code. See the ignore_errors option to ignore it for the entire app. To avoid being notified about an error, see our notification settings.

​
Span attributes

Collector mode only: this applies when AppSignal for Ruby runs in collector mode. It has no effect otherwise.
The request’s span carries:
  • http.request.method — the request method.
  • url.scheme, url.path, and url.query — the address that was requested.
  • http.response.status_code — the status your application responded with.
A span for a request that raised also carries error.type, the class of the error.

​
Distributed tracing

Collector mode only: this applies when AppSignal for Ruby runs in collector mode. It has no effect otherwise.
A request that arrives with a traceparent request header continues the trace it names. The request appears inside the calling service’s trace, under the request that caused it. You can follow a slow request from that service into this application without switching traces. The HTTP clients AppSignal supports start the trace. A request without the header starts a new one.