opentelemetry-instrumentation-net_http 0.26.1 → 0.27.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d2f9f6258500f5ab93b13a049110172c6debbe70e058c160377fc540a8c994a1
-  data.tar.gz: 6c8e7898b77c26263bcb10cd6a5eb393774867ed94d6206dfec07fb4ab3c8bde
+  metadata.gz: af57eff25e83e807b9fce58534f7354a8da730eeb796e37304e4fcfff10aacf8
+  data.tar.gz: e05dab69206fd8a7eadee713bbc057c423b3908f848abf336d52ca974aab119b
 SHA512:
-  metadata.gz: 7d4dd3bc8a81c7c6ec0a35f77a6facadd6680a11f8b1fb07c47fb577e7e830356c0bfef62732293f7e096bcc9ff02948eb3096fd72a0c6f2a39d57d00c96e5f7
-  data.tar.gz: 4181e65cf2a9b74372f75b81f32a3419f43d77412277f7977d51df038a392b1ee3dcd5ec1b4c60851def8c406575181d7de474e4bcc647562d0e56a72d7e7bbe
+  metadata.gz: f28c788929d2d2b2330291598b1116586e0ae5f692592ccff42b212cc948c035bc65d639d72391e990881a5326987d74441efea816f64fc82fde1e1ca9ae5cba
+  data.tar.gz: 96ec477a7341ac52207adfd0a14b8bc20ebd64445f84b7cbb295d10a9b61be0af1e93a8983792e18cc8112c9b933151b25bc52f500abe01c320406c0384a29f1

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release History: opentelemetry-instrumentation-net_http
 
+### v0.27.0 / 2026-01-13
+
+* ADDED: HTTP Client Semconv v1.17 Span Naming
+
 ### v0.26.1 / 2025-11-25
 
 * FIXED: Update support for unknown HTTP methods to match semantic conventions
@@ -93,7 +97,7 @@
 
 ### v0.19.4 / 2022-02-02
 
-* FIXED: Clientcontext attrs overwrite in net::http
+* FIXED: Client Context attrs overwrite in net::http
 * FIXED: Excessive hash creation on context attr merging
 
 ### v0.19.3 / 2021-12-01

data/README.md

@@ -67,4 +67,4 @@ When setting the value for `OTEL_SEMCONV_STABILITY_OPT_IN`, you can specify whic
 
 During the transition from old to stable conventions, Net::HTTP instrumentation code comes in three patch versions: `dup`, `old`, and `stable`. These versions are identical except for the attributes they send. Any changes to Net::HTTP 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/).
