error_handler.md

Error Handling

At the moment we only support sentry for error alerting.

You can configure the sentry DNS through "sapience.yml", using the "error_handler" section shown in the example below. (note that you can use an environment variable, as in the example below, or just put the DNS in plain text if you prefer).

production:
  log_level: info

  error_handler:
    sentry:
      dsn: <%= ENV['SENTRY_DSN'] %>

or through ruby code as below:

Sapience.error_handler = { sentry: { dsn: ENV["SENTRY_DSN"] } }

Then you can send error messages to Sentry using the following two public methods in Sapience:

  capture_exception(exception, payload = {})
  capture_message(message, payload = {})

As in the example below:

begin
  (do somehting)
rescue MyException => e
  Sapience.capture_exception(e)
  raise e
end

You can also test that you've configured the DNS correctly by using the "test_exception" method, that will send a test message to your configured Sentry project. See below.

Sapience.test_exception(:error)