seanwalbran-rpm_contrib 2.1.6.1

data/CHANGELOG

@@ -0,0 +1,133 @@
+
+* Version 2.1.6.1
+  - Merge upstream 2.1.6 with socialcast fork
+  - Avoid failures due to aws s3 instrumentation expecting a different flavor of aws s3
+
+* Version 2.1.6
+  Community contributed instrumentation
+  - ThinkingSphinx instrumentation (W. Andrew Loe III)
+  - Riak instrumentation (Bryce Kerley)
+  - KyotoTycoon instrumentation (Keisuke Kawahara)
+  Community Contributed Bug Fixes
+  - MongoDB instrumentation (Kenn Ejima)
+  - Yajl instrumentation (Chris Griego)
+  - UltraSphinx instrumentation (Jonathan Rudenberg)
+  Renamed ActiveMQ instrumentation to ActiveMessaging (W. Andrew Loe III)
+
+* Version 2.1.5
+
+  Changed the resque detection so it does not depend on the load
+  order of resque => rpm_contrib => newrelic_rpm.  The gems can be
+  installed in any order.
+
+* Version 2.1.4
+
+  Updated requirements to latest agent with some bug fixes for background jobs
+  Converted instrumentation to install with DependencyDetection in the latest Agent
+  Changed Resque instrumentation from a plugin back to method chaining
+  Fixed several reported bugs related to resque
+
+* Version 2.1.3
+
+  Fixed typo in Resque instrumentation
+  Fixed double loading of AWS instrumentation
+
+* Version 2.1.2
+
+  Add a manual shutdown to the Resque instrumentation to make sure data is saved and sent - thanks to Jade Rubick
+
+* Version 2.1.1
+
+  Fix namespacing problem with Resque
+  Add instrumentation to Mongo::Cursor #refresh and #close - thanks to Chris Griego
+
+* Version 2.1.0
+
+  Included instrumentation from the community:
+  - Alexey Palazhchenko - mongo ORM-agnostic instrumentation
+  - Michael Breen - Elastic Search
+  - Paul Ingles - Sinatra Template instrumentation
+  - Siddharth Dawara - Typhoeus instrumentation
+  - Rob Meyer - ActiveMQ instrumentation
+  - Greg Hazel - Curb instrumentation
+  - Ben Poweski - Crack and Yajl instrumentation
+  - Chad Ingram and Scott Fleckenstein - Workling instrumentation
+  - Adam Weller - UltraSphinx instrumentation
+  - Liron Yahdav - work on the Resque instrumentation
+
+* Version 2.0.1
+
+  Fixed an error with Bundler and RubyGems 1.8.2 which caused the gem to always fail to load
+
+* Version 2.0.0
+
+  Updated to use the latest version of the Ruby Agent
+
+* Version 1.0.13
+
+  Removed use of 'metaclass' - no longer available from ActiveSupport as of Rails 3
+  Contributed by Chris Griego
+
+* Version socialcast-1.0.12.7
+
+  Add support for resque jobs running in backgrounded
+
+* 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/Gemfile

