• Sends per-request object counts, heap growth, GC time, and more to StatsD.
• Sends snapshots of resource usage, e.g. live String objects, to StatsD.
• Supports new stuff: Rails 5.1 and latest Ruby 2.x features.
• Supports old stuff: Rails 2/3/4, Ruby 1.9+, REE, Ruby 1.8 with RubyBench patches.

On Rails 5 (and Rails 3 and 4), add this to the top of config/application.rb:

require 'trashed/railtie'

And in the body of your app config:

module YourApp
  class Application < Rails::Application
    config.trashed.statsd = YourApp.statsd

On Rails 2, add the middleware to config/environment.rb:

Rails::Initializer.run do |config|
  reporter = Trashed::Reporter.new
  reporter.logger = Rails.logger
  reporter.statsd = YourApp.statsd

  config.middleware.use Trashed::Rack, reporter
end

You probably want stats per controller, action, right?

Set a #timing_dimensions lambda to return a list of dimensions to qualify per-request measurements like time elapsed, GC time, objects allocated, etc.

For example:

config.trashed.timing_dimensions = ->(env) do
  # Rails 3, 4, and 5, set this. Other Rack endpoints won't have it.
  if controller = env['action_controller.instance']
    name    = controller.controller_name
    action  = controller.action_name
    format  = controller.rendered_format || :none
    variant = controller.request.variant || :none  # Rails 4.1+ only!

    [ :All,
      :"Controllers.#{name}",
      :"Actions.#{name}.#{action}.#{format}+#{variant}" ]
  end
end

Results in metrics like:

YourNamespace.All.Time.wall
YourNamespace.Controllers.SessionsController.Time.wall
YourNamespace.Actions.SessionsController.index.json+phone.Time.wall

Similarly, set a #gauge_dimensions lambda to return a list of dimensions to qualify measurements which gauge current state, like heap slots used or total number of live String objects.

For example:

config.trashed.gauge_dimensions = ->(env) {
  [ :All,
    :"Stage.#{Rails.env}",
    :"Hosts.#{`hostname -s`.chomp}" ]
}

Results in metrics like:

YourNamespace.All.Objects.T_STRING
YourNamespace.Stage.production.Objects.T_STRING
YourNamespace.Hosts.host-001.Objects.T_STRING

3.2.8 (January 31, 2022)

• REE: Fix that GC.time is reported in microseconds instead of milliseconds

3.2.7 (November 8, 2017)

• Ruby 1.8.7 compatibility

3.2.6 (June 21, 2017)

• Mention Rails 5 support

3.2.5 (Feb 26, 2015)

• Support Ruby 2.2 GC.stat naming, avoiding 2.1 warnings

3.2.4 (July 25, 2014)

• Fix compatibility with Rails 3.x tagged logging - @calavera

3.2.3 (June 23, 2014)

• Report CPU/Idle time in tenths of a percent

3.2.2 (March 31, 2014)

• Reduce default sampling rates.
• Stop gauging all GC::Profiler data. Too noisy.
• Report gauge readings as StatsD timings.
• Support providing a Statsd::Batch since using Statsd#batch results in underfilled packets at low sample rates.
• Fix bug with sending arrays of timings to StatsD.
• Record GC timings in milliseconds.

3.1.0 (March 30, 2014)

• Report percent CPU/idle time: Time.pct.cpu and Time.pct.idle.
• Measure out-of-band GC count, time, and stats. Only meaningful for single-threaded servers like Unicorn. But then again so is per-request GC monitoring.
• Support @tmm1's GC::OOB (https://github.com/tmm1/gctools).
• Measure time between GCs.
• Spiff up logger reports with more timings.
• Support Rails log tags on logged reports.
• Allow instruments' #start to set timings/gauges.

3.0.1 (March 30, 2014)

• Sample requests to instrument based on StatsD sample rate.

3.0.0 (March 29, 2014)

• Support new Ruby 2.0 and 2.1 GC stats.
• Gauge GC details with GC::Profiler.
• Performance rework. Faster, fewer allocations.
• Rework counters and gauges as instruments.
• Batch StatsD messages to decrease overhead on the server.
• Drop NewRelic samplers.

2.0.5 (December 15, 2012)

• Relax outdated statsd-ruby dependency.

2.0.0 (December 1, 2011)

• Rails 3 support.
• NewRelic samplers.

1.0.0 (August 24, 2009)

• Initial release.