public
Fork of phildarnowsky/merb_hoptoad_notifier
Description: A merb plugin for hoptoad notification
Homepage: http://github.com/atmos/merb_hoptoad_notifier
Clone URL: git://github.com/aanand/merb_hoptoad_notifier.git
name age message
file .gitignore Tue Jan 06 17:46:31 -0800 2009 Added warn_hoptoad [phildarnowsky]
file LICENSE Sat Oct 11 17:12:09 -0700 2008 add Joakim to the license [atmos]
file README Sun Jul 19 16:14:56 -0700 2009 update README to let folks know they can use th... [atmos]
file Rakefile Loading commit data...
file TODO Sat Oct 11 17:42:58 -0700 2008 cleanup documentation so it installs properly [atmos]
directory lib/
file merb_hoptoad_notifier.gemspec Sat Mar 07 20:45:04 -0800 2009 update the rakefile and gemspec to use the appr... [atmos]
directory spec/ Tue Dec 16 08:41:48 -0800 2008 cleanup a bunch of whitespace, add clean_hoptoa... [atmos]
README
merb_hoptoad_notifier
---------------------------------------------
This is merb plugin for exception notification with hoptoad. It should work with
any merb app that's based on merb 1.0 and higher

This plugin: http://github.com/atmos/merb_hoptoad_notifier/tree/master
The original: http://github.com/thoughtbot/hoptoad_notifier/tree/master

Usage:

1) Get your api key for your app from hoptoadapp.com

2) Add the api key to config/hoptoad.yml with a similar syntax as the following
---
:development: &defaults
  :api_key: ZOMGLOLROFLMAO

:rake:
  <<: *defaults

:test:
  <<: *defaults

:production:
  :api_key: UBERSECRETSHIT


3) Require hoptoad in init.rb
require 'merb_hoptoad_notifier'

4) Add the following method to your Exceptions controller.  Depending on your merb version you'll need to use the 
exceptions,standard_error, or internal_server error as the action name.  Kinda weak, but the API changed a lot in 0.9.x


class Exceptions < Merb::Controller
  if %w( staging production ).include?(Merb.env)
    def standard_error
      HoptoadNotifier.notify_hoptoad(request, session)
      render
    end
  end
end

5) Restart the server, trigger an error(in staging or prod) and check that it arrived at hoptoad :)


Filtersing your post environment
--------------------------------
If you have environmental variables set in your ruby process that should not be sent to hoptoad,
there's a mechanism for filtering those attributes now.  Throw something like this in 
config/init.rb

Merb::BootLoader.after_app_loads do
  HoptoadNotifier.environment_filters = %w(^AWS ^EC2 SECRET PRIVATE KEY)
end

Each of these words will be compiled into a regex so you should be able to use anchors if needed.

Thanks to the following GitHubbers
----------------------------------
joakimk, fairchild and cv.