contrast / exceptional
watch download tarball
public
Forks16Right
Watchers59Right
Description:
Homepage:
Clone URL: git://github.com/contrast/exceptional.git
name age
history
message
file .gitignore Tue Oct 13 10:00:12 -0700 2009 add logging and error handling to remote class [darragh]
file History.txt Tue Nov 17 09:20:30 -0800 2009 fix require rack integration bug [Darragh Curran]
file README.markdown Fri Nov 13 04:31:43 -0800 2009 config.gem with explicit version [darragh]
file Rakefile Tue Oct 13 09:40:21 -0700 2009 rubygems config tidyup [darragh]
directory bin/ Fri Nov 06 08:43:45 -0800 2009 simplify config [darragh]
file exceptional.gemspec Tue Nov 17 09:20:30 -0800 2009 fix require rack integration bug [Darragh Curran]
file exceptional.yml Tue Oct 13 09:40:21 -0700 2009 rubygems config tidyup [darragh]
file init.rb Fri Nov 06 08:43:45 -0800 2009 simplify config [darragh]
file install.rb Sat Oct 04 05:50:40 -0700 2008 Fix install.rb [David Rice]
directory lib/ Tue Nov 17 09:20:30 -0800 2009 fix require rack integration bug [Darragh Curran]
directory rails/ Tue Oct 13 09:40:21 -0700 2009 rubygems config tidyup [darragh]
directory spec/ Fri Nov 13 04:48:52 -0800 2009 merge protocol_five [darragh]
directory tasks/ Tue Oct 20 04:43:28 -0700 2009 added exceptional binary so that gem users can ... [darragh]
README.markdown

Exceptional plugin for Ruby on Rails

This plugin posts exception data to Exceptional (http://getexceptional.com). Data about the request, session, environment and a backtrace of the exception is transmitted.

Once installed and configured, all exceptions from web requests are reported to Exceptional.

Installation

  1. gem install exceptional
  2. Add config.gem entry to 'config/environment.rb' 
    config.gem 'exceptional', :version => '2.0.0'
  3. run 'exceptional install <api-key>' using the api-key for your app from http://getexceptional.com

Other ways to install:

  1. traditional rails plugin install
  2. gem bundler

Upgrading from old version of the exceptional plugin

  1. Delete vendor/plugins/exceptional
  2. Follow installation instructions above
  3. (optional) Simplify your config/exceptional.yml file - all it needs now is a single line with 'api-key: YOUR-KEY'

Usage outside web requests (Daemons etc)

Exceptional.resuce do something_that_you_want_to_catch_exceptions_from end

This reports exceptions to Exceptional and re-raises them.

(Optional) Loading exceptional config

You can either do something like

Exceptional::Config.load("config/exceptional.yml")

or

Exceptional.configure('YOUR_API-KEY')

Please send any questions or comments to feedback@getexceptional.com.

Copyright © 2008, 2009 Contrast.