scout_apm 5.2.0 → 5.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 81ad3b683899407ed049b7267d6d79a84d5afac011445d1078f4342c345c7ace
-  data.tar.gz: 29e141854923fa21c57ca3fcc7ca9e4cc96dbd741c36c0586e7fd2cd7a8186f8
+  metadata.gz: 4a454dcd926d9c3d9a9432c43ee101bfb9305b2ed181193d55a51fd8d525f3d8
+  data.tar.gz: 9bfdbfb6852b7b933f83f947cb225fe1096083c6a4fe44a0620ff888ee01e26d
 SHA512:
-  metadata.gz: a857678f6d91c709fbbdfb30409339f37e99cd83260cec9d3808f81638245de03cf4b0721270203f0ee619cc56b06fc3baa795a10e859c3068e0e2c36a2247b2
-  data.tar.gz: 972da0997d251c5704291e60e390916a417de3036aadcada469540acd20520f4edd95b3b76da9202734755bc37c3a9a22e44916c23e74c9199d3c6a7a2447797
+  metadata.gz: 29012317cfdcb2958395ca541ec628d4f8d3d2ee5278428075930be30cb9fa445c23463cc11f32dab39649a5b34fd6caf6f981eee7c5c88ef1ade39c36e5806d
+  data.tar.gz: a45e503bcd08fa16cbc885133efcc2bbea64bf76eff6a9de7d5c35a7ddce4ea5a059904c902de6afacba0daba5128b62ce477565aecf2512391962cfea729623

data/.github/workflows/test.yml

@@ -35,7 +35,18 @@ jobs:
             gemfile: gems/rails3.gemfile
             bundler: 1.17.3
           - ruby: 2.7
+          - ruby: 2.7
+            prepend: true
+          - ruby: 3.0
+          - ruby: 3.0
+            prepend: true
+          - ruby: 3.0
+            gemfile: gems/instruments.gemfile
+            test_features: "instruments"
           - ruby: 3.0
+            gemfile: gems/instruments.gemfile
+            prepend: true
+            test_features: "instruments"
           - ruby: 3.0
             gemfile: gems/sidekiq.gemfile
             test_features: "sidekiq_install"
@@ -43,6 +54,7 @@ jobs:
     env:
       BUNDLE_GEMFILE: ${{ matrix.gemfile }}
       SCOUT_TEST_FEATURES: ${{ matrix.test_features }}
+      SCOUT_USE_PREPEND: ${{ matrix.prepend }}
 
     runs-on: ubuntu-latest
 

data/CHANGELOG.markdown

@@ -1,5 +1,13 @@
 # Unreleased
 
