wireframe-rpm_contrib 1.0.12.1

data/CHANGELOG

@@ -0,0 +1,63 @@
+* Version 1.0.12.1
+
+  Add backgrounded resque support
+
+* Version 1.0.12
+
+  Better support for initialization within a Rails 3 application
+  rpm_contrib now depends on newrelic_rpm >= 2.13.1
+
+* Version 1.0.11
+
+  AWS/S3 instrumentation contributed by Brian Doll
+  Cassandra instrumentation contributed by Ashley Martens
+  Updated Redis instrumentation for 1.x and 2.x contributed by Karl Baum
+
+* Version 1.0.10
+
+  Mongoid support contributed by Karl Baum
+
+* Version 1.0.9
+
+  Fixed dependency specification on newrelic_rpm
+
+* Version 1.0.8
+
+  Redis instrumentation contributed by Ashley Martens
+  Authlogic moved into RPM Ruby Agent
+
+* Version 1.0.7
+
+  Resque instrumentation now supports the resque-multi-job-forks plugin
+
+* Version 1.0.6
+
+  Update newrelic dependency: depends on 2.11.1
+
+* Version 1.0.5
+
+  Clear stats in forked resque jobs
+
+* Version 1.0.4
+
+  Resque support
+
+* Version 1.0.3
+
+  MongoDB instrumentation contributed by John Nunemaker
+
+* Version 1.0.2
+ 
+  Improved Camping support
+
+* Version 1.0.1
+
+  Removed DelayedJob, put back in core agent
+
+* Version 1.0.0
+
+  Initial Release:
+  - Camping
+  - Authlogic
+  - DelayedJob
+  - Paperclip

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009-2010 New Relic, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,170 @@
+# The RPM Contrib Gem
+
+The `rpm_contrib` gem contains instrumentation for the New Relic RPM agent
+contributed by the community of RPM users.  It requires the RPM Agent to run.
+
+To use the rpm_contrib gem, install the `rpm_contrib` gem from rubygems.org.
+It will also install the required version of the `newrelic_rpm` gem if it's not
+already installed.
+
+For Rails 3.0 and later, add this dependency to your Gemfile:
+
+    gem 'rpm_contrib'
+
+For Rails 2.1 and later, add this dependency to your in your environment.rb:
+
+    config.gem 'rpm_contrib'
+
+For other frameworks, make sure you load rubygems if it isn't already, then just
+require the rpm_contrib gem:
+
+    require 'rubygems'
+    require 'rpm_contrib'
+
+When you load the rpm_contrib gem, the `newrelic_rpm` gem will also be
+initialized.  No need for a separate require statement for `newrelic_rpm`.  The
+`rpm_contrib` gem must be loaded before the `newrelic_rpm` gem initializes.
+
+# Supported Frameworks
+
+A number of frameworks are supported in the contrib gem.  They are all turned on
+by default but you can add settings to your newrelic.yml to disable any of them.
+
+### Camping
+
+The gem will detect a Camping app but you need to manually add the
+instrumentation to your configuration file.  See RPMContrib::Instrumentation::Camping 
+for more information.
+
+### Paperclip
+
+No special configuration required for Paperclip visibility.  You can disable
+it by setting `disable_paperclip` to true in the newrelic.yml file.
+
+### MongoDB
+
+Both MongoMapper and Mongoid are supported.  You can disable them both by setting
+'disable_mongodb' to true in the newrelic.yml file.
+
+### Resque
+
+To disable resque, set 'disable_resque' to true in your newrelic.yml file.
+
+### Redis
+
+Redis instrumentation will record operations as well as `allWeb` and `allOther`
+summary metrics under the `Database/Redis` metric namespace. This instrumentation
+supports Redis versions 1.x and 2.x. To disable Redis instrumentation, set
+'disable_redis' to true in your newrelic.yml file.
+
+### AWS/S3
+
+Get metrics on how S3 is performing for you in production. To disable AWS/S3, set
+'disable_aws-s3' to true in your newrelic.yml file.  For more information on this
+instrumentation, check out [our blog](http://blog.newrelic.com/2010/07/06/monitoring-aws-s3/).
+
+# How to Add Custom Instrumentation
+
+We encourage contributions to this project and will provide whatever assistance
+we can to those wishing to develop instrumentation for other open source Ruby
+libraries.
+
+When adding instrumentation to this gem, be sure and get familiar with the [RPM
+Agent API](http://newrelic.github.com/rpm/classes/NewRelic/Agent.html) and
+contact support@newrelic.com with any questions.
+
+There are several extension points in the agent you can take advantage of with
+this gem.
+
+* Custom tracers which measure methods and give visibility to
+  otherwise unmeasured libraries.
+* Samplers which sample some value about once a minute.
+* Dispatcher support for web request handlers which would otherwise be undetected.
+  In order for the agent to turn on in 'auto' mode it needs to discover a 
+  web dispatcher, or be [started manually](http://support.newrelic.com/faqs/general/manual-start).
+* Framework support, for alternatives to Rails like Camping or Ramaze
+
+## Custom Tracers
+
+Custom tracers for frameworks should be added to the `lib/rpm_contrib/instrumentation`
+directory.  These files are loaded at the time the Agent starts.  **They will not
+be loaded if the Agent does not start up.** 
+
+It is important that you wrap any instrumentation with the checks necessary to
+determine if the code being instrumented is loaded.  You can't add code to the
+contrib gem that will break when run in any other context besides yours.
+
+
+For details on how to define custom tracers, refer to the [support documentation
+on adding custom
+tracers](http://support.newrelic.com/faqs/docs/custom-metric-collection).  You
+can also get detailed information on the API from the [Agent method tracing
+rdocs](http://newrelic.github.com/rpm/classes/NewRelic/Agent/MethodTracer.html),
+especially the
+[add_method_tracer](http://newrelic.github.com/rpm/classes/NewRelic/Agent/MethodTracer/ClassMethods.html)
+docs.
+
+A good example can be found in `lib/rpm_contrib/instrumentation/paperclip.rb`.
+
+## Samplers
+
+You can add samplers which will record metrics approximately once a minute.
+Samplers are useful for capturing generic instrumentation for display in [custom
+views](http://support.newrelic.com/faqs/docs/custom-dashboard-specification).
+
+Samplers should extend the
+[`NewRelic::Agent::Sampler`](http://newrelic.github.com/rpm/classes/NewRelic/Agent/Sampler.html)
+class.  They should be placed in the `samplers` directory.
+
+Refer to examples in the RPM agent to see how to get started.
+
+## Supporting New Dispatchers
+
+If you want to add support for a new dispatcher which is not being recognized by
+default by the RPM agent, add code to the `rpm_contrib/detection` directory.
+This code needs to define a module in the `NewRelic::LocalEnvironment` class.
+This module will be accessed at the time environment detection takes place, when
+the agent is initialized.
+
+This module should define the method `discover_dispatcher` and return the name
+of the dispatcher if detected, or defer to super.  See
+`rpm_contrib/detection/camping.rb` for a good example.
+
+## Supporting New Frameworks
+
+Supporting new frameworks can be pretty involved and generally involves both
+adding custom instrumentation as well as framework and dispatcher detection.
+
+In addition it will be necessary to define a new control class with the same 
+name as the framework.  This control class must go in `new_relic/control`.
+
+Refer to the camping example in this gem to see how this is done in general.
+
+If you decide to tackle any new frameworks, contact support@newrelic.com and
+we'll be happy to help you work through it.
+
+# Note on Patches/Pull Requests
+ 
+* Fork the http://www.github.com/newrelic/rpm_contrib project.
+* Add instrumentation files to `lib/rpm_contrib/instrumentation`.  These
+  files will be loaded when the RPM agent is initialized.
+* Add samplers to `lib/rpm_contrib/samplers`.  These classes are
+  installed automatically when the RPM agent is initialized.
+* Add tests.  
+* Commit, do not mess with the Rakefile, version, or history.  (if you
+  want to have your own version, that is fine but bump version in a
+  commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+# Further Information
+
+Refer to the Agent API Documentation at http://newrelic.github.com/rpm
+
+See the support site faqs at http://support.newrelic.com/faqs for additional
+tips and documentation.
+
+Contact support@newrelic.com for help.
+
+### Copyright
+
+Copyright (c) 2009-2010 New Relic. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,77 @@
+require 'rubygems'
+require 'rake'
+# See http://www.rubygems.org/read/chapter/20 
+
+def version
+  @rpm_contrib_version ||= File.read("CHANGELOG")[/Version ([\d\.]+)$/, 1]
+end
+
+RDOC_FILES = FileList['README*','LICENSE','CHANGELOG']
+SUMMARY = "Contributed Instrumentation for New Relic RPM"
+DESCRIPTION = <<-EOF
+Community contributed instrumentation for various frameworks based on
+the New Relic Ruby monitoring gem newrelic_rpm.
+EOF
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "wireframe-rpm_contrib"
+    gem.summary = SUMMARY
+    gem.description = DESCRIPTION
+    gem.email = "support@newrelic.com"
+    gem.homepage = "http://github.com/newrelic/rpm_contrib"
+    gem.author = "Bill Kayser"
+    gem.add_dependency 'newrelic_rpm', '>=2.13.1'
+    gem.version = version
+    gem.files = FileList['LICENSE', 'README*', 'lib/**/*.rb', 'bin/*', '[A-Z]*', 'test/**/*'].to_a
+    gem.rdoc_options <<
+      "--line-numbers" <<
+      "--inline-source" <<
+      "--title" << SUMMARY <<
+      "-m" << "README.md"
+    gem.extra_rdoc_files = RDOC_FILES
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/test_*.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+#task :test => :check_dependencies
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "rpm_contrib #{version}"
+  rdoc.main = "README.md"
+  rdoc.rdoc_files =  FileList['lib/**/*.rb'] + RDOC_FILES
+  rdoc.inline_source = true
+end
+
+begin
+  require 'sdoc_helpers'
+rescue LoadError
+  puts "sdoc support not enabled. Please gem install sdoc-helpers."
+end

data/lib/new_relic/control/camping.rb

@@ -0,0 +1,14 @@
+require 'new_relic/control/ruby'
+# This is the framework control object for Camping apps.
+# It is loaded by virtue of detecting 'camping' as the framework
+# in the rpm_contrib/detection/camping.rb file.  It gets loaded
+# by the new_relic/control.rb file.
+class NewRelic::Control #:nodoc:
+  class Camping < NewRelic::Control::Ruby
+    def init_config(options)
+      super
+      @local_env.dispatcher = 'camping'
+      self['app_name'] ||= 'Camping Application'
+    end
+  end
+end

data/lib/rpm_contrib.rb

@@ -0,0 +1,43 @@
+RPM_CONTRIB_LIB = File.dirname(__FILE__)
+
+module RPMContrib
+  VERSION = File.read(RPM_CONTRIB_LIB+"/../CHANGELOG")[/Version ([\d\.]+)$/, 1]
+
+  def self.init_sequence
+    Proc.new do
+      # Tell the agent to load all the files in the
+      # rpm_contrib/instrumentation directory.
+      NewRelic::Agent.add_instrumentation(RPM_CONTRIB_LIB+"/rpm_contrib/instrumentation/**/*.rb")
+
+      # Load all the Sampler class definitions.  These will register
+      # automatically with the agent.
+      Dir.glob(RPM_CONTRIB_LIB + "/rpm_contrib/samplers/**/*.rb") { |file| require file }
+    end
+  end
+
+end
+
+# Perform any framework/dispatcher detection before loading the rpm gem.
+raise "The rpm_contrib gem must be loaded before the newrelic_rpm gem." if defined?(::NewRelic)
+
+Dir.glob(RPM_CONTRIB_LIB + "/rpm_contrib/detection/**/*.rb") { |file| require file }
+
+require 'newrelic_rpm'
+
+if defined? Rails
+  # Rails 3.x+
+  if Rails.respond_to?(:version) && Rails.version =~ /^3/
+    module NewRelic
+      class Railtie < Rails::Railtie
+        initializer("rpm_contrib.start_plugin", &RPMContrib.init_sequence)
+      end
+    end
+  # Rails 2.x
+  elsif defined?(Rails) && Rails.respond_to?(:configuration)
+    Rails.configuration.after_initialize &RPMContrib.init_sequence
+  else
+    raise "The rpm_contrib gem supports Rails 2.2+ only."
+  end
+else
+  RPMContrib.init_sequence.call
+end

data/lib/rpm_contrib/detection/backgrounded_resque.rb

@@ -0,0 +1,15 @@
+# Detect when running backgrounded with resque and set the framework and dispatcher.
+
+module NewRelic
+  class LocalEnvironment
+    module BackgroundedResque
+      def discover_dispatcher
+        super
+        if defined?(::Backgrounded::Handler::ResqueHandler) && @dispatcher.nil?
+          @dispatcher = 'backgrounded_resque'
+        end
+      end
+    end
+  end
+end
+

data/lib/rpm_contrib/detection/camping.rb

@@ -0,0 +1,24 @@
+module NewRelic #:nodoc:
+  # The class defined in the
+  # newrelic_rpm[http://newrelic.github.com/rpm] which can be ammended
+  # to support new frameworks by defining modules in this namespace.
+  class LocalEnvironment #:nodoc:
+    module Camping
+      def discover_framework
+        if defined?(::Camping)
+          puts "framework is camping"
+          @framework = 'camping'
+        else
+          super
+        end
+      end
+      def discover_dispatcher
+        super
+        if defined?(::Camping) && @dispatcher.nil?
+          @dispatcher = 'camping'
+        end
+      end
+    end
+  end
+end
+

data/lib/rpm_contrib/detection/resque.rb

@@ -0,0 +1,15 @@
+# Detect when running under camping and set the framework and dispatcher.
+
+module NewRelic
+  class LocalEnvironment
+    module Resque
+      def discover_dispatcher
+        super
+        if defined?(::Resque::Worker) && @dispatcher.nil?
+          @dispatcher = 'resque'
+        end
+      end
+    end
+  end
+end
+

data/lib/rpm_contrib/instrumentation/aws/s3.rb

@@ -0,0 +1,56 @@
+# Instrumentation for the AWS-S3 gem for New Relic RPM by Brian Doll
+if defined?(::AWS::S3) && !NewRelic::Control.instance['disable_aws-s3']
+
+  # Instrument connections to the AWS-S3 service
+  ::AWS::S3::Connection::Management::ClassMethods.module_eval do
+    add_method_tracer :establish_connection!, 'AWS-S3/establish_connection!'
+  end
+
+  # Instrument methods on Bucket
+  ::AWS::S3::Bucket.instance_eval do
+    class << self
+      add_method_tracer :create,  'AWS-S3/Bucket/create'
+      add_method_tracer :find,    'AWS-S3/Bucket/find'
+      add_method_tracer :objects, 'AWS-S3/Bucket/objects'
+      add_method_tracer :delete,  'AWS-S3/Bucket/delete'
+      add_method_tracer :list,    'AWS-S3/Bucket/list'
+    end
+  end
+
+  # Instrument methods on Bucket instances
+  ::AWS::S3::Bucket.class_eval do
+    add_method_tracer :[],        'AWS-S3/Bucket/#{self.name}/[]'
+    add_method_tracer :new_object,'AWS-S3/Bucket/#{self.name}/new_objects'
+    add_method_tracer :objects,   'AWS-S3/Bucket/#{self.name}/objects'
+    add_method_tracer :delete,    'AWS-S3/Bucket/#{self.name}/delete'
+    add_method_tracer :delete_all,'AWS-S3/Bucket/#{self.name}/delete_all'
+    add_method_tracer :update,    'AWS-S3/Bucket/#{self.name}/update'
+  end
+
+  # Instrument methods on S3Object
+  ::AWS::S3::S3Object.instance_eval do
+    class << self
+      add_method_tracer :about,   'AWS-S3/S3Object/about'
+      add_method_tracer :copy,    'AWS-S3/S3Object/copy'
+      add_method_tracer :delete,  'AWS-S3/S3Object/delete'
+      add_method_tracer :rename,  'AWS-S3/S3Object/rename'
+      add_method_tracer :store,   'AWS-S3/S3Object/store'
+    end
+  end
+
+  # Instrument methods on S3Object instances
+  # Metric names are aggregated across all S3Objects since having a metric for
+  # every single S3Object instance and method pair would be fairly useless
+  ::AWS::S3::S3Object.class_eval do
+    add_method_tracer :value,     'AWS-S3/S3Objects/value'
+    add_method_tracer :about,     'AWS-S3/S3Objects/about'
+    add_method_tracer :metadata,  'AWS-S3/S3Objects/metadata'
+    add_method_tracer :store,     'AWS-S3/S3Objects/store'
+    add_method_tracer :delete,    'AWS-S3/S3Objects/delete'
+    add_method_tracer :copy,      'AWS-S3/S3Objects/copy'
+    add_method_tracer :rename,    'AWS-S3/S3Objects/rename'
+    add_method_tracer :etag,      'AWS-S3/S3Objects/etag'
+    add_method_tracer :owner,     'AWS-S3/S3Objects/owner'
+  end
+  
+end

data/lib/rpm_contrib/instrumentation/backgrounded_resque.rb

@@ -0,0 +1,35 @@
+
+module RPMContrib
+  module Instrumentation
+    # == Backgrounded Resque Instrumentation
+    #
+    # Installs a hook to ensure the agent starts manually when the worker
+    # starts and also adds the tracer to the process method which executes
+    # in the forked task.
+    module BackgroundedResqueInstrumentation
+      ::Resque::Job.class_eval do
+        include NewRelic::Agent::Instrumentation::ControllerInstrumentation
+        
+        old_perform_method = instance_method(:perform)
+
+        define_method(:perform) do
+          class_name = args.first
+          method = args[1]
+          NewRelic::Agent.reset_stats if NewRelic::Agent.respond_to? :reset_stats
+          perform_action_with_newrelic_trace(:name => method, :class_name => class_name, :params => @payload,
+                                             :category => 'OtherTransaction/BackgroundedResqueJob') do
+            old_perform_method.bind(self).call
+          end
+
+          NewRelic::Agent.shutdown unless defined?(::Resque.before_child_exit)
+        end
+      end
+
+      if defined?(::Resque.before_child_exit)
+        ::Resque.before_child_exit do |worker|
+          NewRelic::Agent.shutdown
+        end
+      end
+    end
+  end
+end if defined?(::Backgrounded::Handler::ResqueHandler) and not NewRelic::Control.instance['disable_backgrounded_resque']

data/lib/rpm_contrib/instrumentation/camping.rb

@@ -0,0 +1,53 @@
+require 'new_relic/agent/instrumentation/controller_instrumentation'
+
+module RPMContrib
+  module Instrumentation
+    # == Instrumentation for Camping
+    # To instrument all controllers do the following:
+    # 1. Add require 'rpm_contrib' after loading camping.
+    # 2. Add an include at the end of your main Camping app module
+    # 3. Run the following command to get the NewRelic license key to use: heroku config -all
+    # 4. Create a newrelic.yml under the /config folder with the following content:
+    #
+    #	 common: &default_settings
+    #       license_key: 'PASTE THE VALUE OF NEW_RELIC_LICENSE_KEY HERE'
+    #	    app_name: PASTE THE NAME OF YOUR CAMPING APP HERE
+    #	    monitor_mode: true
+    #
+    #	 production:
+    #       <<: *default_settings
+    #
+    # Camping code example:
+    # -------------------------------------------------------------------------------------
+    #
+    #	require "newrelic_rpm"
+    #
+    #	Camping.goes :NewRelicCampingTest
+    #
+    #	module NewRelicCampingTest
+    #	  # your code
+    #
+    #	  include NewRelic::Agent::Instrumentation::Camping
+    #
+    #	end
+    #
+    #
+    
+    module Camping
+      
+      def self.included(mod)
+        
+        # Since the Camping::Base module is essentially copied
+        # into the main module (the mod passed in) of a Camping app 
+        # using the Camping.goes :NewRelicCampingTest syntax
+        # we need to evaluate "weld" the NewRelic plugin in the context of the new Base
+        
+        (Kernel.const_get(mod.name)::Base).module_eval do
+          include NewRelic::Agent::Instrumentation::ControllerInstrumentation
+          add_transaction_tracer :service
+        end
+      end
+      
+    end	#RPMContrib::Instrumentation::Camping
+  end
+end

data/lib/rpm_contrib/instrumentation/cassandra.rb

@@ -0,0 +1,23 @@
+# == Cassandra Instrumentation
+#
+
+if defined?(::Cassandra) and not  NewRelic::Control.instance['disable_cassandra_instrumentation']
+  
+  ::Cassandra.class_eval do
+    add_method_tracer :insert,               'Database/Cassandra/insert'
+    add_method_tracer :remove,               'Database/Cassandra/remove'
+    add_method_tracer :clear_column_family!, 'Database/Cassandra/clear_column_family!'
+    add_method_tracer :clear_keyspace!,      'Database/Cassandra/clear_keyspace!'
+    add_method_tracer :count_columns,        'Database/Cassandra/count_columns'
+    add_method_tracer :multi_count_columns,  'Database/Cassandra/multi_count_columns'
+    add_method_tracer :get_columns,          'Database/Cassandra/get_columns'
+    add_method_tracer :multi_get_columns,    'Database/Cassandra/multi_get_columns'
+    add_method_tracer :get,                  'Database/Cassandra/get'
+    add_method_tracer :multi_get,            'Database/Cassandra/multi_get'
+    add_method_tracer :exists?,              'Database/Cassandra/exists?'
+    add_method_tracer :get_range,            'Database/Cassandra/get_range'
+    add_method_tracer :count_range,          'Database/Cassandra/count_range'
+    add_method_tracer :batch,                'Database/Cassandra/batch'
+  end
+
+end

data/lib/rpm_contrib/instrumentation/mongo_mapper.rb

@@ -0,0 +1,44 @@
+if defined?(::MongoMapper) && !NewRelic::Control.instance['disable_mongodb']
+  
+  module RPMContrib::Instrumentation
+    # Just drop this little diddy in your app to get some (not perfect) information
+    # on query times and such.
+    #
+    # Currently only MongoMapper is implemented
+    module MongoMapper
+      def self.included(model)
+        model.metaclass.class_eval do
+          add_method_tracer :find,        'Database/#{self.name}/find'
+          add_method_tracer :find!,       'Database/#{self.name}/find!'
+          add_method_tracer :paginate,    'Database/#{self.name}/paginate'
+          add_method_tracer :first,       'Database/#{self.name}/first'
+          add_method_tracer :last,        'Database/#{self.name}/last'
+          add_method_tracer :all,         'Database/#{self.name}/all'
+          add_method_tracer :count,       'Database/#{self.name}/count'
+          add_method_tracer :create,      'Database/#{self.name}/create'
+          add_method_tracer :create!,     'Database/#{self.name}/create!'
+          add_method_tracer :update,      'Database/#{self.name}/update'
+          add_method_tracer :delete,      'Database/#{self.name}/delete'
+          add_method_tracer :delete_all,  'Database/#{self.name}/delete_all'
+          add_method_tracer :destroy,     'Database/#{self.name}/destroy'
+          add_method_tracer :destroy_all, 'Database/#{self.name}/destroy_all'
+          add_method_tracer :exists?,     'Database/#{self.name}/exists?'
+          add_method_tracer :find_by_id,  'Database/#{self.name}/find_by_id'
+          add_method_tracer :increment,   'Database/#{self.name}/increment'
+          add_method_tracer :decrement,   'Database/#{self.name}/decrement'
+          add_method_tracer :set,         'Database/#{self.name}/set'
+          add_method_tracer :push,        'Database/#{self.name}/push'
+          add_method_tracer :push_all,    'Database/#{self.name}/push_all'
+          add_method_tracer :push_uniq,   'Database/#{self.name}/push_uniq'
+          add_method_tracer :pull,        'Database/#{self.name}/pull'
+          add_method_tracer :pull_all,    'Database/#{self.name}/pull_all'
+        end
+        
+        model.class_eval do
+          add_method_tracer :save,        'Database/#{self.class.name}/save'
+        end
+      end
+    end
+    ::MongoMapper::Document.append_inclusions(::RPMContrib::Instrumentation::MongoMapper)
+  end 
+end

data/lib/rpm_contrib/instrumentation/mongoid.rb

@@ -0,0 +1,53 @@
+if defined?(::Mongoid) && !NewRelic::Control.instance['disable_mongodb']
+
+  module Mongoid #:nodoc:
+    module Document
+
+      #adding call to super
+      class << self
+        alias :old_included :included
+
+        def included(model)
+          old_included(model)
+          super
+        end
+      end
+    end
+  end
+
+  module RPMContrib::Instrumentation
+
+    module Mongoid
+      def included(model)
+        model.metaclass.class_eval do
+          puts "adding mongoid method tracers for #{model.name}"
+          add_method_tracer :create, 'Database/#{self.name}/create'
+          add_method_tracer :create!, 'Database/#{self.name}/create!'
+          add_method_tracer :delete_all, 'Database/#{self.name}/delete_all'
+          add_method_tracer :destroy_all, 'Database/#{self.name}/destroy_all'
+          add_method_tracer :all, 'Database/#{self.name}/all'
+          add_method_tracer :find, 'Database/#{self.name}/find'
+          add_method_tracer :first, 'Database/#{self.name}/first'
+          add_method_tracer :last, 'Database/#{self.name}/last'
+          add_method_tracer :find_or_create_by, 'Database/#{self.name}/find_or_create_by'
+          add_method_tracer :find_or_initialize_by, 'Database/#{self.name}/find_or_initialize_by'
+          add_method_tracer :min, 'Database/#{self.name}/min'
+          add_method_tracer :max, 'Database/#{self.name}/max'
+          add_method_tracer :sum, 'Database/#{self.name}/sum'
+        end
+
+        model.class_eval do
+          add_method_tracer :update_attributes, 'Database/#{self.class.name}/update_attributes'
+          add_method_tracer :update_attributes!, 'Database/#{self.class.name}/update_attributes!'
+          add_method_tracer :save, 'Database/#{self.class.name}/save'
+          add_method_tracer :save!, 'Database/#{self.class.name}/save!'
+          add_method_tracer :delete, 'Database/#{self.class.name}/delete'
+          add_method_tracer :destroy, 'Database/#{self.class.name}/destroy'
+
+        end
+        super
+      end
+    end
+    ::Mongoid::Document.extend(RPMContrib::Instrumentation::Mongoid)
+  end
+end

data/lib/rpm_contrib/instrumentation/paperclip.rb

@@ -0,0 +1,22 @@
+# Paperclip Instrumentation.
+ 
+if defined?(::Paperclip) && !NewRelic::Control.instance['disable_paperclip']
+ 
+  ::Paperclip::Attachment.class_eval do
+    add_method_tracer :save, 'Paperclip/#{name}/save'
+    add_method_tracer :assign, 'Paperclip/#{name}/assign'
+    add_method_tracer :post_process, 'Paperclip/#{name}/post_process'
+  end
+ 
+  ::Paperclip::Storage::Filesystem.class_eval do
+    add_method_tracer :flush_deletes, 'Paperclip/Storage/flush_deletes' 
+    add_method_tracer :flush_writes, 'Paperclip/Storage/flush_writes'                            
+  end
+ 
+  ::Paperclip::Storage::S3.class_eval do
+    add_method_tracer :flush_deletes, 'Paperclip/Storage/flush_deletes' 
+    add_method_tracer :flush_writes, 'Paperclip/Storage/flush_writes'                            
+  end
+  
+end
+  

data/lib/rpm_contrib/instrumentation/redis.rb

@@ -0,0 +1,33 @@
+# Redis instrumentation contributed by Ashley Martens of ngmoco
+#
+
+if defined?(::Redis) and not  NewRelic::Control.instance['disable_redis']
+
+
+  Redis::Client.class_eval do
+    
+    include NewRelic::Agent::MethodTracer
+
+    def self.redis_call_method                                                          
+      Redis::Client.new.respond_to?(:call) ? :call : :raw_call_command
+    end
+
+    
+    def raw_call_command_with_newrelic_trace *args
+      method_name = args[0].is_a?(Array) ? args[0][0] : args[0]
+      metrics = ["Database/Redis/#{method_name}",
+                 (NewRelic::Agent::Instrumentation::MetricFrame.recording_web_transaction? ? 'Database/Redis/allWeb' : 'Database/Redis/allOther')]
+      self.class.trace_execution_scoped(metrics) do
+        # NewRelic::Control.instance.log.debug("Instrumenting Redis Call[#{method_name}]: #{args[0].inspect}")
+        raw_call_command_without_newrelic_trace(*args)
+      end
+    end
+
+    alias_method :raw_call_command_without_newrelic_trace, redis_call_method
+    alias_method redis_call_method, :raw_call_command_with_newrelic_trace
+    
+  end
+
+
+
+end

data/lib/rpm_contrib/instrumentation/resque.rb

@@ -0,0 +1,34 @@
+
+module RPMContrib
+  module Instrumentation
+    # == Resque Instrumentation
+    #
+    # Installs a hook to ensure the agent starts manually when the worker
+    # starts and also adds the tracer to the process method which executes
+    # in the forked task.
+    module ResqueInstrumentation
+      ::Resque::Job.class_eval do
+        include NewRelic::Agent::Instrumentation::ControllerInstrumentation
+        
+        old_perform_method = instance_method(:perform)
+
+        define_method(:perform) do
+          class_name = (payload_class ||self.class).name
+          NewRelic::Agent.reset_stats if NewRelic::Agent.respond_to? :reset_stats
+          perform_action_with_newrelic_trace(:name => 'perform', :class_name => class_name,
+                                             :category => 'OtherTransaction/ResqueJob') do
+            old_perform_method.bind(self).call
+          end
+
+          NewRelic::Agent.shutdown unless defined?(::Resque.before_child_exit)
+        end
+      end
+
+      if defined?(::Resque.before_child_exit)
+        ::Resque.before_child_exit do |worker|
+          NewRelic::Agent.shutdown
+        end
+      end
+    end
+  end
+end if defined?(::Resque::Job) and not NewRelic::Control.instance['disable_resque']

data/test/helper.rb

@@ -0,0 +1,9 @@
+require 'rubygems'
+require 'test/unit'
+
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+#$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+
+require File.expand_path("../../lib/rpm_contrib.rb", __FILE__)
+
+require 'schema.rb'

data/test/schema.rb

@@ -0,0 +1,19 @@
+# Use this file to add tables you need to do testing
+# These are created in a sqllite memory DB
+
+begin
+  require 'sqlite3'
+  require 'active_record'
+  
+  ActiveRecord::Base.establish_connection(:adapter => 'sqlite3', :database => ':memory:')
+  ActiveRecord::Migration.verbose = false
+
+  ActiveRecord::Schema.define do
+
+    create_table :stories, :force => true do |table|
+      table.string :text
+    end
+  end
+rescue LoadError
+  # Skip AR tests
+end

data/test/test_mongoid.rb

@@ -0,0 +1,42 @@
+require "#{File.dirname(__FILE__)}/helper"
+begin
+  require 'mongoid'
+rescue LoadError
+end
+
+require "#{File.dirname(__FILE__)}/../lib/rpm_contrib/instrumentation/mongoid"
+
+if defined?(::Mongoid)
+  
+  Mongoid.configure do |config|
+    config.master = Mongo::Connection.new.db('animals')
+  end
+
+  class Dog
+    include Mongoid::Document
+
+    field :name
+  end
+
+  class MongoidTest < Test::Unit::TestCase
+
+    # Called before every test method runs. Can be used
+    # to set up fixture information.
+    def setup
+      # Do nothing
+    end
+
+    # Called after every test method runs. Can be used to tear
+    # down fixture information.
+
+    def teardown
+      # Do nothing
+    end
+
+    # Fake test
+    def test_fail
+      Dog.create!(:name=>'rover')
+
+    end
+  end
+end

data/test/test_redis.rb

@@ -0,0 +1,34 @@
+require "#{File.dirname(__FILE__)}/helper"
+begin
+  require 'redis'
+  require 'ruby-debug'
+rescue LoadError
+end
+
+require "#{File.dirname(__FILE__)}/../lib/rpm_contrib/instrumentation/redis"
+
+if defined?(::Redis)
+  
+
+  class RedisTest < Test::Unit::TestCase
+
+    # Called before every test method runs. Can be used
+    # to set up fixture information.
+    def setup
+      # Do nothing
+    end
+
+    # Called after every test method runs. Can be used to tear
+    # down fixture information.
+
+    def teardown
+      # Do nothing
+    end
+
+    # Fake test
+    def test_fail
+      
+
+    end
+  end
+end

metadata

@@ -0,0 +1,118 @@
+--- !ruby/object:Gem::Specification 
+name: wireframe-rpm_contrib
+version: !ruby/object:Gem::Version 
+  hash: 109
+  prerelease: false
+  segments: 
+  - 1
+  - 0
+  - 12
+  - 1
+  version: 1.0.12.1
+platform: ruby
+authors: 
+- Bill Kayser
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-10-01 00:00:00 -05:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: newrelic_rpm
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 57
+        segments: 
+        - 2
+        - 13
+        - 1
+        version: 2.13.1
+  type: :runtime
+  version_requirements: *id001
+description: |
+  Community contributed instrumentation for various frameworks based on
+  the New Relic Ruby monitoring gem newrelic_rpm.
+
+email: support@newrelic.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- CHANGELOG
+- LICENSE
+- README.md
+files: 
+- CHANGELOG
+- LICENSE
+- README.md
+- Rakefile
+- lib/new_relic/control/camping.rb
+- lib/rpm_contrib.rb
+- lib/rpm_contrib/detection/backgrounded_resque.rb
+- lib/rpm_contrib/detection/camping.rb
+- lib/rpm_contrib/detection/resque.rb
+- lib/rpm_contrib/instrumentation/aws/s3.rb
+- lib/rpm_contrib/instrumentation/backgrounded_resque.rb
+- lib/rpm_contrib/instrumentation/camping.rb
+- lib/rpm_contrib/instrumentation/cassandra.rb
+- lib/rpm_contrib/instrumentation/mongo_mapper.rb
+- lib/rpm_contrib/instrumentation/mongoid.rb
+- lib/rpm_contrib/instrumentation/paperclip.rb
+- lib/rpm_contrib/instrumentation/redis.rb
+- lib/rpm_contrib/instrumentation/resque.rb
+- test/helper.rb
+- test/schema.rb
+- test/test_mongoid.rb
+- test/test_redis.rb
+has_rdoc: true
+homepage: http://github.com/newrelic/rpm_contrib
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+- --line-numbers
+- --inline-source
+- --title
+- Contributed Instrumentation for New Relic RPM
+- -m
+- README.md
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Contributed Instrumentation for New Relic RPM
+test_files: 
+- test/helper.rb
+- test/schema.rb
+- test/test_mongoid.rb
+- test/test_redis.rb