http://exceptional.io
ExceptionalExceptional helps you track errors in your Ruby apps
This Gem/Plugin posts exception data to Exceptional http://exceptional.io. Data about the request, session, environment and a backtrace of the exception is sent.
Rails 2.x Installation
-
Install the Gem
$ gem install exceptional
-
Add config.gem entry to 'config/environment.rb'
config.gem 'exceptional'
-
Create your account and app at http://exceptional.io
-
Configue your API Key
$ exceptional install <api-key>
using the api-key from the app settings screen within Exceptional
-
Test with
exceptional test
Rails 3 Installation
-
Add gem entry to Gemfile
gem 'exceptional'
-
Run bundle install
-
Create your account and app at http://exceptional.io
-
Configue your API Key
$ exceptional install <api-key>
using the api-key from the app settings screen within Exceptional
-
Test with exceptional test
Reporting exceptions in developmentExceptional will not report your exceptions in development environment by default.
To enable reporting of exceptions in development, please add the following lines to your exceptional.yml
.
development:
enabled: true
To write Exceptional information to the log or STDOUT instead of sending it to the remote API, add the following line to your exceptional.yml
.
development:
send_to: stdout
This allows you to monitor Exceptional processing in development mode. Valid values for send_to
are api
(the default), log
and stdout
.
You can provide custom printers for the log
and stdout
destinations. For example, if you like using AwesomePrint
, you can use something like:
Exceptional::Config.stdout_printer = lambda do |exception_data|
ap ["@@@ Exceptional error", exception_data]
end
Exceptional::Config.log_printer = lambda do |exception_data|
Rails.logger.ap ["@@@ Exceptional error", exception_data], :error
end
Multiple Rails environmentsTo use Exceptional within multiple Rails environments, edit your
config/exceptional.yml to look like the following
development:
enabled: true
api-key: your-dev-api-key
production:
enabled: true
api-key: you-prod-api-key
Exceptional also supports your rack, rake, sinatra and plain ruby appsFor more information check out our docs site http://docs.exceptional.io
Or visit our knowledge base http://support.exceptional.io/
Copyright © 2008 - 2012 Exceptional Cloud Services.