+# 5.3.0
+
+* Add configuraiton option to use `Module#prepend` instead of `Module#alias_method` (default)
+  for instrumentation (#448). The default method for instrumentation has not changed, but
+  configuration options were added to allow switching to `Module#prepend` for most
+  instrumentation. Refer to the documentation for more information:
+  [Library Instrumentation Method](https://scoutapm.com/docs/ruby/configuration#library-instrumentation-method)
+
 # 5.2.0
 
 * Use Sidekiq lifecycle hooks to start Scout agent on Sidekiq start. (#449)

data/gems/instruments.gemfile

@@ -0,0 +1,6 @@
+eval_gemfile("../Gemfile")
+
+gem 'httpclient'
+gem 'http'
+gem 'redis'
+gem 'moped'

data/lib/scout_apm/config.rb

@@ -35,7 +35,13 @@ require 'scout_apm/environment'
 # start_resque_server_instrument - Used in special situations with certain Resque installs
 # timeline_traces - true/false to enable sending of of the timeline trace format.
 # auto_instruments - true/false whether to install autoinstruments. Only installed if on a supported Ruby version.
-# auto_instruments_ignore - An array of file names to exclude from autoinstruments (Ex: ['application_controller']).
+# auto_instruments_ignore  - An array of file names to exclude from autoinstruments (Ex: ['application_controller']).
+# use_prepend              - Whether to apply instrumentation using Module#Prepend instead
+#                            of Module#alias_method (Default: false)
+# alias_method_instruments - If `use_prepend` is true, continue to use Module#alias_method for
+#                            any instruments listed in this array. Default: []
+# prepend_instruments      - If `use_prepend` is false, force using Module#prepend for any
+#                            instruments listed in this array. Default: []
 #
 # Any of these config settings can be set with an environment variable prefixed
 # by SCOUT_ and uppercasing the key: SCOUT_LOG_LEVEL for instance.
@@ -85,6 +91,9 @@ module ScoutApm
         'timeline_traces',
         'auto_instruments',
         'auto_instruments_ignore',
+        'use_prepend',
+        'alias_method_instruments',
+        'prepend_instruments',
 
         # Error Service Related Configuration
         'errors_enabled',
@@ -189,6 +198,9 @@ module ScoutApm
       'timeline_traces' => BooleanCoercion.new,
       'auto_instruments' => BooleanCoercion.new,
       'auto_instruments_ignore' => JsonCoercion.new,
+      'use_prepend' => BooleanCoercion.new,
+      'alias_method_instruments' => JsonCoercion.new,
+      'prepend_instruments' => JsonCoercion.new,
       'errors_enabled' => BooleanCoercion.new,
       'errors_ignored_exceptions' => JsonCoercion.new,
       'errors_filtered_params' => JsonCoercion.new,
@@ -305,6 +317,9 @@ module ScoutApm
         'timeline_traces' => true,
         'auto_instruments' => false,
         'auto_instruments_ignore' => [],
+        'use_prepend' => false,
+        'alias_method_instruments' => [],
+        'prepend_instruments' => [],
         'ssl_cert_file' => File.join( File.dirname(__FILE__), *%w[.. .. data cacert.pem] ),
         'errors_enabled' => false,
         'errors_ignored_exceptions' => %w(ActiveRecord::RecordNotFound ActionController::RoutingError),

data/lib/scout_apm/instrument_manager.rb

@@ -50,6 +50,23 @@ module ScoutApm
       (config.value("disabled_instruments") || []).include?(instrument_short_name)
     end
 
+    def prepend_for_instrument?(instrument_klass)
+      instrument_short_name = instrument_klass.name.split("::").last
+
+      # `use_prepend` defaults to false, which means we use `alias_method` by default.
+      # If `use_prepend` is `true`, then we should default to using `prepend` unless
+      # the instrument is explicitly listed in the `alias_method_instruments` config array.
+      if config.value("use_prepend")
+        return false if (config.value("alias_method_instruments") || []).include?(instrument_short_name)
+        return true
+      else
+        # `use_prepend` is false, but we should use `prepend` if the instrument is
+        # explicitly listed in the `prepend_instruments` array.
+        return true if (config.value("prepend_instruments") || []).include?(instrument_short_name)
+        return false
+      end
+    end
+
     private
 
     def install_instrument(instrument_klass)
@@ -62,7 +79,7 @@ module ScoutApm
 
       instance = instrument_klass.new(context)
       @installed_instruments << instance
-      instance.install
+      instance.install(prepend: prepend_for_instrument?(instrument_klass))
     end
 
     def already_installed?(instrument_klass)

data/lib/scout_apm/instruments/action_controller_rails_2.rb

@@ -16,7 +16,7 @@ module ScoutApm
         @installed
       end
 
-      def install
+      def install(prepend:)
         if defined?(::ActionController) && defined?(::ActionController::Base)
           @installed = true
 

data/lib/scout_apm/instruments/action_controller_rails_3_rails4.rb

@@ -21,7 +21,7 @@ module ScoutApm
         @installed = true
       end
 
-      def install
+      def install(prepend:)
         if !defined?(::ActiveSupport)
           return
         end

data/lib/scout_apm/instruments/action_view.rb

@@ -29,7 +29,7 @@ module ScoutApm
         context.environment.supports_module_prepend?
       end
 
-      def install
+      def install(prepend:)
         return unless defined?(::ActionView) && defined?(::ActionView::PartialRenderer)
 
         if prependable?

data/lib/scout_apm/instruments/active_record.rb

@@ -50,7 +50,7 @@ module ScoutApm
         @installed
       end
 
-      def install
+      def install(prepend:)
         if install_via_after_initialize?
           Rails.configuration.after_initialize do
             add_instruments

data/lib/scout_apm/instruments/elasticsearch.rb

@@ -18,66 +18,115 @@ module ScoutApm
         @installed
       end
 
-      def install
+      def install(prepend:)
         if defined?(::Elasticsearch) &&
             defined?(::Elasticsearch::Transport) &&
             defined?(::Elasticsearch::Transport::Client)
 
           @installed = true
 
-          logger.info "Instrumenting Elasticsearch"
+          logger.info "Instrumenting Elasticsearch. Prepend: #{prepend}"
 
-          ::Elasticsearch::Transport::Client.class_eval do
-            include ScoutApm::Tracer
+          if prepend
+            ::Elasticsearch::Transport::Client.send(:include, ScoutApm::Tracer)
+            ::Elasticsearch::Transport::Client.send(:prepend, ElasticsearchTransportClientInstrumentationPrepend)
+          else
+            ::Elasticsearch::Transport::Client.class_eval do
+              include ScoutApm::Tracer
 
-            def perform_request_with_scout_instruments(*args, &block)
-              name = _sanitize_name(args[1])
+              def perform_request_with_scout_instruments(*args, &block)
+                name = _sanitize_name(args[1])
 
-              self.class.instrument("Elasticsearch", name, :ignore_children => true) do
-                perform_request_without_scout_instruments(*args, &block)
+                self.class.instrument("Elasticsearch", name, :ignore_children => true) do
+                  perform_request_without_scout_instruments(*args, &block)
+                end
               end
-            end
 
-            alias_method :perform_request_without_scout_instruments, :perform_request
-            alias_method :perform_request, :perform_request_with_scout_instruments
-
-            def _sanitize_name(name)
-              name = name.split("/").last.gsub(/^_/, '')
-              allowed_names = ["bench",
-                               "bulk",
-                               "count",
-                               "exists",
-                               "explain",
-                               "field_stats",
-                               "health",
-                               "mget",
-                               "mlt",
-                               "mpercolate",
-                               "msearch",
-                               "mtermvectors",
-                               "percolate",
-                               "query",
-                               "scroll",
-                               "search_shards",
-                               "source",
-                               "suggest",
-                               "template",
-                               "termvectors",
-                               "update",
-                               "search", ]
-
-              if allowed_names.include?(name)
-                name
-              else
+              alias_method :perform_request_without_scout_instruments, :perform_request
+              alias_method :perform_request, :perform_request_with_scout_instruments
+
+              def _sanitize_name(name)
+                name = name.split("/").last.gsub(/^_/, '')
+                allowed_names = ["bench",
+                                "bulk",
+                                "count",
+                                "exists",
+                                "explain",
+                                "field_stats",
+                                "health",
+                                "mget",
+                                "mlt",
+                                "mpercolate",
+                                "msearch",
+                                "mtermvectors",
+                                "percolate",
+                                "query",
+                                "scroll",
+                                "search_shards",
+                                "source",
+                                "suggest",
+                                "template",
+                                "termvectors",
+                                "update",
+                                "search", ]
+
+                if allowed_names.include?(name)
+                  name
+                else
+                  "Unknown"
+                end
+              rescue
                 "Unknown"
               end
-            rescue
-              "Unknown"
             end
           end
         end
       end
     end
+
+    module ElasticsearchTransportClientInstrumentationPrepend
+      def perform_request(*args, &block)
+        name = _sanitize_name(args[1])
+
+        self.class.instrument("Elasticsearch", name, :ignore_children => true) do
+          super(*args, &block)
+        end
+      end
+
+      def _sanitize_name(name)
+        name = name.split("/").last.gsub(/^_/, '')
+        allowed_names = ["bench",
+                        "bulk",
+                        "count",
+                        "exists",
+                        "explain",
+                        "field_stats",
+                        "health",
+                        "mget",
+                        "mlt",
+                        "mpercolate",
+                        "msearch",
+                        "mtermvectors",
+                        "percolate",
+                        "query",
+                        "scroll",
+                        "search_shards",
+                        "source",
+                        "suggest",
+                        "template",
+                        "termvectors",
+                        "update",
+                        "search", ]
+
+        if allowed_names.include?(name)
+          name
+        else
+          "Unknown"
+        end
+      rescue
+        "Unknown"
+      end
+    end
   end
 end
 

data/lib/scout_apm/instruments/grape.rb

@@ -16,7 +16,7 @@ module ScoutApm
         @installed
       end
 
-      def install
+      def install(prepend:)
         if defined?(::Grape) && defined?(::Grape::Endpoint)
           @installed = true
 

data/lib/scout_apm/instruments/http.rb

@@ -16,33 +16,53 @@ module ScoutApm
         @installed
       end
 
-      def install
+      def install(prepend:)
         if defined?(::HTTP) && defined?(::HTTP::Client)
           @installed = true
 
-          logger.info "Instrumenting HTTP::Client"
+          logger.info "Instrumenting HTTP::Client. Prepend: #{prepend}"
 
-          ::HTTP::Client.class_eval do
-            include ScoutApm::Tracer
+          if prepend
+            ::HTTP::Client.send(:include, ScoutApm::Tracer)
+            ::HTTP::Client.send(:prepend, HTTPInstrumentationPrepend)
+          else
+            ::HTTP::Client.class_eval do
+              include ScoutApm::Tracer
 
-            def request_with_scout_instruments(verb, uri, opts = {})
-              self.class.instrument("HTTP", verb, :ignore_children => true, :desc => request_scout_description(verb, uri)) do
-                request_without_scout_instruments(verb, uri, opts)
+              def request_with_scout_instruments(verb, uri, opts = {})
+                self.class.instrument("HTTP", verb, :ignore_children => true, :desc => request_scout_description(verb, uri)) do
+                  request_without_scout_instruments(verb, uri, opts)
+                end
               end
-            end
 
-            def request_scout_description(verb, uri)
-              max_length = ScoutApm::Agent.instance.context.config.value('instrument_http_url_length')
-              (String(uri).split('?').first)[0..(max_length - 1)]
-            rescue
-              ""
-            end
+              def request_scout_description(verb, uri)
+                max_length = ScoutApm::Agent.instance.context.config.value('instrument_http_url_length')
+                (String(uri).split('?').first)[0..(max_length - 1)]
+              rescue
+                ""
+              end
 
-            alias request_without_scout_instruments request
-            alias request request_with_scout_instruments
+              alias request_without_scout_instruments request
+              alias request request_with_scout_instruments
+            end
           end
         end
       end
     end
+
+    module HTTPInstrumentationPrepend
+      def request(verb, uri, opts = {})
+        self.class.instrument("HTTP", verb, :ignore_children => true, :desc => request_scout_description(verb, uri)) do
+          super(verb, uri, opts)
+        end
+      end
+
+      def request_scout_description(verb, uri)
+        max_length = ScoutApm::Agent.instance.context.config.value('instrument_http_url_length')
+        (String(uri).split('?').first)[0..(max_length - 1)]
+      rescue
+        ""
+      end
+    end
   end
 end

data/lib/scout_apm/instruments/http_client.rb

@@ -16,33 +16,52 @@ module ScoutApm
         @installed
       end
 
-      def install
+      def install(prepend:)
         if defined?(::HTTPClient)
           @installed = true
 
-          logger.info "Instrumenting HTTPClient"
+          logger.info "Instrumenting HTTPClient. Prepend: #{prepend}"
 
-          ::HTTPClient.class_eval do
-            include ScoutApm::Tracer
+          if prepend
+            ::HTTPClient.send(:include, ScoutApm::Tracer)
+            ::HTTPClient.send(:prepend, HttpClientInstrumentationPrepend)
+          else
+            ::HTTPClient.class_eval do
+              include ScoutApm::Tracer
 
-            def request_with_scout_instruments(*args, &block)
+              def request_with_scout_instruments(*args, &block)
 
-              method = args[0].to_s
-              url = args[1]
+                method = args[0].to_s
+                url = args[1]
 
-              max_length = ScoutApm::Agent.instance.context.config.value('instrument_http_url_length')
-              url = url && url.to_s[0..(max_length - 1)]
+                max_length = ScoutApm::Agent.instance.context.config.value('instrument_http_url_length')
+                url = url && url.to_s[0..(max_length - 1)]
 
-              self.class.instrument("HTTP", method, :desc => url) do
-                request_without_scout_instruments(*args, &block)
+                self.class.instrument("HTTP", method, :desc => url) do
+                  request_without_scout_instruments(*args, &block)
+                end
               end
-            end
 
-            alias request_without_scout_instruments request
-            alias request request_with_scout_instruments
+              alias request_without_scout_instruments request
+              alias request request_with_scout_instruments
+            end
           end
         end
       end
     end
+
+    module HttpClientInstrumentationPrepend
+      def request(*args, &block)
+        method = args[0].to_s
+        url = args[1]
+
+        max_length = ScoutApm::Agent.instance.context.config.value('instrument_http_url_length')
+        url = url && url.to_s[0..(max_length - 1)]
+
+        self.class.instrument("HTTP", method, :desc => url) do
+          super(request, *args, &block)
+        end
+      end
+    end
   end
 end

data/lib/scout_apm/instruments/influxdb.rb

@@ -16,11 +16,11 @@ module ScoutApm
         @installed
       end
 
-      def install
+      def install(prepend:)
         if defined?(::InfluxDB)
           @installed = true
 
-          logger.debug "Instrumenting InfluxDB"
+          logger.debug "Instrumenting InfluxDB."
 
           ::InfluxDB::Client.class_eval do
             include ScoutApm::Tracer

data/lib/scout_apm/instruments/memcached.rb

@@ -16,28 +16,43 @@ module ScoutApm
         @installed
       end
 
-      def install
+      def install(prepend:)
         if defined?(::Dalli) && defined?(::Dalli::Client)
           @installed = true
 
-          logger.info "Instrumenting Memcached"
+          logger.info "Instrumenting Memcached. Prepend: #{prepend}"
 
-          ::Dalli::Client.class_eval do
-            include ScoutApm::Tracer
+          if prepend
+            ::Dalli::Client.send(:include, ScoutApm::Tracer)
+            ::Dalli::Client.send(:prepend, MemcachedInstrumentationPrepend)
+          else
+            ::Dalli::Client.class_eval do
+              include ScoutApm::Tracer
 
-            def perform_with_scout_instruments(*args, &block)
-              command = args.first rescue "Unknown"
+              def perform_with_scout_instruments(*args, &block)
+                command = args.first rescue "Unknown"
 
-              self.class.instrument("Memcached", command) do
-                perform_without_scout_instruments(*args, &block)
+                self.class.instrument("Memcached", command) do
+                  perform_without_scout_instruments(*args, &block)
+                end
               end
-            end
 
-            alias_method :perform_without_scout_instruments, :perform
-            alias_method :perform, :perform_with_scout_instruments
+              alias_method :perform_without_scout_instruments, :perform
+              alias_method :perform, :perform_with_scout_instruments
+            end
           end
         end
       end
     end
+
+    module MemcachedInstrumentationPrepend
+      def perform(*args, &block)
+        command = args.first rescue "Unknown"
+
+        self.class.instrument("Memcached", command) do
+          super(*args, &block)
+        end
+      end
+    end
   end
 end

data/lib/scout_apm/instruments/middleware_detailed.rb

@@ -24,7 +24,7 @@ module ScoutApm
         @installed
       end
 
-      def install
+      def install(prepend:)
         if defined?(ActionDispatch) && defined?(ActionDispatch::MiddlewareStack) && defined?(ActionDispatch::MiddlewareStack::Middleware)
           @installed = true
 

data/lib/scout_apm/instruments/middleware_summary.rb

@@ -21,7 +21,7 @@ module ScoutApm
         @installed
       end
 
-      def install
+      def install(prepend:)
         if defined?(ActionDispatch) && defined?(ActionDispatch::MiddlewareStack)
           @installed = true
 

data/lib/scout_apm/instruments/mongoid.rb

@@ -16,7 +16,7 @@ module ScoutApm
         @installed
       end
 
-      def install
+      def install(prepend:)
         @installed = true
 
         # Mongoid versions that use Moped should instrument Moped.

data/lib/scout_apm/instruments/moped.rb

@@ -16,32 +16,37 @@ module ScoutApm
         @installed
       end
 
-      def install
+      def install(prepend:)
         if defined?(::Moped)
           @installed = true
 
-          logger.info "Instrumenting Moped"
+          logger.info "Instrumenting Moped. Prepend: #{prepend}"
 
-          ::Moped::Node.class_eval do
-            include ScoutApm::Tracer
+          if prepend
+            ::Moped::Node.send(:include, ScoutApm::Tracer)
+            ::Moped::Node.send(:prepend, MopedInstrumentationPrepend)
+          else
+            ::Moped::Node.class_eval do
+              include ScoutApm::Tracer
 
-            def process_with_scout_instruments(operation, &callback)
-              if operation.respond_to?(:collection)
-                collection = operation.collection
-                name = "Process/#{collection}/#{operation.class.to_s.split('::').last}"
-                self.class.instrument("MongoDB", name, :annotate_layer => { :query => scout_sanitize_log(operation.log_inspect) }) do
-                  process_without_scout_instruments(operation, &callback)
+              def process_with_scout_instruments(operation, &callback)
+                if operation.respond_to?(:collection)
+                  collection = operation.collection
+                  name = "Process/#{collection}/#{operation.class.to_s.split('::').last}"
+                  self.class.instrument("MongoDB", name, :annotate_layer => { :query => scout_sanitize_log(operation.log_inspect) }) do
+                    process_without_scout_instruments(operation, &callback)
+                  end
                 end
               end
-            end
-            alias_method :process_without_scout_instruments, :process
-            alias_method :process, :process_with_scout_instruments
-
-            # replaces values w/ ?
-            def scout_sanitize_log(log)
-              return nil if log.length > 1000 # safeguard - don't sanitize large SQL statements
-              log.gsub(/(=>")((?:[^"]|"")*)"/) do
-                $1 + '?' + '"'
+              alias_method :process_without_scout_instruments, :process
+              alias_method :process, :process_with_scout_instruments
+
+              # replaces values w/ ?
+              def scout_sanitize_log(log)
+                return nil if log.length > 1000 # safeguard - don't sanitize large SQL statements
+                log.gsub(/(=>")((?:[^"]|"")*)"/) do
+                  $1 + '?' + '"'
+                end
               end
             end
           end
@@ -49,6 +54,26 @@ module ScoutApm
       end
 
     end
+
+    module MopedInstrumentationPrepend
+      def process(operation, &callback)
+        if operation.respond_to?(:collection)
+          collection = operation.collection
+          name = "Process/#{collection}/#{operation.class.to_s.split('::').last}"
+          self.class.instrument("MongoDB", name, :annotate_layer => { :query => scout_sanitize_log(operation.log_inspect) }) do
+            super(operation, &callback)
+          end
+        end
+      end
+
+      # replaces values w/ ?
+      def scout_sanitize_log(log)
+        return nil if log.length > 1000 # safeguard - don't sanitize large SQL statements
+        log.gsub(/(=>")((?:[^"]|"")*)"/) do
+          $1 + '?' + '"'
+        end
+      end
+    end
   end
 end
 

