opentelemetry-instrumentation-faraday 0.27.0 → 0.29.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9277b3989aec5b86a371febc29f4e311be7f9b8f875766b87cb95a36f34e3ac1
-  data.tar.gz: 8214e43a5609615156bd124b19132e62d8432ae46545266e10160eb50026810e
+  metadata.gz: b85e3681f3964e94c187ba4f13c261e49d65857fef62b7591a72d14355086d70
+  data.tar.gz: 0ff2b06c0b51e59e1331d923079ed97598b39a17f8bc964d3caaf1d0e7ef1812
 SHA512:
-  metadata.gz: 338344d347896039ca70ca71930758193e90eef6ba21c32892c7089e2b046d67239fc251e23bfb696d239b30bdea3d8f81a40d28e75c5c608f4f6756f36dd1b3
-  data.tar.gz: 69689f9129b606d4a387aa94c5632c043bfe91717625fbada5455e4a1353ae8a7eb077415c5232044bc260bde17753df548d1f15a3ab5fcdd8c6b11ec96504b6
+  metadata.gz: 573d2502499da5b6a1281962358b02284413074f42a37d74fa22e7ca76f450eae533fe0c93406e6a0265afda1f3bc6c6129e126e0eeec42d6d0c4db38cf67eb7
+  data.tar.gz: cf22b7a0da102962250a603db1705b3ad4588e50ea9f322595e5511646bc9af284c20e319543b252ed170c03cac4057c950d165ff12bf786085a666fe2bded18

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release History: opentelemetry-instrumentation-faraday
 
