Error tracking

Configuration

Send errors manually

From a begin / rescue block:

begin
  # Your code ...
rescue => exception
  RorVsWild.record_error(exception)
end

Or:

RorVsWild.catch_error { 1 / 0 }  # => #<ZeroDivisionError: divided by 0>
Add extra details
RorVsWild.record_error(exception, {something: "important"})
RorVsWild.catch_error(something: "important") { 1 / 0 }

Pre-fill context

It is also possible to pre-fill this context data at the begining of each request or job:

class ApplicationController < ActionController::Base
  before_action :prefill_error_context
  def prefill_error_context
    RorVsWild.merge_error_context(something: "important")
  end
end

Rails error reporter

Is a common interface to report errors without coupling your code to a specific service. You must have at least the agent version 1.10.0. Here is an example:

Rails.error.handle { 1 / 0 } # Same as RorVsWild.catch_error { 1 / 0 }

begin
  1 / 0
rescue => e
  Rails.error.report(e) # Same as RorVsWild.record_error(e)
end

Ignore specific exceptions

Use the ignore_exceptions parameter:

production:
  api_key: "YOUR_API_KEY"
  ignore_exceptions:
    - ActionController::RoutingError
    - ZeroDivisionError

Or with an initializer:

# config/initializers/rorvswild.rb
RorVsWild::Client.new(
  api_key: "YOUR_API_KEY",
  ignore_exceptions: [
    "ActionController::RoutingError",
    "ZeroDivisionError"
  ]
)

By default all exceptions returned by ActionDispatch::ExceptionWrapper.rescue_responses are ignored, because they are already handled by Rails. Thus you receive less noise and can focus on real errors only.

Here is a list of default ignored the exceptions that may vary depending on the version of Rails:

• AbstractController::ActionNotFound
• ActionController::BadRequest
• ActionController::InvalidAuthenticityToken
• ActionController::InvalidCrossOriginRequest
• ActionController::MethodNotAllowed
• ActionController::MissingExactTemplate
• ActionController::NotImplemented
• ActionController::ParameterMissing
• ActionController::RoutingError
• ActionController::UnknownFormat
• ActionController::UnknownHttpMethod
• ActionDispatch::Http::MimeNegotiation::InvalidType
• ActionDispatch::Http::Parameters::ParseError
• ActiveRecord::RecordInvalid
• ActiveRecord::RecordNotFound
• ActiveRecord::RecordNotSaved
• ActiveRecord::StaleObjectError
• Rack::QueryParser::InvalidParameterError
• Rack::QueryParser::ParameterTypeError

Need help?

Contact us.