data/lib/scout_apm/instruments/net_http.rb

@@ -16,41 +16,69 @@ module ScoutApm
         @installed
       end
 
-      def install
+      def install(prepend:)
         if defined?(::Net) && defined?(::Net::HTTP)
           @installed = true
 
-          logger.info "Instrumenting Net::HTTP"
+          logger.info "Instrumenting Net::HTTP. Prepend: #{prepend}"
 
-          ::Net::HTTP.class_eval do
-            include ScoutApm::Tracer
+          if prepend
+            ::Net::HTTP.send(:include, ScoutApm::Tracer)
+            ::Net::HTTP.send(:prepend, NetHttpInstrumentationPrepend)
+          else
+            ::Net::HTTP.class_eval do
+              include ScoutApm::Tracer
 
-            def request_with_scout_instruments(*args, &block)
-              self.class.instrument("HTTP", "request", :ignore_children => true, :desc => request_scout_description(args.first)) do
-                request_without_scout_instruments(*args, &block)
+              def request_with_scout_instruments(*args, &block)
+                self.class.instrument("HTTP", "request", :ignore_children => true, :desc => request_scout_description(args.first)) do
+                  request_without_scout_instruments(*args, &block)
+                end
               end
-            end
 
-            def request_scout_description(req)
-              path = req.path
-              path = path.path if path.respond_to?(:path)
+              def request_scout_description(req)
+                path = req.path
+                path = path.path if path.respond_to?(:path)
+
+                # Protect against a nil address value
+                if @address.nil?
+                  return "No Address Found"
+                end
 