+### v0.29.0 / 2025-09-30
+
+* ADDED: Bump minimum API Version to 1.7
+
+### v0.28.0 / 2025-08-13
+
+* ADDED: Add Faraday `OTEL_SEMCONV_STABILITY_OPT_IN` environment variable [#1592](https://github.com/open-telemetry/opentelemetry-ruby-contrib/pull/1592)
+
 ### v0.27.0 / 2025-06-03
 
 * ADDED: Suppress internal spans with Faraday instrumentation
@@ -64,25 +72,25 @@
 
 ### v0.23.1 / 2023-06-05
 
-* FIXED: Base config options 
+* FIXED: Base config options
 
 ### v0.23.0 / 2023-04-17
 
-* BREAKING CHANGE: Drop support for EoL Ruby 2.7 
+* BREAKING CHANGE: Drop support for EoL Ruby 2.7
 
-* ADDED: Drop support for EoL Ruby 2.7 
+* ADDED: Drop support for EoL Ruby 2.7
 
 ### v0.22.0 / 2023-01-14
 
-* ADDED: Add request/response hooks to more http clients 
-* FIXED: Stop leaking basic authentication credentials in Faraday instrumentation 
-* DOCS: Fix gem homepage 
-* DOCS: More gem documentation fixes 
+* ADDED: Add request/response hooks to more http clients
+* FIXED: Stop leaking basic authentication credentials in Faraday instrumentation
+* DOCS: Fix gem homepage
+* DOCS: More gem documentation fixes
 
 ### v0.21.0 / 2022-06-09
 
 * Upgrading Base dependency version
-* FIXED: Broken test file requirements 
+* FIXED: Broken test file requirements
 
 ### v0.20.1 / 2022-05-03
 
@@ -90,8 +98,8 @@
 
 ### v0.20.0 / 2022-02-02
 
-* ADDED: Add net.peer.name to faraday instrumentation 
-* FIXED: Excessive hash creation on context attr merging 
+* ADDED: Add net.peer.name to faraday instrumentation
+* FIXED: Excessive hash creation on context attr merging
 
 ### v0.19.3 / 2021-12-02
 
@@ -103,17 +111,17 @@
 
 ### v0.19.1 / 2021-08-12
 
-* DOCS: Update docs to rely more on environment variable configuration 
+* DOCS: Update docs to rely more on environment variable configuration
 
 ### v0.19.0 / 2021-06-23
 
-* BREAKING CHANGE: Total order constraint on span.status= 
+* BREAKING CHANGE: Total order constraint on span.status=
 
-* FIXED: Total order constraint on span.status= 
+* FIXED: Total order constraint on span.status=
 
 ### v0.18.1 / 2021-06-08
 
-* FIXED: Missing require to common in faraday 
+* FIXED: Missing require to common in faraday
 
 ### v0.18.0 / 2021-05-21
 

data/README.md

@@ -59,3 +59,19 @@ Apache 2.0 license. See [LICENSE][license-github] for more information.
 [community-meetings]: https://github.com/open-telemetry/community#community-meetings
 [slack-channel]: https://cloud-native.slack.com/archives/C01NWKKMKMY
 [discussions-url]: https://github.com/open-telemetry/opentelemetry-ruby/discussions
+
+## HTTP semantic convention stability
+
+In the OpenTelemetry ecosystem, HTTP semantic conventions have now reached a stable state. However, the initial Faraday instrumentation was introduced before this stability was achieved, which resulted in HTTP attributes being based on an older version of the semantic conventions.
+
+To facilitate the migration to stable semantic conventions, you can use the `OTEL_SEMCONV_STABILITY_OPT_IN` environment variable. This variable allows you to opt-in to the new stable conventions, ensuring compatibility and future-proofing your instrumentation.
+
+When setting the value for `OTEL_SEMCONV_STABILITY_OPT_IN`, you can specify which conventions you wish to adopt:
+
+- `http` - Emits the stable HTTP and networking conventions and ceases emitting the old conventions previously emitted by the instrumentation.
+- `http/dup` - Emits both the old and stable HTTP and networking conventions, enabling a phased rollout of the stable semantic conventions.
+- Default behavior (in the absence of either value) is to continue emitting the old HTTP and networking conventions the instrumentation previously emitted.
+
+During the transition from old to stable conventions, Faraday instrumentation code comes in three patch versions: `dup`, `old`, and `stable`. These versions are identical except for the attributes they send. Any changes to Faraday instrumentation should consider all three patches.
+
+For additional information on migration, please refer to our [documentation](https://opentelemetry.io/docs/specs/semconv/non-normative/http-migration/).

data/lib/opentelemetry/instrumentation/faraday/instrumentation.rb

@@ -13,9 +13,10 @@ module OpenTelemetry
         MINIMUM_VERSION = Gem::Version.new('1.0')
 
         install do |_config|
-          require_dependencies
-          register_tracer_middleware
-          use_middleware_by_default
+          patch_type = determine_semconv
+          send(:"require_dependencies_#{patch_type}")
+          send(:"register_tracer_middleware_#{patch_type}")
+          send(:"use_middleware_by_default_#{patch_type}")
         end
 
         compatible do
@@ -36,19 +37,62 @@ module OpenTelemetry
           Gem::Version.new(::Faraday::VERSION)
         end
 
-        def require_dependencies
-          require_relative 'middlewares/tracer_middleware'
-          require_relative 'patches/connection'
+        def determine_semconv
+          stability_opt_in = ENV.fetch('OTEL_SEMCONV_STABILITY_OPT_IN', '')
+          values = stability_opt_in.split(',').map(&:strip)
+
+          if values.include?('http/dup')
+            'dup'
+          elsif values.include?('http')
+            'stable'
+          else
+            'old'
+          end
+        end
+
+        def require_dependencies_dup
+          require_relative 'middlewares/dup/tracer_middleware'
+          require_relative 'patches/dup/connection'
+        end
+
+        def require_dependencies_old
+          require_relative 'middlewares/old/tracer_middleware'
+          require_relative 'patches/old/connection'
         end
 
-        def register_tracer_middleware
+        def require_dependencies_stable
+          require_relative 'middlewares/stable/tracer_middleware'
+          require_relative 'patches/stable/connection'
+        end
+
+        def register_tracer_middleware_dup
           ::Faraday::Middleware.register_middleware(
-            open_telemetry: Middlewares::TracerMiddleware
+            open_telemetry: Middlewares::Dup::TracerMiddleware
           )
         end
 
-        def use_middleware_by_default
-          ::Faraday::Connection.prepend(Patches::Connection)
+        def register_tracer_middleware_old
+          ::Faraday::Middleware.register_middleware(
+            open_telemetry: Middlewares::Old::TracerMiddleware
+          )
+        end
+
+        def register_tracer_middleware_stable
+          ::Faraday::Middleware.register_middleware(
+            open_telemetry: Middlewares::Stable::TracerMiddleware
+          )
+        end
+
+        def use_middleware_by_default_dup
+          ::Faraday::Connection.prepend(Patches::Dup::Connection)
+        end
+
+        def use_middleware_by_default_old
+          ::Faraday::Connection.prepend(Patches::Old::Connection)
+        end
+
+        def use_middleware_by_default_stable
+          ::Faraday::Connection.prepend(Patches::Stable::Connection)
         end
       end
     end

data/lib/opentelemetry/instrumentation/faraday/middlewares/dup/tracer_middleware.rb

@@ -0,0 +1,98 @@
+# frozen_string_literal: true
+
+# Copyright The OpenTelemetry Authors
+#
+# SPDX-License-Identifier: Apache-2.0
+
+module OpenTelemetry
+  module Instrumentation
+    module Faraday
+      module Middlewares
+        module Dup
+          # TracerMiddleware propagates context and instruments Faraday requests
+          # by way of its middleware system
+          class TracerMiddleware < ::Faraday::Middleware
+            HTTP_METHODS_SYMBOL_TO_STRING = {
+              connect: 'CONNECT',
+              delete: 'DELETE',
+              get: 'GET',
+              head: 'HEAD',
+              options: 'OPTIONS',
+              patch: 'PATCH',
+              post: 'POST',
+              put: 'PUT',
+              trace: 'TRACE'
+            }.freeze
+
+            # Constant for the HTTP status range
+            HTTP_STATUS_SUCCESS_RANGE = (100..399)
+
+            def call(env)
+              http_method = HTTP_METHODS_SYMBOL_TO_STRING[env.method]
+              config = Faraday::Instrumentation.instance.config
+
+              attributes = span_creation_attributes(
+                http_method: http_method, url: env.url, config: config
+              )
+
+              OpenTelemetry::Common::HTTP::ClientContext.with_attributes(attributes) do |attrs, _|
+                tracer.in_span(
+                  http_method, attributes: attrs, kind: config.fetch(:span_kind)
+                ) do |span|
+                  OpenTelemetry.propagation.inject(env.request_headers)
+
+                  if config[:enable_internal_instrumentation] == false
+                    OpenTelemetry::Common::Utilities.untraced do
+                      app.call(env).on_complete { |resp| trace_response(span, resp.status) }
+                    end
+                  else
+                    app.call(env).on_complete { |resp| trace_response(span, resp.status) }
+                  end
+                rescue ::Faraday::Error => e
+                  trace_response(span, e.response[:status]) if e.response
+
+                  raise
+                end
+              end
+            end
+
+            private
+
+            def span_creation_attributes(http_method:, url:, config:)
+              cleansed_url = OpenTelemetry::Common::Utilities.cleanse_url(url.to_s)
+              attrs = {
+                'http.method' => http_method,
+                'http.request.method' => http_method,
+                'http.url' => cleansed_url,
+                'url.full' => cleansed_url,
+                'faraday.adapter.name' => app.class.name
+              }
+              if url.host
+                attrs['net.peer.name'] = url.host
+                attrs['server.address'] = url.host
+              end
+              attrs['peer.service'] = config[:peer_service] if config[:peer_service]
+
+              attrs.merge!(
+                OpenTelemetry::Common::HTTP::ClientContext.attributes
+              )
+            end
+
+            # Versions prior to 1.0 do not define an accessor for app
+            attr_reader :app if Gem::Version.new(Faraday::VERSION) < Gem::Version.new('1.0.0')
+
+            def tracer
+              Faraday::Instrumentation.instance.tracer
+            end
+
+            def trace_response(span, status)
+              span.set_attribute('http.status_code', status)
+              span.set_attribute('http.response.status_code', status)
+              span.status = OpenTelemetry::Trace::Status.error unless HTTP_STATUS_SUCCESS_RANGE.cover?(status.to_i)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/opentelemetry/instrumentation/faraday/middlewares/old/tracer_middleware.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+# Copyright The OpenTelemetry Authors
+#
+# SPDX-License-Identifier: Apache-2.0
+
+module OpenTelemetry
+  module Instrumentation
+    module Faraday
+      module Middlewares
+        module Old
+          # TracerMiddleware propagates context and instruments Faraday requests
+          # by way of its middleware system
+          class TracerMiddleware < ::Faraday::Middleware
+            HTTP_METHODS_SYMBOL_TO_STRING = {
+              connect: 'CONNECT',
+              delete: 'DELETE',
+              get: 'GET',
+              head: 'HEAD',
+              options: 'OPTIONS',
+              patch: 'PATCH',
+              post: 'POST',
+              put: 'PUT',
+              trace: 'TRACE'
+            }.freeze
+
+            # Constant for the HTTP status range
+            HTTP_STATUS_SUCCESS_RANGE = (100..399)
+
+            def call(env)
+              http_method = HTTP_METHODS_SYMBOL_TO_STRING[env.method]
+              config = Faraday::Instrumentation.instance.config
+
+              attributes = span_creation_attributes(
+                http_method: http_method, url: env.url, config: config
+              )
+
+              OpenTelemetry::Common::HTTP::ClientContext.with_attributes(attributes) do |attrs, _|
+                tracer.in_span(
+                  "HTTP #{http_method}", attributes: attrs, kind: config.fetch(:span_kind)
+                ) do |span|
+                  OpenTelemetry.propagation.inject(env.request_headers)
+
+                  if config[:enable_internal_instrumentation] == false
+                    OpenTelemetry::Common::Utilities.untraced do
+                      app.call(env).on_complete { |resp| trace_response(span, resp.status) }
+                    end
+                  else
+                    app.call(env).on_complete { |resp| trace_response(span, resp.status) }
+                  end
+                rescue ::Faraday::Error => e
+                  trace_response(span, e.response[:status]) if e.response
+
+                  raise
+                end
+              end
+            end
+
+            private
+
+            def span_creation_attributes(http_method:, url:, config:)
+              attrs = {
+                'http.method' => http_method,
+                'http.url' => OpenTelemetry::Common::Utilities.cleanse_url(url.to_s),
+                'faraday.adapter.name' => app.class.name
+              }
+              attrs['net.peer.name'] = url.host if url.host
+              attrs['peer.service'] = config[:peer_service] if config[:peer_service]
+
+              attrs.merge!(
+                OpenTelemetry::Common::HTTP::ClientContext.attributes
+              )
+            end
+
+            # Versions prior to 1.0 do not define an accessor for app
+            attr_reader :app if Gem::Version.new(Faraday::VERSION) < Gem::Version.new('1.0.0')
+
+            def tracer
+              Faraday::Instrumentation.instance.tracer
+            end
+
+            def trace_response(span, status)
+              span.set_attribute('http.status_code', status)
+              span.status = OpenTelemetry::Trace::Status.error unless HTTP_STATUS_SUCCESS_RANGE.cover?(status.to_i)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/opentelemetry/instrumentation/faraday/middlewares/stable/tracer_middleware.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+# Copyright The OpenTelemetry Authors
+#
+# SPDX-License-Identifier: Apache-2.0
+
+module OpenTelemetry
+  module Instrumentation
+    module Faraday
+      module Middlewares
+        module Stable
+          # TracerMiddleware propagates context and instruments Faraday requests
+          # by way of its middleware system
+          class TracerMiddleware < ::Faraday::Middleware
+            HTTP_METHODS_SYMBOL_TO_STRING = {
+              connect: 'CONNECT',
+              delete: 'DELETE',
+              get: 'GET',
+              head: 'HEAD',
+              options: 'OPTIONS',
+              patch: 'PATCH',
+              post: 'POST',
+              put: 'PUT',
+              trace: 'TRACE'
+            }.freeze
+
+            # Constant for the HTTP status range
+            HTTP_STATUS_SUCCESS_RANGE = (100..399)
+
+            def call(env)
+              http_method = HTTP_METHODS_SYMBOL_TO_STRING[env.method]
+              config = Faraday::Instrumentation.instance.config
+
+              attributes = span_creation_attributes(
+                http_method: http_method, url: env.url, config: config
+              )
+
+              OpenTelemetry::Common::HTTP::ClientContext.with_attributes(attributes) do |attrs, _|
+                tracer.in_span(
+                  http_method, attributes: attrs, kind: config.fetch(:span_kind)
+                ) do |span|
+                  OpenTelemetry.propagation.inject(env.request_headers)
+
+                  if config[:enable_internal_instrumentation] == false
+                    OpenTelemetry::Common::Utilities.untraced do
+                      app.call(env).on_complete { |resp| trace_response(span, resp.status) }
+                    end
+                  else
+                    app.call(env).on_complete { |resp| trace_response(span, resp.status) }
+                  end
+                rescue ::Faraday::Error => e
+                  trace_response(span, e.response[:status]) if e.response
+
+                  raise
+                end
+              end
+            end
+
+            private
+
+            def span_creation_attributes(http_method:, url:, config:)
+              attrs = {
+                'http.request.method' => http_method,
+                'url.full' => OpenTelemetry::Common::Utilities.cleanse_url(url.to_s),
+                'faraday.adapter.name' => app.class.name
+              }
+              attrs['server.address'] = url.host if url.host
+              attrs['peer.service'] = config[:peer_service] if config[:peer_service]
+
+              attrs.merge!(
+                OpenTelemetry::Common::HTTP::ClientContext.attributes
+              )
+            end
+
+            # Versions prior to 1.0 do not define an accessor for app
+            attr_reader :app if Gem::Version.new(Faraday::VERSION) < Gem::Version.new('1.0.0')
+
+            def tracer
+              Faraday::Instrumentation.instance.tracer
+            end
+
+            def trace_response(span, status)
+              span.set_attribute('http.response.status_code', status)
+              span.status = OpenTelemetry::Trace::Status.error unless HTTP_STATUS_SUCCESS_RANGE.cover?(status.to_i)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/opentelemetry/instrumentation/faraday/patches/dup/connection.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+# Copyright The OpenTelemetry Authors
+#
+# SPDX-License-Identifier: Apache-2.0
+
+module OpenTelemetry
+  module Instrumentation
+    module Faraday
+      module Patches
+        module Dup
+          # Module to be prepended to force Faraday to use the middleware by
+          # default so the user doesn't have to call `use` for every connection.
+          module Connection
+            # Wraps Faraday::Connection#initialize:
+            # https://github.com/lostisland/faraday/blob/ff9dc1d1219a1bbdba95a9a4cf5d135b97247ee2/lib/faraday/connection.rb#L62-L92
+            def initialize(...)
+              super.tap do
+                use(:open_telemetry) unless builder.handlers.any? do |handler|
+                  handler.klass == Middlewares::Dup::TracerMiddleware
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/opentelemetry/instrumentation/faraday/patches/old/connection.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+# Copyright The OpenTelemetry Authors
+#
+# SPDX-License-Identifier: Apache-2.0
+
+module OpenTelemetry
+  module Instrumentation
+    module Faraday
+      module Patches
+        module Old
+          # Module to be prepended to force Faraday to use the middleware by
+          # default so the user doesn't have to call `use` for every connection.
+          module Connection
+            # Wraps Faraday::Connection#initialize:
+            # https://github.com/lostisland/faraday/blob/ff9dc1d1219a1bbdba95a9a4cf5d135b97247ee2/lib/faraday/connection.rb#L62-L92
+            def initialize(...)
+              super.tap do
+                use(:open_telemetry) unless builder.handlers.any? do |handler|
+                  handler.klass == Middlewares::Old::TracerMiddleware
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/opentelemetry/instrumentation/faraday/patches/stable/connection.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+# Copyright The OpenTelemetry Authors
+#
+# SPDX-License-Identifier: Apache-2.0
+
+module OpenTelemetry
+  module Instrumentation
+    module Faraday
+      module Patches
+        module Stable
+          # Module to be prepended to force Faraday to use the middleware by
+          # default so the user doesn't have to call `use` for every connection.
+          module Connection
+            # Wraps Faraday::Connection#initialize:
+            # https://github.com/lostisland/faraday/blob/ff9dc1d1219a1bbdba95a9a4cf5d135b97247ee2/lib/faraday/connection.rb#L62-L92
+            def initialize(...)
+              super.tap do
+                use(:open_telemetry) unless builder.handlers.any? do |handler|
+                  handler.klass == Middlewares::Stable::TracerMiddleware
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -7,7 +7,7 @@
 module OpenTelemetry
   module Instrumentation
     module Faraday
-      VERSION = '0.27.0'
+      VERSION = '0.29.0'
     end
   end
 end

metadata

@@ -1,43 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: opentelemetry-instrumentation-faraday
 version: !ruby/object:Gem::Version
-  version: 0.27.0
+  version: 0.29.0
 platform: ruby
 authors:
 - OpenTelemetry Authors
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-06-03 00:00:00.000000000 Z
+date: 2025-09-30 00:00:00.000000000 Z
 dependencies:
-- !ruby/object:Gem::Dependency
-  name: opentelemetry-api
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: opentelemetry-instrumentation-base
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.23.0
+        version: '0.23'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.23.0
+        version: '0.23'
 description: Faraday instrumentation for the OpenTelemetry framework
 email:
 - cncf-opentelemetry-contributors@lists.cncf.io
@@ -53,17 +39,21 @@ files:
 - lib/opentelemetry/instrumentation.rb
 - lib/opentelemetry/instrumentation/faraday.rb
 - lib/opentelemetry/instrumentation/faraday/instrumentation.rb
-- lib/opentelemetry/instrumentation/faraday/middlewares/tracer_middleware.rb
-- lib/opentelemetry/instrumentation/faraday/patches/connection.rb
+- lib/opentelemetry/instrumentation/faraday/middlewares/dup/tracer_middleware.rb
+- lib/opentelemetry/instrumentation/faraday/middlewares/old/tracer_middleware.rb
+- lib/opentelemetry/instrumentation/faraday/middlewares/stable/tracer_middleware.rb
+- lib/opentelemetry/instrumentation/faraday/patches/dup/connection.rb
+- lib/opentelemetry/instrumentation/faraday/patches/old/connection.rb
+- lib/opentelemetry/instrumentation/faraday/patches/stable/connection.rb
 - lib/opentelemetry/instrumentation/faraday/version.rb
 homepage: https://github.com/open-telemetry/opentelemetry-ruby-contrib
 licenses:
 - Apache-2.0
 metadata:
-  changelog_uri: https://rubydoc.info/gems/opentelemetry-instrumentation-faraday/0.27.0/file/CHANGELOG.md
+  changelog_uri: https://rubydoc.info/gems/opentelemetry-instrumentation-faraday/0.29.0/file/CHANGELOG.md
   source_code_uri: https://github.com/open-telemetry/opentelemetry-ruby-contrib/tree/main/instrumentation/faraday
   bug_tracker_uri: https://github.com/open-telemetry/opentelemetry-ruby-contrib/issues
-  documentation_uri: https://rubydoc.info/gems/opentelemetry-instrumentation-faraday/0.27.0
+  documentation_uri: https://rubydoc.info/gems/opentelemetry-instrumentation-faraday/0.29.0
 post_install_message:
 rdoc_options: []
 require_paths:

data/lib/opentelemetry/instrumentation/faraday/middlewares/tracer_middleware.rb

@@ -1,89 +0,0 @@
-# frozen_string_literal: true
-
-# Copyright The OpenTelemetry Authors
-#
-# SPDX-License-Identifier: Apache-2.0
-
-module OpenTelemetry
-  module Instrumentation
-    module Faraday
-      module Middlewares
-        # TracerMiddleware propagates context and instruments Faraday requests
-        # by way of its middleware system
-        class TracerMiddleware < ::Faraday::Middleware
-          HTTP_METHODS_SYMBOL_TO_STRING = {
-            connect: 'CONNECT',
-            delete: 'DELETE',
-            get: 'GET',
-            head: 'HEAD',
-            options: 'OPTIONS',
-            patch: 'PATCH',
-            post: 'POST',
-            put: 'PUT',
-            trace: 'TRACE'
-          }.freeze
-
-          # Constant for the HTTP status range
-          HTTP_STATUS_SUCCESS_RANGE = (100..399)
-
-          def call(env)
-            http_method = HTTP_METHODS_SYMBOL_TO_STRING[env.method]
-            config = Faraday::Instrumentation.instance.config
-
-            attributes = span_creation_attributes(
-              http_method: http_method, url: env.url, config: config
-            )
-
-            OpenTelemetry::Common::HTTP::ClientContext.with_attributes(attributes) do |attrs, _|
-              tracer.in_span(
-                "HTTP #{http_method}", attributes: attrs, kind: config.fetch(:span_kind)
-              ) do |span|
-                OpenTelemetry.propagation.inject(env.request_headers)
-
-                if config[:enable_internal_instrumentation] == false
-                  OpenTelemetry::Common::Utilities.untraced do
-                    app.call(env).on_complete { |resp| trace_response(span, resp.status) }
-                  end
-                else
-                  app.call(env).on_complete { |resp| trace_response(span, resp.status) }
-                end
-              rescue ::Faraday::Error => e
-                trace_response(span, e.response[:status]) if e.response
-
-                raise
-              end
-            end
-          end
-
-          private
-
-          def span_creation_attributes(http_method:, url:, config:)
-            attrs = {
-              'http.method' => http_method,
-              'http.url' => OpenTelemetry::Common::Utilities.cleanse_url(url.to_s),
-              'faraday.adapter.name' => app.class.name
-            }
-            attrs['net.peer.name'] = url.host if url.host
-            attrs['peer.service'] = config[:peer_service] if config[:peer_service]
-
-            attrs.merge!(
-              OpenTelemetry::Common::HTTP::ClientContext.attributes
-            )
-          end
-
-          # Versions prior to 1.0 do not define an accessor for app
-          attr_reader :app if Gem::Version.new(Faraday::VERSION) < Gem::Version.new('1.0.0')
-
-          def tracer
-            Faraday::Instrumentation.instance.tracer
-          end
-
-          def trace_response(span, status)
-            span.set_attribute('http.status_code', status)
-            span.status = OpenTelemetry::Trace::Status.error unless HTTP_STATUS_SUCCESS_RANGE.cover?(status.to_i)
-          end
-        end
-      end
-    end
-  end
-end

data/lib/opentelemetry/instrumentation/faraday/patches/connection.rb

@@ -1,27 +0,0 @@
-# frozen_string_literal: true
-
-# Copyright The OpenTelemetry Authors
-#
-# SPDX-License-Identifier: Apache-2.0
-
-module OpenTelemetry
-  module Instrumentation
-    module Faraday
-      module Patches
-        # Module to be prepended to force Faraday to use the middleware by
-        # default so the user doesn't have to call `use` for every connection.
-        module Connection
-          # Wraps Faraday::Connection#initialize:
-          # https://github.com/lostisland/faraday/blob/ff9dc1d1219a1bbdba95a9a4cf5d135b97247ee2/lib/faraday/connection.rb#L62-L92
-          def initialize(...)
-            super.tap do
-              use(:open_telemetry) unless builder.handlers.any? do |handler|
-                handler.klass == Middlewares::TracerMiddleware
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end