Exceptional http://exceptional.io
Exceptional 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.
-
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
-
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
Exceptional 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
To 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
Use rake spec
to run the specs. We use Appraisals for integration tests, so
install dependencies with rake appraisal:install
. To run integration tests, use rake appraise
.
To run all tests use rake
.
For 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.