-              # Protect against a nil address value
-              if @address.nil?
-                return "No Address Found"
+                max_length = ScoutApm::Agent.instance.context.config.value('instrument_http_url_length')
+                (@address + path.split('?').first)[0..(max_length - 1)]
+              rescue
+                ""
               end
 
-              max_length = ScoutApm::Agent.instance.context.config.value('instrument_http_url_length')
-              (@address + path.split('?').first)[0..(max_length - 1)]
-            rescue
-              ""
+              alias request_without_scout_instruments request
+              alias request request_with_scout_instruments
             end
-
-            alias request_without_scout_instruments request
-            alias request request_with_scout_instruments
           end
         end
       end
     end
+
+    module NetHttpInstrumentationPrepend
+      def request(request, *args, &block)
+        self.class.instrument("HTTP", "request", :ignore_children => true, :desc => request_scout_description(args.first)) do
+          super(request, *args, &block)
+        end
+      end
+
+      def request_scout_description(req)
+        path = req.path
+        path = path.path if path.respond_to?(:path)
+
+        # Protect against a nil address value
+        if @address.nil?
+          return "No Address Found"
+        end
+
+        max_length = ScoutApm::Agent.instance.context.config.value('instrument_http_url_length')
+        (@address + path.split('?').first)[0..(max_length - 1)]
+      rescue
+        ""
+      end
+    end
   end
 end

