Automatically Sending Error Messages to Your Email

Problem

You want to receive a descriptive email message every time one of your users encounters an application error.

Solution

Any errors that occur while running your application are sent to the ActionController::Base#log_error method. If youve set up a mailer (as shown in Recipe 15.19) you can override this method and have it send mail to you. Your code should look something like this:

	class ApplicationController < ActionController::Base

	private
	 def log_error(exception)
	 super
	 Notification.deliver_error_message(exception,
	 clean_backtrace(exception),
	 session.instance_variable_get("@data"),
	 params,
	 request.env
	 )
	 end
	end

That code rounds up a wide variety of information about the state of the Rails request at the time of the failure. It captures the exception object, the corresponding backtrace, the session data, the CGI request parameters, and the values of all environment variables.

The overridden log_error calls Notification.deliver_error_messsage, which assumes youve created a mailer called "Notification", and defined the method Notification.error_message. Heres the implementation:

	
	class Notification < ActionMailer::Base
	 def error_message(exception, trace, session, params, env, sent_on = Time.now)
	 @recipients = [e-mail]
	 @from = [e-mail]
	 @subject = "Error message: #{env[REQUEST_URI]}"
	 @sent_on = sent_on
	 @body = {
	 :exception => exception,
	 :trace => trace,
	 :session => session,
	 :params => params,
	 :env => env
	 }
	 end
	end

The template for this email looks like this:

	

	Time: <%= Time.now %>
	Message: <%= @exception.message %>
	Location: <%= @env[REQUEST_URI] %>
	Action: <%= @params.delete(action) %>
	Controller: <%= @params.delete(controller) %>
	Query: <%= @env[QUERY_STRING] %>
	Method: <%= @env[REQUEST_METHOD] %>
	SSL: <%= @env[SERVER_PORT].to_i == 443 ? "true" : "false" %>
	Agent: <%= @env[HTTP_ 
USER_AGENT] %>

	Backtrace
	<%= @trace.to_a.join("

") %>

	Params
	<% @params.each do |key, val| -%>
	* <%= key %>: <%= val.to_yaml %>
	<% end -%>
	Session
	<% @session.each do |key, val| -%>
	* <%= key %>: <%= val.to_yaml %>
	<% end -%>
	
	Environment
	<% @env.each do |key, val| -%>
	* <%= key %>: <%= val %>
	<% end -%>

Discussion

ActionController::Base#log_error gives you the flexibility to handle errors however you like. This is especially useful if your Rails application is hosted on a machine to which you have limited access: you can have errors sent to you, instead of written to a file you might not be able to see. Or you might prefer to record the errors in a database, so that you can look for patterns.

The method ApplicationController#log_error is declared private to avoid confusion. If it weren private, all of the controllers would think they had a log_error action defined. Users would be able to visit //log_error and get Rails to act strangely.

See Also

• Recipe 15.19, "Sending Mail with Rails"