opentelemetry-instrumentation-rails 0.18.0 → 0.19.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ce9c51efe3309c265a51f9779f89fafbfcb7ee7c89e8491892736f80aa8c473d
-  data.tar.gz: cee3ae8c0b9165a3c40532b1114dde2d6f33a3a2527fad94ac28cd0bb17c5544
+  metadata.gz: 86c8460001d2c7953337d3496087756fb8b722de13dbcff2cdb0d20638d86348
+  data.tar.gz: b3a85668dc14f4ccbb65502541d79253fcd6e73df878524e9d73e5684f600a4f
 SHA512:
-  metadata.gz: 24a1491adf9c2aaf800a89a3141fc331b142d8db8ba04f5ad0ba01707b7a155d65a20495c698baae766ce06c5acf908ac6c585e368931351f78adc3603b2a2db
-  data.tar.gz: cb6b640fcdba28eca82caa3b3cd2232c93dbd43e00b5cf3cdbdefd8d7bba9e98819e692f7a1ee6d8878f0d27a0b96cec483638e8df1c397b1baff6bca31cd17a
+  metadata.gz: aa19a4ba703a704ea0f6cc78081fd7d63da0cc961b22ac8818f0282bd2231946ca9c8602f778fd7cadaadfa3706809ad67db7e390412055628c26d1f12cdec4b
+  data.tar.gz: df64e78b2004d6648f748e4948270048ee92d63f178b48534e62e0684bd7a762a5055240d2c52fa1fc1e8979b051c5fb3a5027136dce3242dc2f124c10598616

data/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Release History: opentelemetry-instrumentation-rails
 
+### v0.19.2 / 2021-09-29
+
+* (No significant changes)
+
+### v0.19.1 / 2021-09-09
+
+* (No significant changes)
+
+### v0.19.0 / 2021-08-12
+
+* ADDED: Instrument active record
+* ADDED: Add ActionView instrumentation via ActiveSupport::Notifications
+* FIXED: Rails instrumentation to not explicitly install sub gems
+* DOCS: Update docs to rely more on environment variable configuration
+
+* This release adds support for Active Record and Action View.
+* The `enable_recognize_route` configuration option has been moved to the ActionPack gem.
+* See readme for details on how to configure the sub instrumentation gems.
+
+### v0.18.1 / 2021-06-23
+
+* FIXED: Updated rack middleware position to zero 
+
 ### v0.18.0 / 2021-05-21
 
 * ADDED: Updated API depedency for 1.0.0.rc1

data/README.md

@@ -14,15 +14,7 @@ Or, if you use [bundler][bundler-home], include `opentelemetry-instrumentation-r
 
 ## Usage
 
-To use the instrumentation, call `use` with the name of the instrumentation:
-
-```ruby
-OpenTelemetry::SDK.configure do |c|
-  c.use 'OpenTelemetry::Instrumentation::Rails'
-end
-```
-
-Alternatively, you can also call `use_all` to install all the available instrumentation.
+To use the Rails instrumentation, call `use_all` so it installs all the instrumentation gems.
 
 ```ruby
 OpenTelemetry::SDK.configure do |c|
@@ -30,15 +22,14 @@ OpenTelemetry::SDK.configure do |c|
 end
 ```
 
-
 ### Configuration options
 
-The `http.route` attribute is disabled by default because we use [.recognize](https://github.com/rails/rails/blob/v6.1.3/actionpack/lib/action_dispatch/journey/router.rb#L65)
+The Rails instrumentation attempts to mirror the structure of the Ruby on Rails.  It is a collection of instrumentation gems for components of Rails such as Action View, Active Record, Action Pack, etc...
+
+You may want to include all of the Rails instrumentation but disable a single instrumentation gem that it includes.  Here is an example of how you can disable Active Record when using this instrumentation gem.
 ```ruby
 OpenTelemetry::SDK.configure do |c|