data/lib/scout_apm/instruments/rails_router.rb

@@ -16,7 +16,7 @@ module ScoutApm
         @installed
       end
 
-      def install
+      def install(prepend:)
         if defined?(ActionDispatch) && defined?(ActionDispatch::Routing) && defined?(ActionDispatch::Routing::RouteSet)
           @installed = true
 

data/lib/scout_apm/instruments/redis.rb

@@ -16,28 +16,43 @@ module ScoutApm
         @installed
       end
 
-      def install
+      def install(prepend:)
         if defined?(::Redis) && defined?(::Redis::Client)
           @installed = true
 
-          logger.info "Instrumenting Redis"
+          logger.info "Instrumenting Redis. Prepend: #{prepend}"
 
-          ::Redis::Client.class_eval do
-            include ScoutApm::Tracer
+          if prepend
+            ::Redis::Client.send(:include, ScoutApm::Tracer)
+            ::Redis::Client.send(:prepend, RedisClientInstrumentationPrepend)
+          else
+            ::Redis::Client.class_eval do
+              include ScoutApm::Tracer
 
-            def call_with_scout_instruments(*args, &block)
-              command = args.first.first rescue "Unknown"
+              def call_with_scout_instruments(*args, &block)
+                command = args.first.first rescue "Unknown"
 