@@ -0,0 +1,13 @@
+source :rubygems
+
+gem 'newrelic_rpm', '>=3.1.1'
+
+group :test do
+  gem 'resque'
+  gem 'json'
+  gem 'mocha'
+end
+
+group :build do
+  gem 'jeweler'
+end

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,293 @@
+# 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 when using Bundler, add these dependencies to your Gemfile:
+
+    gem 'rpm_contrib'
+    gem 'newrelic_rpm'
+
+For Rails 2.1 and later, add these dependencies to your in your environment.rb:
+
+    config.gem 'rpm_contrib'
+    config.gem 'newrelic_rpm'
+
+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`. 
+
+In non-Rails frameworks, it's important that the New Relic Agent gets
+loaded as late as possible, or that the final initialization hook is called 
+after all other frameworks have loaded:
+
+    DependencyDetection.detect!
+
+### Troubleshooting Startup
+
+If you've set up your gems to load as described above and you are still not seeing 
+data in RPM, there may be a bug in detecting your framework.  Try setting the 
+environment variable `NEWRELIC_DISPATCHER` to the name of your app server (Camping, 
+Resque, Rake, etc), and please report to us if this fixes the problem so we can
+fix the auto-detection logic.
+
+If this does not help then set the `log_level` to `debug` in the `newrelic.yml` file
+and examine the `newrelic_agent.log` file for errors after restarting your app.
+
+## 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.
+
+### ActiveMessaging
+
+The gem will detect the underlying ActiveMessaging::Processor class and instrument the `on_message` method
+
+It can be disabled with the `disable_active_messaging` flag in your newrelic.yml file.
+
+### Cassandra
+
+The gem will instrument Cassandra so it should be visible in transaction traces and the web transactions page.
+
+You can disable it with `disable_cassandra_instrumentation` in your newrelic.yml file.
+
+### 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. 
+
+In addition you will need to load the gems in the following order: 1) Camping, 2) rpm_contrib,
+3) newrelic_rpm.
+
+### Crack
+
+The gem will instrument the Crack parsers for JSON and XML - you
+should see them in transaction traces and the web transactions page.
+
+You can disable it with `disable_crack` in your newrelic.yml file.
+
+### Curb
+
+The gem will instrument both Curl::Easy and Curl::Multi - they should show up similarly to Net::HTTP in the UI
+
+You can disable it with `disable_curb` in your newrelic.yml file.
+
+## Elastic Search
+
+The gem will instrument ElasticSearch::Client. The metrics should show up in the UI
+
+You can disable it with `disable_elastic_search_instrumentation` in your newrelic.yml file.
+
+## KyotoTycoon
+
+The gem will instrument KyotoTycoon.
+
+You can disable it with `disable_kyototycoon` in your newrelic.yml file.
+
+### Paperclip
+
+No special configuration required for Paperclip visibility.  
+
+You can disable it by setting `disable_paperclip` to true in your newrelic.yml file.
+
+### Picky
+
+The gem will instrument the [Picky semantic search engine](http://florianhanke.com/picky/) so it should be visible in transaction traces and the web transactions page.
+
+You can disable it with `disable_picky` in your newrelic.yml file.
+
+### MongoDB
+
+Our instrumentation works on the underlying 'Mongo' library.  
+
+You can disable it by setting 'disable_mongodb' to true in your newrelic.yml file.
+
+### Resque
+
+To instrument jobs you no longer need to have your Job class inherit from Resque::Job or include 
+the Resque::Plugins::NewRelicInstrumentation module.  The module definition was left in for 
+backward compatibility.
+
+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.
+
+### Riak
+
+RiakClient is instrumented.  Its opereations are recorded under Database in the
+the response time graph.
+
+To disable Riak instrumentation, set 'disable_riak_client' to true in your newrelic.yml file.
+
+### Ripple
+
+Ripple is instrumented.  Its opereations are recorded under Database in the
+the response time graph.
+
+To disable Riak instrumentation, set 'disable_ripple' to true in your newrelic.yml file.
+
+### Sinatra view instrumentation
+
+This adds instrumentation to the `render` methods in Sinatra::Base
+
+You can disable it with `disable_sinatra_template` in your newrelic.yml file.
+
+### ThinkingSphinx instrumentation
+
+This adds instrumentation to the `initialize` and `results` method of ThinkingSphinx::Search
+
+You can disable it with `disable_thinking_sphinx` in your newrelic.yml file.
+
+
+### Typhoeus instrumentation
+
+This adds instrumentation to the Typhoeus::Request class for 'GET' requests
+
+You can disable it with `disable_typhoeus` in your newrelic.yml file.
+
+### Ultrasphinx instrumentation
+
+This adds basic instrumentation to the `run` and `results` method of Ultrasphinx::Search
+
+You can disable it with `disable_ultrasphinx` in your newrelic.yml file.
+
+### Workling
+
+This adds instrumentation to the Workling::Base and all children, for all defined public methods not inherited from the Workling::Base class
+
+You can disable it with `disable_workling` in your newrelic.yml file.
+
+### YAJL
+
+This adds instrumentation to the YAJL json parser
+
+You can disable it with `disable_yajl_instrumentation` 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.
+* Update README.md
+* 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,79 @@
+require 'rubygems'
+require "bundler/setup"
+require 'rake'
+# See http://www.rubygems.org/read/chapter/20 
+
+def version
+  @rpm_contrib_version ||= File.read("CHANGELOG")[/Version ([\d\.]+\w*)$/, 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 = "seanwalbran-rpm_contrib"
+    gem.summary = SUMMARY
+    gem.description = DESCRIPTION
+    gem.email = "support@newrelic.com"
+    gem.homepage = "http://github.com/newrelic/rpm_contrib"
+    gem.authors = [ "Bill Kayser", "Jon Guymon" ]
+    gem.add_dependency 'newrelic_rpm', '>=3.1.1'
+    gem.version = version
+    gem.files = FileList['LICENSE', 'README*', 'lib/**/*.rb', 'bin/*', '[A-Z]*', 'test/**/*'].to_a
+    gem.files.exclude *File.read(File.join(File.dirname(__FILE__), '.gitignore')).split
+    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/agent_compatibility.rb

@@ -0,0 +1,11 @@
+if NewRelic::VERSION::STRING < '3.2.0'
+  module DependencyDetection
+    def self.dependency_by_name(name)
+      @@items.find {|i| i.name == name }
+    end
+
+    class Dependent
+      attr_reader :name
+    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 amended
+  # 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.rb

@@ -0,0 +1,5 @@
+# Currently the only framework we are detecting with an agent
+# patch is camping.  You need to specify the camping gem prior
+# to the contrib gem and newrelic agent gem in order for this to work.
+require 'rpm_contrib/detection/camping'
+

data/lib/rpm_contrib/instrumentation/active_messaging.rb

@@ -0,0 +1,22 @@
+# ActiveMessaging Instrumentation
+
+DependencyDetection.defer do
+  @name = :active_messaging
+
+  depends_on do
+    defined?(::ActiveMessaging::Processor) && !NewRelic::Control.instance['disable_active_messaging'] &&
+      !NewRelic::Control.instance['disable_active_mq']
+  end
+
+  executes do
+    NewRelic::Agent.logger.debug 'Installing ActiveMessaging instrumentation'
+  end
+
+  executes do
+    ::ActiveMessaging::Processor.class_eval do
+      include NewRelic::Agent::MethodTracer
+
+      add_method_tracer :on_message, 'ActiveMessaging/OnMessage'
+    end
+  end
+end

data/lib/rpm_contrib/instrumentation/aws.rb

@@ -0,0 +1,68 @@
+# AWS Instrumentation by Brian Doll of New Relic
+DependencyDetection.defer do
+  @name = :aws
+  
+  depends_on do
+    defined?(::AWS::S3) && defined?(::AWS::S3::Connection) && !NewRelic::Control.instance['disable_aws-s3']
+  end
+  
+  executes do
+    NewRelic::Agent.logger.debug 'Installing AWS instrumentation'
+  end
+
+  
+  executes do
+    # 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
+end
+