-  c.use 'OpenTelemetry::Instrumentation::Rails', {
-    enable_recognize_route: true
-  }
+  c.use_all({ 'OpenTelemetry::Instrumentation::ActiveRecord' => { enabled: false } })
 end
 ```
 

data/lib/opentelemetry/instrumentation/rails/instrumentation.rb

@@ -12,30 +12,19 @@ module OpenTelemetry
       # The Instrumentation class contains logic to detect and install the Rails
       # instrumentation
       class Instrumentation < OpenTelemetry::Instrumentation::Base
-        install do |_config|
-          require_dependencies
-          require_railtie
-          patch_metal
-        end
-
-        present do
-          defined?(::Rails)
-        end
+        MINIMUM_VERSION = Gem::Version.new('5.2.0')
 
-        option :enable_recognize_route, default: false, validate: :boolean
+        # This gem requires the instrumentantion gems for the different
+        # components of Rails, as a result it does not have any explicit
+        # work to do in the install step.
+        install { true }
+        present { defined?(::Rails) }
+        compatible { gem_version >= MINIMUM_VERSION }
 
         private
 
-        def require_dependencies
-          require_relative 'patches/action_controller/metal'
-        end
-
-        def require_railtie
-          require_relative 'railtie'
-        end
-
-        def patch_metal
-          ::ActionController::Metal.prepend(Patches::ActionController::Metal)
+        def gem_version
+          Gem.loaded_specs['actionpack'].version
         end
       end
     end

data/lib/opentelemetry/instrumentation/rails/version.rb

@@ -7,7 +7,7 @@
 module OpenTelemetry
   module Instrumentation
     module Rails
-      VERSION = '0.18.0'
+      VERSION = '0.19.2'
     end
   end
 end

data/lib/opentelemetry/instrumentation/rails.rb

@@ -15,6 +15,8 @@ module OpenTelemetry
   end
 end
 
-require 'opentelemetry-instrumentation-rack'
+require 'opentelemetry-instrumentation-action_pack'
+require 'opentelemetry-instrumentation-action_view'
+require 'opentelemetry-instrumentation-active_record'
 require_relative './rails/instrumentation'
 require_relative './rails/version'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: opentelemetry-instrumentation-rails
 version: !ruby/object:Gem::Version
-  version: 0.18.0
+  version: 0.19.2
 platform: ruby
 authors:
 - OpenTelemetry Authors
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-05-21 00:00:00.000000000 Z
+date: 2021-09-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: opentelemetry-api
@@ -16,42 +16,70 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.0.0.rc1
+        version: 1.0.0.rc3
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.0.0.rc1
+        version: 1.0.0.rc3
 - !ruby/object:Gem::Dependency
-  name: opentelemetry-instrumentation-base
+  name: opentelemetry-instrumentation-action_pack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+- !ruby/object:Gem::Dependency
+  name: opentelemetry-instrumentation-action_view
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.18.0
+        version: 0.1.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.18.0
+        version: 0.1.1
 - !ruby/object:Gem::Dependency
-  name: opentelemetry-instrumentation-rack
+  name: opentelemetry-instrumentation-active_record
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+- !ruby/object:Gem::Dependency
+  name: opentelemetry-instrumentation-base
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.18.0
+        version: 0.18.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.18.0
+        version: 0.18.2
 - !ruby/object:Gem::Dependency
   name: appraisal
   requirement: !ruby/object:Gem::Requirement
@@ -235,8 +263,6 @@ files:
 - lib/opentelemetry/instrumentation.rb
 - lib/opentelemetry/instrumentation/rails.rb
 - lib/opentelemetry/instrumentation/rails/instrumentation.rb
-- lib/opentelemetry/instrumentation/rails/patches/action_controller/metal.rb
-- lib/opentelemetry/instrumentation/rails/railtie.rb
 - lib/opentelemetry/instrumentation/rails/version.rb
 homepage: https://github.com/open-telemetry/opentelemetry-ruby
 licenses:

data/lib/opentelemetry/instrumentation/rails/patches/action_controller/metal.rb

@@ -1,38 +0,0 @@
-# frozen_string_literal: true
-
-# Copyright The OpenTelemetry Authors
-#
-# SPDX-License-Identifier: Apache-2.0
-
-module OpenTelemetry
-  module Instrumentation
-    module Rails
-      module Patches
-        module ActionController
-          # Module to prepend to ActionController::Metal for instrumentation
-          module Metal
-            def dispatch(name, request, response)
-              rack_span = OpenTelemetry::Instrumentation::Rack.current_span
-              rack_span.name = "#{self.class.name}##{name}" if rack_span.context.valid? && !request.env['action_dispatch.exception']
-
-              add_rails_route(rack_span, request) if instrumentation_config[:enable_recognize_route]
-              super(name, request, response)
-            end
-
-            private
-
-            def add_rails_route(rack_span, request)
-              ::Rails.application.routes.router.recognize(request) do |route, _params|
-                rack_span.set_attribute('http.route', route.path.spec.to_s)
-              end
-            end
-
-            def instrumentation_config
-              Rails::Instrumentation.instance.config
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/opentelemetry/instrumentation/rails/railtie.rb

@@ -1,25 +0,0 @@
-# frozen_string_literal: true
-
-# Copyright The OpenTelemetry Authors
-#
-# SPDX-License-Identifier: Apache-2.0
-
-module OpenTelemetry
-  module Instrumentation
-    module Rails
-      # The Instrumentation class contains logic to detect and install the Rails
-      # instrumentation, while this Railtie is used to conventionally instrument
-      # the Rails application through its initialization hooks
-      class Railtie < ::Rails::Railtie
-        config.before_initialize do |app|
-          OpenTelemetry::Instrumentation::Rack::Instrumentation.instance.install({})
-
-          app.middleware.insert_after(
-            0,
-            OpenTelemetry::Instrumentation::Rack::Middlewares::TracerMiddleware
-          )
-        end
-      end
-    end
-  end
-end