-              self.class.instrument("Redis", command) do
-                call_without_scout_instruments(*args, &block)
+                self.class.instrument("Redis", command) do
+                  call_without_scout_instruments(*args, &block)
+                end
               end
-            end
 
-            alias_method :call_without_scout_instruments, :call
-            alias_method :call, :call_with_scout_instruments
+              alias_method :call_without_scout_instruments, :call
+              alias_method :call, :call_with_scout_instruments
+            end
           end
         end
       end
     end
+
+    module RedisClientInstrumentationPrepend
+      def call(*args, &block)
+        command = args.first.first rescue "Unknown"
+
+        self.class.instrument("Redis", command) do
+          super(*args, &block)
+        end
+      end
+    end
   end
 end

data/lib/scout_apm/instruments/sinatra.rb

@@ -15,7 +15,7 @@ module ScoutApm
         @installed
       end
 
-      def install
+      def install(prepend:)
         if defined?(::Sinatra) && defined?(::Sinatra::Base) && ::Sinatra::Base.private_method_defined?(:dispatch!)
           @installed = true
 

data/lib/scout_apm/instruments/typhoeus.rb

@@ -16,7 +16,7 @@ module ScoutApm
         @installed
       end
 
-      def install
+      def install(prepend:)
         if defined?(::Typhoeus)
           @installed = true
 