+For additional information on migration, please refer to our [documentation](https://opentelemetry.io/docs/specs/semconv/non-normative/http-migration/).

data/lib/opentelemetry/instrumentation/net/http/http_helper.rb

@@ -12,7 +12,7 @@ module OpenTelemetry
         # @api private
         module HttpHelper
           # Lightweight struct to hold span creation attributes
-          SpanCreationAttributes = Struct.new(:span_name, :normalized_method, :original_method, keyword_init: true)
+          SpanCreationAttributes = Struct.new(:span_name, :attributes, keyword_init: true)
 
           # Pre-computed mapping to avoid string allocations during normalization
           METHOD_CACHE = {
@@ -45,41 +45,89 @@ module OpenTelemetry
             :trace => 'TRACE'
           }.freeze
 
-          # Pre-computed span names for old semantic conventions to avoid allocations
-          OLD_SPAN_NAMES = {
-            'CONNECT' => 'HTTP CONNECT',
-            'DELETE' => 'HTTP DELETE',
-            'GET' => 'HTTP GET',
-            'HEAD' => 'HTTP HEAD',
-            'OPTIONS' => 'HTTP OPTIONS',
-            'PATCH' => 'HTTP PATCH',
-            'POST' => 'HTTP POST',
-            'PUT' => 'HTTP PUT',
-            'TRACE' => 'HTTP TRACE'
-          }.freeze
+          private_constant :METHOD_CACHE
+
+          OLD_SPAN_NAMES_BY_METHOD = METHOD_CACHE.values.uniq.each_with_object({}) do |method, hash|
+            hash[method] = "HTTP #{method}"
+          end.freeze
 
-          private_constant :METHOD_CACHE, :OLD_SPAN_NAMES
+          private_constant :OLD_SPAN_NAMES_BY_METHOD
 
-          # Prepares all span data for the specified semantic convention in a single call
+          # Prepares span data using old semantic conventions
           # @param method [String, Symbol] The HTTP method
-          # @param semconv [Symbol] The semantic convention to use (:stable or :old)
-          # @return [SpanCreationAttributes] struct containing span_name, normalized_method, and original_method
-          def self.span_attrs_for(method, semconv: :stable)
+          # @return [SpanCreationAttributes] struct containing span_name and attributes hash
+          def self.span_attrs_for_old(method)
+            client_context_attrs = OpenTelemetry::Common::HTTP::ClientContext.attributes
             normalized = METHOD_CACHE[method]
+            attributes = client_context_attrs.dup
+
+            # Determine base span name and method value
+            if normalized
+              span_name = OLD_SPAN_NAMES_BY_METHOD[normalized]
+              method_value = normalized
+            else
+              span_name = 'HTTP'
+              method_value = '_OTHER'
+            end
+
+            attributes['http.method'] ||= method_value
+
+            SpanCreationAttributes.new(span_name: span_name, attributes: attributes)
+          end
+
+          # Prepares span data using stable semantic conventions
+          # @param method [String, Symbol] The HTTP method
+          # @return [SpanCreationAttributes] struct containing span_name and attributes hash
+          def self.span_attrs_for_stable(method)
+            client_context_attrs = OpenTelemetry::Common::HTTP::ClientContext.attributes
+            url_template = client_context_attrs['url.template']
+            normalized = METHOD_CACHE[method]
+            attributes = client_context_attrs.dup
+
+            # Determine base span name and method value
             if normalized
-              span_name = semconv == :old ? OLD_SPAN_NAMES[normalized] : normalized
-              SpanCreationAttributes.new(
-                span_name: span_name,
-                normalized_method: normalized,
-                original_method: nil
-              )
+              base_name = normalized
+              method_value = normalized
+              original = nil
             else
-              SpanCreationAttributes.new(
-                span_name: 'HTTP',
-                normalized_method: '_OTHER',
-                original_method: method.to_s
-              )
+              base_name = 'HTTP'
+              method_value = '_OTHER'
+              original = method.to_s
             end
+
+            span_name = url_template ? "#{base_name} #{url_template}" : base_name
+            attributes['http.request.method'] ||= method_value
+            attributes['http.request.method_original'] ||= original if original
+
+            SpanCreationAttributes.new(span_name: span_name, attributes: attributes)
+          end
+
+          # Prepares span data using both old and stable semantic conventions
+          # @param method [String, Symbol] The HTTP method
+          # @return [SpanCreationAttributes] struct containing span_name and attributes hash
+          def self.span_attrs_for_dup(method)
+            client_context_attrs = OpenTelemetry::Common::HTTP::ClientContext.attributes
+            url_template = client_context_attrs['url.template']
+            normalized = METHOD_CACHE[method]
+            attributes = client_context_attrs.dup
+
+            # Determine base span name and method value
+            if normalized
+              base_name = normalized
+              method_value = normalized
+              original = nil
+            else
+              base_name = 'HTTP'
+              method_value = '_OTHER'
+              original = method.to_s
+            end
+
+            span_name = url_template ? "#{base_name} #{url_template}" : base_name
+            attributes['http.method'] ||= method_value
+            attributes['http.request.method'] ||= method_value
+            attributes['http.request.method_original'] ||= original if original
+
+            SpanCreationAttributes.new(span_name: span_name, attributes: attributes)
           end
         end
       end

data/lib/opentelemetry/instrumentation/net/http/patches/dup/instrumentation.rb

@@ -23,25 +23,19 @@ module OpenTelemetry
 
                 return super if untraced?
 
-                span_data = HttpHelper.span_attrs_for(req.method)
-
-                attributes = {
-                  OpenTelemetry::SemanticConventions::Trace::HTTP_METHOD => span_data.normalized_method,
-                  OpenTelemetry::SemanticConventions::Trace::HTTP_SCHEME => USE_SSL_TO_SCHEME[use_ssl?],
-                  OpenTelemetry::SemanticConventions::Trace::HTTP_TARGET => req.path,
-                  OpenTelemetry::SemanticConventions::Trace::NET_PEER_NAME => @address,
-                  OpenTelemetry::SemanticConventions::Trace::NET_PEER_PORT => @port,
-                  'http.request.method' => span_data.normalized_method,
-                  'url.scheme' => USE_SSL_TO_SCHEME[use_ssl?],
-                  'server.address' => @address,
-                  'server.port' => @port
-                }
-                attributes['http.request.method_original'] = span_data.original_method if span_data.original_method
+                span_data = HttpHelper.span_attrs_for_dup(req.method)
+
+                attributes = { OpenTelemetry::SemanticConventions::Trace::HTTP_SCHEME => USE_SSL_TO_SCHEME[use_ssl?],
+                               OpenTelemetry::SemanticConventions::Trace::HTTP_TARGET => req.path,
+                               OpenTelemetry::SemanticConventions::Trace::NET_PEER_NAME => @address,
+                               OpenTelemetry::SemanticConventions::Trace::NET_PEER_PORT => @port, 'url.scheme' => USE_SSL_TO_SCHEME[use_ssl?],
+                               'server.address' => @address,
+                               'server.port' => @port }
                 path, query = split_path_and_query(req.path)
                 attributes['url.path'] = path
                 attributes['url.query'] = query if query
 
-                attributes.merge!(OpenTelemetry::Common::HTTP::ClientContext.attributes)
+                attributes.merge!(span_data.attributes)
 
                 tracer.in_span(
                   span_data.span_name,

data/lib/opentelemetry/instrumentation/net/http/patches/old/instrumentation.rb

@@ -23,15 +23,12 @@ module OpenTelemetry
 
                 return super if untraced?
 
-                span_data = HttpHelper.span_attrs_for(req.method, semconv: :old)
+                span_data = HttpHelper.span_attrs_for_old(req.method)
 
-                attributes = {
-                  OpenTelemetry::SemanticConventions::Trace::HTTP_METHOD => span_data.normalized_method,
-                  OpenTelemetry::SemanticConventions::Trace::HTTP_SCHEME => USE_SSL_TO_SCHEME[use_ssl?],
-                  OpenTelemetry::SemanticConventions::Trace::HTTP_TARGET => req.path,
-                  OpenTelemetry::SemanticConventions::Trace::NET_PEER_NAME => @address,
-                  OpenTelemetry::SemanticConventions::Trace::NET_PEER_PORT => @port
-                }.merge!(OpenTelemetry::Common::HTTP::ClientContext.attributes)
+                attributes = { OpenTelemetry::SemanticConventions::Trace::HTTP_SCHEME => USE_SSL_TO_SCHEME[use_ssl?],
+                               OpenTelemetry::SemanticConventions::Trace::HTTP_TARGET => req.path,
+                               OpenTelemetry::SemanticConventions::Trace::NET_PEER_NAME => @address,
+                               OpenTelemetry::SemanticConventions::Trace::NET_PEER_PORT => @port }.merge!(span_data.attributes)
 
                 tracer.in_span(
                   span_data.span_name,

data/lib/opentelemetry/instrumentation/net/http/patches/stable/instrumentation.rb

@@ -23,20 +23,16 @@ module OpenTelemetry
 
                 return super if untraced?
 
-                span_data = HttpHelper.span_attrs_for(req.method)
+                span_data = HttpHelper.span_attrs_for_stable(req.method)
 
-                attributes = {
-                  'http.request.method' => span_data.normalized_method,
-                  'url.scheme' => USE_SSL_TO_SCHEME[use_ssl?],
-                  'server.address' => @address,
-                  'server.port' => @port
-                }
-                attributes['http.request.method_original'] = span_data.original_method if span_data.original_method
+                attributes = { 'url.scheme' => USE_SSL_TO_SCHEME[use_ssl?],
+                               'server.address' => @address,
+                               'server.port' => @port }
                 path, query = split_path_and_query(req.path)
                 attributes['url.path'] = path
                 attributes['url.query'] = query if query
 
-                attributes.merge!(OpenTelemetry::Common::HTTP::ClientContext.attributes)
+                attributes.merge!(span_data.attributes)
 
                 tracer.in_span(
                   span_data.span_name,

data/lib/opentelemetry/instrumentation/net/http/version.rb

@@ -8,7 +8,7 @@ module OpenTelemetry
   module Instrumentation
     module Net
       module HTTP
-        VERSION = '0.26.1'
+        VERSION = '0.27.0'
       end
     end
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: opentelemetry-instrumentation-net_http
 version: !ruby/object:Gem::Version
-  version: 0.26.1
+  version: 0.27.0
 platform: ruby
 authors:
 - OpenTelemetry Authors
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-11-25 00:00:00.000000000 Z
+date: 2026-01-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: opentelemetry-instrumentation-base
@@ -48,10 +48,10 @@ homepage: https://github.com/open-telemetry/opentelemetry-ruby-contrib
 licenses:
 - Apache-2.0
 metadata:
-  changelog_uri: https://rubydoc.info/gems/opentelemetry-instrumentation-net_http/0.26.1/file/CHANGELOG.md
+  changelog_uri: https://rubydoc.info/gems/opentelemetry-instrumentation-net_http/0.27.0/file/CHANGELOG.md
   source_code_uri: https://github.com/open-telemetry/opentelemetry-ruby-contrib/tree/main/instrumentation/net_http
   bug_tracker_uri: https://github.com/open-telemetry/opentelemetry-ruby-contrib/issues
-  documentation_uri: https://rubydoc.info/gems/opentelemetry-instrumentation-net_http/0.26.1
+  documentation_uri: https://rubydoc.info/gems/opentelemetry-instrumentation-net_http/0.27.0
 post_install_message:
 rdoc_options: []
 require_paths: