exception_notification 4.5.0 → 5.0.0

data/README.md

@@ -1,51 +1,94 @@
 # Exception Notification
 
 [![Gem Version](https://badge.fury.io/rb/exception_notification.svg)](https://badge.fury.io/rb/exception_notification)
-[![Build Status](https://github.com/smartinez87/exception_notification/actions/workflows/main.yml/badge.svg)](https://github.com/smartinez87/exception_notification/actions/workflows/main.yml)
-[![Coverage Status](https://coveralls.io/repos/github/smartinez87/exception_notification/badge.svg?branch=master)](https://coveralls.io/github/smartinez87/exception_notification?branch=master)
-[![Maintainability](https://api.codeclimate.com/v1/badges/78a9a12be00a6d305136/maintainability)](https://codeclimate.com/github/smartinez87/exception_notification/maintainability)
-
-**THIS README IS FOR THE MASTER BRANCH AND REFLECTS THE WORK CURRENTLY EXISTING ON THE MASTER BRANCH. IF YOU ARE WISHING TO USE A NON-MASTER BRANCH OF EXCEPTION NOTIFICATION, PLEASE CONSULT THAT BRANCH'S README AND NOT THIS ONE.**
+[![Build Status](https://github.com/kmcphillips/exception_notification/actions/workflows/ci.yml/badge.svg)](https://github.com/kmcphillips/exception_notification/actions/workflows/ci.yml)
 
 ---
 
 The Exception Notification gem provides a set of [notifiers](#notifiers) for sending notifications when errors occur in a Rack/Rails application. The built-in notifiers can deliver notifications by [email](docs/notifiers/email.md), [HipChat](docs/notifiers/hipchat.md), [Slack](docs/notifiers/slack.md), [Mattermost](docs/notifiers/mattermost.md), [Teams](docs/notifiers/teams.md), [IRC](docs/notifiers/irc.md), [Amazon SNS](docs/notifiers/sns.md), [Google Chat](docs/notifiers/google_chat.md), [Datadog](docs/notifiers/datadog.md) or via custom [WebHooks](docs/notifiers/webhook.md).
 
-There's a great [Railscast about Exception Notification](http://railscasts.com/episodes/104-exception-notifications-revised) you can see that may help you getting started.
+There's a [Railscast (2011) about Exception Notification](http://railscasts.com/episodes/104-exception-notifications-revised) you can see that may help you getting started.
+
+
+## Gem status
+
+This gem is not under active development, but is maintained. There are more robust and modern solutions for exception handling. But this code was [extracted from Rails about 15+ years ago](https://github.com/rails/exception_notification) and still has lots of value for some applications.
 
-[Follow us on Twitter](https://twitter.com/exception_notif) to get updates and notices about new releases.
 
 ## Requirements
 
-* Ruby 2.5 or greater
-* Rails 5.2 or greater, Sinatra or another Rack-based application.
+* Ruby 3.2 or greater
+* If using Rails, version 7.1 or greater. (Sinatra or other Rack-based applications are supported.)
+
 
 ## Getting Started
 
 Add the following line to your application's Gemfile:
 
 ```ruby
-gem 'exception_notification'
+gem "exception_notification"
 ```
 
 ### Rails
 
-ExceptionNotification is used as a rack middleware, or in the environment you want it to run. In most cases you would want ExceptionNotification to run on production. Thus, you can make it work by putting the following lines in your `config/environments/production.rb`:
+In order to install ExceptionNotification as an [engine](https://api.rubyonrails.org/classes/Rails/Engine.html), just run the following command from the terminal:
+
+```bash
+rails g exception_notification:install
+```
+
+This generates an initializer file, `config/initializers/exception_notification.rb` with some default configuration, which you should modify as needed.
+
+Make sure the gem is not listed solely under the `production` group in your `Gemfile`, since this initializer will be loaded regardless of environment. If you want it to only be enabled in production, you can add this to your configuration:
+
+```ruby
+config.ignore_if do |exception, options|
+  !!Rails.env.local?
+end
+```
+
+The generated initializer file will include this require:
+```ruby
+require "exception_notification/rails"
+```
+
+which automatically adds the ExceptionNotification middleware to the Rails middleware stack. This middleware is what watches for unhandled exceptions from your Rails app (except for [background jobs](#background-jobs)) and notifies you when they occur.
+
+The generated file adds an `email` notifier:
+
+```ruby
+  config.add_notifier :email, {
+    email_prefix: "[ERROR] ",
+    sender_address: %{"Notifier" <notifier@example.com>},
+    exception_recipients: %w{exceptions@example.com}
+  }
+```
+
+**Note**: In order to enable delivery notifications by email, make sure you have [ActionMailer configured](docs/notifiers/email.md#actionmailer-configuration).
+
+
+#### Adding middleware manually
+
+Alternatively, if for some reason you don't want to `require "exception_notification/rails"`, you can manually add the middleware, like this:
 
 ```ruby
 Rails.application.config.middleware.use ExceptionNotification::Rack,
   email: {
-    email_prefix: '[PREFIX] ',
+    email_prefix: "[PREFIX] ",
     sender_address: %{"notifier" <notifier@example.com>},
     exception_recipients: %w{exceptions@example.com}
   }
 ```
 
-**Note**: In order to enable delivery notifications by email make sure you have [ActionMailer configured](docs/notifiers/email.md#actionmailer-configuration).
+This is the older way of configuring ExceptionNotification (which prior to version 4 was the _only_ way to configure it), and is still the way used in some of the examples.
+
+Options passed to the `ExceptionNotification::Rack` middleware in this way are translated to the equivalent configuration options for the `ExceptionNotification.configure` of configuring (compare to the [Rails](#rails) example above).
+
 
 ### Rack/Sinatra
 
-In order to use ExceptionNotification with Sinatra, please take a look in the [example application](https://github.com/smartinez87/exception_notification/tree/master/examples/sinatra).
+In order to use ExceptionNotification with Sinatra, please take a look in the [example application](examples/sinatra).
+
 
 ### Custom Data, e.g. Current User
 
@@ -76,12 +119,23 @@ The current user will show up in your email, in a new section titled "Data".
    email: "jane.doe@example.com", # etc...
 ```
 
-For more control over the display of custom data, see "Email notifier ->
-Options -> sections" below.
+For more control over the display of custom data, see "Email notifier -> Options -> sections" below.
+
+
+### Filtering parameters
+
+Since the error notification contains the full request parameters, you may want to filter out sensitive information. The `filter_parameters` in Rails can be used to filter out sensitive information from the request parameters.
+
+```ruby
+config.filter_parameters += [:secret_details, :credit_card_number]
+```
+
+See the Rails documentation for more information: https://guides.rubyonrails.org/configuring.html#config-filter-parameters
+
 
 ## Notifiers
 
-ExceptionNotification relies on notifiers to deliver notifications when errors occur in your applications. By default, 8 notifiers are available:
+ExceptionNotification relies on notifiers to deliver notifications when errors occur in your applications. By default the following notifiers are available:
 
 * [Datadog notifier](docs/notifiers/datadog.md)
 * [Email notifier](docs/notifiers/email.md)
@@ -94,13 +148,14 @@ ExceptionNotification relies on notifiers to deliver notifications when errors o
 * [Google Chat notifier](docs/notifiers/google_chat.md)
 * [WebHook notifier](docs/notifiers/webhook.md)
 
-But, you also can easily implement your own [custom notifier](docs/notifiers/custom.md).
+You also can implement your own [custom notifier](docs/notifiers/custom.md).
+
 
 ## Error Grouping
 
 In general, ExceptionNotification will send a notification when every error occurs, which may result in a problem: if your site has a high throughput and a particular error is raised frequently, you will receive too many notifications. During a short period of time, your mail box may be filled with thousands of exception mails, or your mail server may even become slow. To prevent this, you can choose to group errors by setting the `:error_grouping` option to `true`.
 
-Error grouping uses a default formula of `log2(errors_count)` to determine whether to send the notification, based on the accumulated error count for each specific exception. This makes the notifier only send a notification when the count is: 1, 2, 4, 8, 16, 32, 64, 128, ..., (2**n). You can use `:notification_trigger` to override this default formula.
+Error grouping uses a default formula of `Math.log2(errors_count)` to determine whether to send the notification, based on the accumulated error count for each specific exception. This makes the notifier only send a notification when the count is: 1, 2, 4, 8, 16, 32, 64, 128, ..., (2**n). You can use `:notification_trigger` to override this default formula.
 
 The following code shows the available options to configure error grouping:
 
@@ -124,6 +179,7 @@ Rails.application.config.middleware.use ExceptionNotification::Rack,
   # notification_trigger: lambda { |exception, count| count % 10 == 0 }
 ```
 
+
 ## Ignore Exceptions
 
 You can choose to ignore certain exceptions, which will make ExceptionNotification avoid sending notifications for those specified. There are three ways of specifying which exceptions to ignore:
@@ -139,7 +195,7 @@ You can choose to ignore certain exceptions, which will make ExceptionNotificati
 
 ### :ignore_exceptions
 
-*Array of strings, default: %w{ActiveRecord::RecordNotFound Mongoid::Errors::DocumentNotFound AbstractController::ActionNotFound ActionController::RoutingError ActionController::UnknownFormat}*
+*Array of strings, default: %w{ActiveRecord::RecordNotFound Mongoid::Errors::DocumentNotFound AbstractController::ActionNotFound ActionController::RoutingError ActionController::UnknownFormat ActionDispatch::Http::MimeNegotiation::InvalidType Rack::Utils::InvalidParameterError}*
 
 Ignore specified exception types. To achieve that, you should use the `:ignore_exceptions` option, like this:
 
@@ -155,6 +211,7 @@ Rails.application.config.middleware.use ExceptionNotification::Rack,
 
 The above will make ExceptionNotifier ignore a *TemplateError* exception, plus the ones ignored by default.
 
+
 ### :ignore_crawlers
 
 *Array of strings, default: []*
@@ -171,6 +228,7 @@ Rails.application.config.middleware.use ExceptionNotification::Rack,
                                         }
 ```
 
+
 ### :ignore_if
 
 *Lambda, default: nil*
@@ -189,6 +247,7 @@ Rails.application.config.middleware.use ExceptionNotification::Rack,
 
 You can make use of both the environment and the exception inside the lambda to decide wether to avoid or not sending the notification.
 
+
 ### :ignore_notifier_if
 
 * Hash of Lambda, default: nil*
@@ -201,7 +260,7 @@ Rails.application.config.middleware.use ExceptionNotification::Rack,
                                         ignore_notifier_if: {
                                           email: ->(env, exception) { !Rails.env.production? },
                                           slack: ->(env, exception) { exception.message =~ /^Couldn't find Page with ID=/ }
-                                        }
+                                        },
 
                                         email: {
                                           sender_address: %{"notifier" <notifier@example.com>},
@@ -215,35 +274,69 @@ Rails.application.config.middleware.use ExceptionNotification::Rack,
 
 To customize each condition, you can make use of environment and the exception object inside the lambda.
 
+
 ## Rack X-Cascade Header
 
 Some rack apps (Rails in particular) utilize the "X-Cascade" header to pass the request-handling responsibility to the next middleware in the stack.
 
 Rails' routing middleware uses this strategy, rather than raising an exception, to handle routing errors (e.g. 404s); to be notified whenever a 404 occurs, set this option to "false."
 
+
 ### :ignore_cascade_pass
 
 *Boolean, default: true*
 
 Set to false to trigger notifications when another rack middleware sets the "X-Cascade" header to "pass."
 
-## Background Notifications
 
-If you want to send notifications from a background process like DelayedJob, you should use the `notify_exception` method like this:
+## Background Jobs
+
+The ExceptionNotification middleware can only detect notifications that occur during web requests (controller actions). If you have any Ruby code that gets run _outside_ of a normal web request (hereafter referred to as a "background job" or "background process"), exceptions must be detected a different way (the middleware won't even be running in this context).
+
+Examples of background jobs include jobs triggered from a cron file or from a queue.
+
+ExceptionNotificatior can be configured to automatically notify of exceptions occurring in most common types of Rails background jobs such as [rake tasks](#rake-tasks). Additionally, it provides optional integrations for some 3rd-party libraries such as [Resque and Sidekiq](#resquesidekiq). And of course you can manually trigger a notification if no integration is provided.
+
+
+### Rails runner
+
+To enable exception notification for your runner commands, add this line to your `config/application.rb` _below_ the `Bundler.require` line (ensuring that `exception_notification` and `rails` gems will have already been required):
+
+```ruby
+require 'exception_notification/rails'
+```
+
+(Requiring it from an initializer is too late, because this depends on the `runner` callback, and that will have already been fired _before_ any initializers run.)
+
+
+### Rake tasks
+
+If you've already added `require 'exception_notification/rails'` to your `config/application.rb` as described [above](#rails-runner), then there's nothing further you need to do. (That Engine has a `rake_tasks` callback which automatically requires the file below.)
+
+Alternatively, you can add this line to your `config/initializers/exception_notification.rb`:
+
+```ruby
+require 'exception_notification/rake'
+```
+
+
+### Manually notify of exceptions
+
+If you want to manually send a notifications from a background process that is not _automatically_ handled by ExceptionNotification, then you need to manually call the `notify_exception` method like this:
 
 ```ruby
 begin
-  some code...
+  # some code...
 rescue => e
   ExceptionNotifier.notify_exception(e)
 end
 ```
 
-You can include information about the background process that created the error by including a data parameter:
+You can include information about the background process that created the error by including a `data` parameter:
 
 ```ruby
 begin
-  some code...
+  # some code...
 rescue => e
   ExceptionNotifier.notify_exception(
     e,
@@ -252,57 +345,54 @@ rescue => e
 end
 ```
 
-### Manually notify of exception
-
-If your controller action manually handles an error, the notifier will never be run. To manually notify of an error you can do something like the following:
-
-```ruby
-rescue_from Exception, with: :server_error
+### Resque/Sidekiq
 
-def server_error(exception)
-  # Whatever code that handles the exception
+Instead of manually calling background notifications for each job/worker, you can configure ExceptionNotification to do this automatically. For this, run:
 
-  ExceptionNotifier.notify_exception(
-    exception,
-    env: request.env, data: { message: 'was doing something wrong' }
-  )
-end
+```bash
+rails g exception_notification:install --resque
 ```
 
-## Extras
-
-### Rails
-
-Since his first version, ExceptionNotification was just a simple rack middleware. But, the version 4.0.0 introduced the option to use it as a Rails engine. In order to use ExceptionNotification as an engine, just run the following command from the terminal:
-
-    rails g exception_notification:install
+or
 
-This command generates an initialize file (`config/initializers/exception_notification.rb`) where you can customize your configurations.
+```bash
+rails g exception_notification:install --sidekiq
+```
 
-Make sure the gem is not listed solely under the `production` group, since this initializer will be loaded regardless of environment.
+As above, make sure the gem is not listed solely under the `production` group, since this initializer will be loaded regardless of environment.
 
-### Resque/Sidekiq
+## Manually notify of exceptions from `rescue_from` handler
 
-Instead of manually calling background notifications foreach job/worker, you can configure ExceptionNotification to do this automatically. For this, run:
+If your controller rescues and handles an error, the middleware won't be able to see that there was an exception, and the notifier will never be run. To manually notify of an error after rescuing it, you can do something like the following:
 
-    rails g exception_notification:install --resque
+```ruby
+class SomeController < ApplicationController
+  rescue_from Exception, with: :server_error
 
-or
+  def server_error(exception)
+    # Whatever code that handles the exception
 
-    rails g exception_notification:install --sidekiq
+    ExceptionNotifier.notify_exception(
+      exception,
+      env: request.env, data: { message: 'was doing something wrong' }
+    )
+  end
+end
+```
 
-As above, make sure the gem is not listed solely under the `production` group, since this initializer will be loaded regardless of environment.
+## Development and support
 
-## Support and tickets
+Pull requests are very welcome! Issues too.
 
-Here's the list of [issues](https://github.com/smartinez87/exception_notification/issues) we're currently working on.
+You can always debug the gem by running `rake console`.
 
-To contribute, please read first the [Contributing Guide](https://github.com/smartinez87/exception_notification/blob/master/CONTRIBUTING.md).
+Please read first the [Contributing Guide](CONTRIBUTING.md).
 
-## Code of Conduct
+And always follow the [code of conduct](CODE_OF_CONDUCT.md).
 
-Everyone interacting in this project's codebases, issue trackers, chat rooms, and mailing lists is expected to follow our [code of conduct](https://github.com/smartinez87/exception_notification/blob/master/CODE_OF_CONDUCT.md).
 
 ## License
 
 Copyright (c) 2005 Jamis Buck, released under the [MIT license](http://www.opensource.org/licenses/MIT).
+
+Maintainer: [Kevin McPhillips](https://github.com/kmcphillips)

data/Rakefile

@@ -1,17 +1,24 @@
 # frozen_string_literal: true
 
-require 'rubygems'
-require 'bundler/setup'
+require "rubygems"
+require "bundler/setup"
+require "irb"
 Bundler::GemHelper.install_tasks
-require 'appraisal'
 
-require 'rake/testtask'
+require "rake/testtask"
 
 task default: [:test]
 
 Rake::TestTask.new(:test) do |t|
-  t.libs << 'lib'
-  t.libs << 'test'
-  t.pattern = 'test/**/*_test.rb'
+  t.libs << "lib"
+  t.libs << "test"
+  t.pattern = "test/**/*_test.rb"
   t.warning = false
 end
+
+desc "Start a console with the gem"
+task :console do
+  ARGV.clear
+  puts "ExceptionNotification #{ExceptionNotification::VERSION} loaded."
+  IRB.start
+end

data/docs/notifiers/slack.md

@@ -21,7 +21,6 @@ Rails.application.config.middleware.use ExceptionNotification::Rack,
                                         },
                                         slack: {
                                           webhook_url: '[Your webhook url]',
-                                          channel: '#exceptions',
                                           additional_parameters: {
                                             icon_url: 'http://image.jpg',
                                             mrkdwn: true
@@ -129,12 +128,6 @@ ExceptionNotifier.notify_exception(
 
 The Incoming WebHook URL on slack.
 
-##### channel
-
-*String, optional*
-
-Message will appear in this channel. Defaults to the channel you set as such on slack.
-
 ##### username
 
 *String, optional*

data/exception_notification.gemspec

@@ -1,42 +1,39 @@
 # frozen_string_literal: true
 
-require File.expand_path('lib/exception_notification/version', __dir__)
+require File.expand_path("lib/exception_notification/version", __dir__)
 
 Gem::Specification.new do |s|
-  s.name = 'exception_notification'
+  s.name = "exception_notification"
   s.version = ExceptionNotification::VERSION
-  s.authors = ['Jamis Buck', 'Josh Peek']
-  s.date = '2022-01-20'
-  s.summary = 'Exception notification for Rails apps'
-  s.homepage = 'https://smartinez87.github.io/exception_notification/'
-  s.email = 'smartinez87@gmail.com'
-  s.license = 'MIT'
+  s.authors = ["Jamis Buck", "Josh Peek", "Sebastián Martínez", "Kevin McPhillips"]
+  s.summary = "Exception notification for Ruby applications"
+  s.homepage = "https://kmcphillips.github.io/exception_notification/"
+  s.email = "github@kevinmcphillips.ca"
+  s.license = "MIT"
+  s.metadata = {"changelog_uri" => "https://github.com/kmcphillips/exception_notification/blob/master/CHANGELOG.rdoc"}
 
-  s.required_ruby_version     = '>= 2.3'
-  s.required_rubygems_version = '>= 1.8.11'
+  s.required_ruby_version = ">= 3.2"
 
-  s.files = `git ls-files`.split("\n")
+  s.files = `git ls-files | grep -v '^examples'`.split("\n")
   s.files -= `git ls-files -- .??*`.split("\n")
-  s.test_files = `git ls-files -- test`.split("\n")
-  s.require_path = 'lib'
+  s.require_path = "lib"
 
-  s.add_dependency('actionmailer', '>= 5.2', '< 8')
-  s.add_dependency('activesupport', '>= 5.2', '< 8')
+  s.add_dependency("actionmailer", ">= 7.1", "< 9")
+  s.add_dependency("activesupport", ">= 7.1", "< 9")
 
-  s.add_development_dependency 'appraisal', '~> 2.2.0'
-  s.add_development_dependency 'aws-sdk-sns', '~> 1'
-  s.add_development_dependency 'carrier-pigeon', '>= 0.7.0'
-  s.add_development_dependency 'coveralls', '~> 0.8.2'
-  s.add_development_dependency 'dogapi', '>= 1.23.0'
-  s.add_development_dependency 'hipchat', '>= 1.0.0'
-  s.add_development_dependency 'httparty', '~> 0.10.2'
-  s.add_development_dependency 'mocha', '>= 0.13.0'
-  s.add_development_dependency 'mock_redis', '~> 0.19.0'
-  s.add_development_dependency 'net-smtp'
-  s.add_development_dependency 'rails', '>= 5.2', '< 8'
-  s.add_development_dependency 'resque', '~> 1.8.0'
-  s.add_development_dependency 'rubocop', '0.78.0'
-  s.add_development_dependency 'sidekiq', '>= 5.0.4'
-  s.add_development_dependency 'slack-notifier', '>= 1.0.0'
-  s.add_development_dependency 'timecop', '~> 0.9.0'
+  s.add_development_dependency "aws-sdk-sns", "~> 1"
+  s.add_development_dependency "carrier-pigeon", ">= 0.7.0"
+  s.add_development_dependency "dogapi", ">= 1.23.0"
+  s.add_development_dependency "hipchat", ">= 1.0.0"
+  s.add_development_dependency "httparty", "~> 0.10.2"
+  s.add_development_dependency "mocha", ">= 0.13.0"
+  s.add_development_dependency "mock_redis", "~> 0.19.0"
+  s.add_development_dependency "net-smtp"
+  s.add_development_dependency "ostruct"
+  s.add_development_dependency "rails", ">= 7.1", "< 9"
+  s.add_development_dependency "resque", "~> 1.8.0"
+  s.add_development_dependency "sidekiq", ">= 5.0.4"
+  s.add_development_dependency "slack-notifier", ">= 1.0.0"
+  s.add_development_dependency "standard"
+  s.add_development_dependency "timecop", "~> 0.9.0"
 end

data/gemfiles/pinned_dependencies.gemfile

@@ -0,0 +1,8 @@
+source "https://rubygems.org"
+
+gem "rails", "~> 8.0.0"
+
+# Include any dependencies here that need to be specifically tested.
+gem "sidekiq", "7.1.0" # >= 7.1.5 for the conditional in sidekiq.rb to check parameter cardinality
+
+gemspec path: "../"

data/gemfiles/rails7_1.gemfile

@@ -0,0 +1,5 @@
+source "https://rubygems.org"
+
+gem "rails", "~> 7.1.0"
+
+gemspec path: "../"

data/gemfiles/rails7_2.gemfile

@@ -0,0 +1,5 @@
+source "https://rubygems.org"
+
+gem "rails", "~> 7.2.0"
+
+gemspec path: "../"

data/gemfiles/rails8_0.gemfile

@@ -0,0 +1,5 @@
+source "https://rubygems.org"
+
+gem "rails", "~> 8.0.0"
+
+gemspec path: "../"

data/lib/exception_notification/rack.rb

@@ -48,15 +48,15 @@ module ExceptionNotification
     def call(env)
       _, headers, = response = @app.call(env)
 
-      if !@ignore_cascade_pass && headers['X-Cascade'] == 'pass'
+      if !@ignore_cascade_pass && headers["X-Cascade"] == "pass"
         msg = "This exception means that the preceding Rack middleware set the 'X-Cascade' header to 'pass' -- in " \
-              'Rails, this often means that the route was not found (404 error).'
+              "Rails, this often means that the route was not found (404 error)."
         raise CascadePassException, msg
       end
 
       response
-    rescue Exception => e
-      env['exception_notifier.delivered'] = true if ExceptionNotifier.notify_exception(e, env: env)
+    rescue Exception => e # standard:disable Lint/RescueException
+      env["exception_notifier.delivered"] = true if ExceptionNotifier.notify_exception(e, env: env)
 
       raise e unless e.is_a?(CascadePassException)
 

data/lib/exception_notification/rails/runner_tie.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module ExceptionNotification
+  module Rails
+    class RunnerTie
+      # Registers an at_exit callback, which checks if there was an exception. This is a pretty
+      # crude way to detect exceptions from runner commands, but Rails doesn't provide a better API.
+      #
+      # This should only be called from a runner callback in your Rails config; otherwise you may
+      # register the at_exit callback in more places than you need or want it.
+      def call
+        at_exit do
+          exception = $ERROR_INFO
+          if exception && !exception.is_a?(SystemExit)
+            ExceptionNotifier.notify_exception(exception, data: data_for_exception_notifier(exception))
+          end
+        end
+      end
+
+      private
+
+      def data_for_exception_notifier(exception = nil)
+        data = {}
+        data[:error_class] = exception.class.name if exception
+        data[:error_message] = exception.message if exception
+
+        data
+      end
+    end
+  end
+end

data/lib/exception_notification/rails.rb

@@ -1,5 +1,10 @@
 # frozen_string_literal: true
 
+# Warning: This must be required after rails but before initializers have been run. If you require
+# it from config/initializers/exception_notification.rb, then the rails and rake_task callbacks
+# registered here will have no effect, because Rails will have already invoked all registered rails
+# and rake_tasks handlers.
+
 module ExceptionNotification
   class Engine < ::Rails::Engine
     config.exception_notification = ExceptionNotifier
@@ -7,5 +12,16 @@ module ExceptionNotification
     config.exception_notification.error_grouping_cache = Rails.cache
 
     config.app_middleware.use ExceptionNotification::Rack
+
+    rake_tasks do
+      # Report exceptions occurring in Rake tasks.
+      require "exception_notification/rake"
+    end
+
+    runner do
+      # Report exceptions occurring in runner commands.
+      require "exception_notification/rails/runner_tie"
+      Rails::RunnerTie.new.call
+    end
   end
 end