data/lib/scout_apm/version.rb

@@ -1,3 +1,3 @@
 module ScoutApm
-  VERSION = "5.2.0"
+  VERSION = "5.3.0"
 end

data/test/unit/instruments/active_record_test.rb

@@ -29,7 +29,7 @@ class ActiveRecordTest < Minitest::Test
     agent_context.recorder = recorder
 
     instrument = ScoutApm::Instruments::ActiveRecord.new(agent_context)
-    instrument.install
+    instrument.install(prepend: false)
 
     ScoutApm::Tracer.instrument("Controller", "foo/bar") do
       user = User.create

data/test/unit/instruments/http_client_test.rb

@@ -0,0 +1,24 @@
+if (ENV["SCOUT_TEST_FEATURES"] || "").include?("instruments")
+  require 'test_helper'
+
+  require 'scout_apm/instruments/http_client'
+
+  require 'httpclient'
+
+  class HttpClientTest < Minitest::Test
+    def setup
+      @context = ScoutApm::AgentContext.new
+      @instance = ScoutApm::Instruments::HttpClient.new(@context)
+      @instrument_manager = ScoutApm::InstrumentManager.new(@context)
+      @instance.install(prepend: @instrument_manager.prepend_for_instrument?(@instance.class))
+    end
+
+    def test_installs_using_proper_method
+      if @instrument_manager.prepend_for_instrument?(@instance.class) == true
+        assert ::HTTPClient.ancestors.include?(ScoutApm::Instruments::HttpClientInstrumentationPrepend)
+      else
+        assert_equal false, ::HTTPClient.ancestors.include?(ScoutApm::Instruments::HttpClientInstrumentationPrepend)
+      end
+    end
+  end
+end

data/test/unit/instruments/http_test.rb

@@ -0,0 +1,24 @@
+if (ENV["SCOUT_TEST_FEATURES"] || "").include?("instruments")
+  require 'test_helper'
+
+  require 'scout_apm/instruments/http'
+
+  require 'http'
+
+  class HttpTest < Minitest::Test
+    def setup
+      @context = ScoutApm::AgentContext.new
+      @instance = ScoutApm::Instruments::HTTP.new(@context)
+      @instrument_manager = ScoutApm::InstrumentManager.new(@context)
+      @instance.install(prepend: @instrument_manager.prepend_for_instrument?(@instance.class))
+    end
+
+    def test_installs_using_proper_method
+      if @instrument_manager.prepend_for_instrument?(@instance.class) == true
+        assert ::HTTP::Client.ancestors.include?(ScoutApm::Instruments::HTTPInstrumentationPrepend)
+      else
+        assert_equal false, ::HTTP::Client.ancestors.include?(ScoutApm::Instruments::HTTPInstrumentationPrepend)
+      end
+    end
+  end
+end

data/test/unit/instruments/moped_test.rb

@@ -0,0 +1,24 @@
+if (ENV["SCOUT_TEST_FEATURES"] || "").include?("instruments")
+  require 'test_helper'
+
+  require 'scout_apm/instruments/moped'
+
+  require 'moped'
+
+  class MopedTest < Minitest::Test
+    def setup
+      @context = ScoutApm::AgentContext.new
+      @instance = ScoutApm::Instruments::Moped.new(@context)
+      @instrument_manager = ScoutApm::InstrumentManager.new(@context)
+      @instance.install(prepend: @instrument_manager.prepend_for_instrument?(@instance.class))
+    end
+
+    def test_installs_using_proper_method
+      if @instrument_manager.prepend_for_instrument?(@instance.class) == true
+        assert ::Moped::Node.ancestors.include?(ScoutApm::Instruments::MopedInstrumentationPrepend)
+      else
+        assert_equal false, ::Moped::Node.ancestors.include?(ScoutApm::Instruments::MopedInstrumentationPrepend)
+      end
+    end
+  end
+end

