MeX - Merb eXception tracking
==============
 
Version 0.2.0
 
==============
 
MeX is a flat Merb app that provides a web service for logging exceptions
raised by other web apps.
 
MeX can be run in two different ways: as a stand alone web service or as
a Merb plugin.
 
== Running MeX as a stand-alone web service
 
Start from the command line with:
 
  mex
 
The mex command takes the same arguments as merb does on the command line.
 
By default, this will start the MeX Merb app running on port 4911.  It will
also by default use a sqlite database located in the directory from which you
run the app.  To setup the database, do the following:
 
  $ mex -i
  $ >> Mex.auto_migrate!
 
If you already have a database, you can put your configuration into a YAML
file.
 
  mex --config path/to/config
 
The config file is a YAML file that can look something like this:
 
---
:merb:
  :port: 4911
:development:
  :adapter: sqlite3
  :database: mex.sqlite3
 
Under the :merb key, you can use any of the configuration settings that map
to the arguments that merb accepts on the command line.
 
As for the database, there are two options: either the different environments
can be specified, as above, or a different database configuration can be
provided.  Providing a different database.yml file is done this way:
 
:database
  :config_file: path/to/file.yml
 
For this to work, the merb_database gem must be patched:
 
http://merb.lighthouseapp.com/projects/7588/tickets/92-extend-merb-datamapper-for-custom-configuration
 
Once up and running, from within any Merb app, you can log an exception from
within the exceptions.rb controller like this:
 
class Exceptions < Application
    def internal_server_error
      exception   = self.params[:exception]
      request     = self.request
      orig_params = self.params[:original_params]
 
      params = {}
      params['mex[app_name]']        = 'myApp'
      params['mex[exception_class]'] = exception.name
      params['mex[controller_name]'] = orig_params[:controller]
      params['mex[action_name]']     = orig_params[:action]
      params['mex[message]']         = exception.message
      params['mex[backtrace]']       = exception.backtrace.to_yaml
      params['mex[params]']          = orig_params.to_yaml
      params['mex[environment]']     = request.env.merge( 'process' => $$ ).to_yaml
      params['mex[url]']             = "#{request.protocol}#{request.env["HTTP_HOST"]}#{request.uri}"
 
      Net::HTTP.post_form( URI.parse('http://localhost:4911/mexes'), params ).body
    end
end
 
You can then view the exceptions here:
 
http://localhost:4911
 
== Running MeX as a Merb Plugin
 
After installing the MeX gem, require the gem in init.rb:
 
dependency "mex"
 
Then, from the exceptions.rb controller, do the following:
 
def internal_server_error
  Mex.create_from_controller( self )
  'there was an error'
end
 
Exceptions can then be viewed here:
 
http://yourAppName.com/mex
 
== Building the gem
 
  $ sudo rake gem install
 
CREDITS
 
MeX is heavily inspired by exception_logger - http://github.com/defunkt/exception_logger
 
Jamis Buck  - original exception_notification plugin
Rick Olson  - original model/controller code
Josh Goebel - design