data/test/unit/instruments/net_http_test.rb

@@ -7,7 +7,9 @@ require 'addressable/uri'
 class NetHttpTest < Minitest::Test
   def setup
     @context = ScoutApm::AgentContext.new
-    ScoutApm::Instruments::NetHttp.new(@context).install
+    @instance = ScoutApm::Instruments::NetHttp.new(@context)
+    @instrument_manager = ScoutApm::InstrumentManager.new(@context)
+    @instance.install(prepend: @instrument_manager.prepend_for_instrument?(@instance.class))
   end
 
   def test_request_scout_description_for_uri
@@ -24,4 +26,12 @@ class NetHttpTest < Minitest::Test
     req = Net::HTTP::Get.new(Addressable::URI.parse('http://example.org/here'))
     assert_equal '/here', Net::HTTP.new('').request_scout_description(req)
   end
+
+  def test_installs_using_proper_method
+    if @instrument_manager.prepend_for_instrument?(@instance.class) == true
+      assert Net::HTTP.ancestors.include?(ScoutApm::Instruments::NetHttpInstrumentationPrepend)
+    else
+      assert_equal false, Net::HTTP.ancestors.include?(ScoutApm::Instruments::NetHttpInstrumentationPrepend)
+    end
+  end
 end

data/test/unit/instruments/redis_test.rb

@@ -0,0 +1,24 @@
+if (ENV["SCOUT_TEST_FEATURES"] || "").include?("instruments")
+  require 'test_helper'
+
+  require 'scout_apm/instruments/redis'
+
+  require 'redis'
+
+  class RedisTest < Minitest::Test
+    def setup
+      @context = ScoutApm::AgentContext.new
+      @instance = ScoutApm::Instruments::Redis.new(@context)
+      @instrument_manager = ScoutApm::InstrumentManager.new(@context)
+      @instance.install(prepend: @instrument_manager.prepend_for_instrument?(@instance.class))
+    end
+
+    def test_installs_using_proper_method
+      if @instrument_manager.prepend_for_instrument?(@instance.class) == true
+        assert ::Redis::Client.ancestors.include?(ScoutApm::Instruments::RedisClientInstrumentationPrepend)
+      else
+        assert_equal false, ::Redis::Client.ancestors.include?(ScoutApm::Instruments::RedisClientInstrumentationPrepend)
+      end
+    end
+  end
+end

data/test/unit/instruments/typhoeus_test.rb

@@ -10,7 +10,7 @@ if (ENV["SCOUT_TEST_FEATURES"] || "").include?("typhoeus")
       @context = ScoutApm::AgentContext.new
       @recorder = FakeRecorder.new
       ScoutApm::Agent.instance.context.recorder = @recorder
-      ScoutApm::Instruments::Typhoeus.new(@context).install
+      ScoutApm::Instruments::Typhoeus.new(@context).install(prepend: false)
     end
 
     def test_instruments_typhoeus_hydra

metadata

@@ -1,15 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: scout_apm
 version: !ruby/object:Gem::Version
-  version: 5.2.0
+  version: 5.3.0
 platform: ruby
 authors:
 - Derek Haynes
 - Andre Lewis
-autorequire:
+autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-06-21 00:00:00.000000000 Z
+date: 2022-08-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest
@@ -232,6 +232,7 @@ files:
 - ext/rusage/extconf.rb
 - ext/rusage/rusage.c
 - gems/README.md
+- gems/instruments.gemfile
 - gems/octoshark.gemfile
 - gems/rails3.gemfile
 - gems/rails4.gemfile
@@ -441,8 +442,12 @@ files:
 - test/unit/histogram_test.rb
 - test/unit/ignored_uris_test.rb
 - test/unit/instruments/active_record_test.rb
+- test/unit/instruments/http_client_test.rb
+- test/unit/instruments/http_test.rb
+- test/unit/instruments/moped_test.rb
 - test/unit/instruments/net_http_test.rb
 - test/unit/instruments/percentile_sampler_test.rb
+- test/unit/instruments/redis_test.rb
 - test/unit/instruments/typhoeus_test.rb
 - test/unit/layaway_test.rb
 - test/unit/layer_children_set_test.rb
@@ -473,7 +478,7 @@ homepage: https://github.com/scoutapp/scout_apm_ruby
 licenses:
 - MIT
 metadata: {}
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -489,8 +494,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.7
-signing_key:
+rubygems_version: 3.0.3
+signing_key: 
 specification_version: 4
 summary: Ruby application performance monitoring
 test_files: []