opentelemetry-api 1.10.1 → 1.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 577b4d995e92df80c49e13b5995b56235170108a93fdf101b38e2de820412bee
-  data.tar.gz: 7d01b537dba1d74c3f151729511ce30c881382f7f3984fef38409678eb329aee
+  metadata.gz: 54f9aefb3cf00989b6f8ec91622bfcf4ed990bcc898fe8850655a13aa7502153
+  data.tar.gz: cdbe2376c9bed2b603dbd6fe0b554a506c2c82f21b340e43cc54368acfebc9e4
 SHA512:
-  metadata.gz: 4ee45cb43c2e7ab4adb6ed95902d9921f63ce2cef8e4afdbea6ff24ece293f59f954a3f628d5a1d02c2a00367a2916e8034f4e2a2c5733d94603074cd1943822
-  data.tar.gz: 64e63c75db2dc7a5c7c5e0018aa4eff78d019d394026679c83fa07beb918999a037da5f3fe4b87c9b1ae5c61fc53bb8f4917c8a11949ee829cda96da54a32a10
+  metadata.gz: 5cca57e3ddc7cbe682f1d606d45bd0336e0256f69acce2060d9905d2e5c54e96ff05ee30c5bbba671fa95ed736344873f1af8361f7a3a6ede6bd4ce2ee5a3558
+  data.tar.gz: 1ddc9c956939364f9b783abb42660859bbc2020a36d77b4b1cf348b401e1d3736a9b7758b44d7f41ff153db1eb2f102fee6ab708b555b79b05a35e1463068b63

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release History: opentelemetry-api
 
+### v1.11.0 / 2026-07-21
+
+* ADDED: Add attributes support to instrumentation scope for tracers (#2094)
+
 ### v1.10.1 / 2026-07-08
 
 * DOCS: Update source for gemspec links to RubyDoc (#2123)

data/lib/opentelemetry/context.rb

@@ -15,7 +15,7 @@ module OpenTelemetry # rubocop:disable Style/Documentation
     EMPTY_ENTRIES = {}.freeze
     private_constant :EMPTY_ENTRIES
 
-    DetachError = Class.new(OpenTelemetry::Error)
+    DetachError = Class.new(OpenTelemetry::Error) # rubocop:disable Style/EmptyClassDefinition
 
     class << self
       # Returns a key used to index a value in a Context

data/lib/opentelemetry/internal/proxy_tracer_provider.rb

@@ -13,9 +13,22 @@ module OpenTelemetry
     # It delegates to a "real" TracerProvider after the global tracer provider is registered.
     # It returns {ProxyTracer} instances until the delegate is installed.
     class ProxyTracerProvider < Trace::TracerProvider
-      Key = Struct.new(:name, :version)
+      Key = Struct.new(:name, :version, :attributes)
       private_constant(:Key)
 
+      # Wraps a legacy TracerProvider whose `#tracer` method does not accept
+      # the `attributes:` keyword argument, dropping the argument on delegation.
+      class LegacyProviderWrapper
+        def initialize(legacy_provider)
+          @legacy_provider = legacy_provider
+        end
+
+        def tracer(name = nil, version = nil, attributes: nil)
+          @legacy_provider.tracer(name, version)
+        end
+      end
+      private_constant(:LegacyProviderWrapper)
+
       # Returns a new {ProxyTracerProvider} instance.
       #
       # @return [ProxyTracerProvider]
@@ -35,25 +48,45 @@ module OpenTelemetry
           return
         end
 
+        provider = LegacyProviderWrapper.new(provider) unless supports_attributes?(provider)
+
         @mutex.synchronize do
           @delegate = provider
-          @registry.each { |key, tracer| tracer.delegate = provider.tracer(key.name, key.version) }
+          @registry.each { |key, tracer| tracer.delegate = @delegate.tracer(key.name, key.version, attributes: key.attributes) }
         end
       end
 
       # Returns a {Tracer} instance.
       #
-      # @param [optional String] name Instrumentation package name
-      # @param [optional String] version Instrumentation package version
+      # Supports both positional arguments (legacy) and keyword arguments:
+      #   tracer('name', '1.0')                                    # legacy positional
+      #   tracer(name: 'name', version: '1.0', attributes: {...})  # keyword
+      #
+      # When both positional and keyword arguments are provided for the same
+      # parameter, the keyword argument takes precedence.
+      #
+      # @param [String] name Instrumentation scope name
+      # @param [String] version Instrumentation scope version
+      # @param [Hash{String => String, Numeric, Boolean, Array<String, Numeric, Boolean>}] attributes
+      #   Instrumentation scope attributes
       #
       # @return [Tracer]
-      def tracer(name = nil, version = nil)
+      def tracer(deprecated_name = nil, deprecated_version = nil, name: nil, version: nil, attributes: nil)
+        name ||= deprecated_name
+        version ||= deprecated_version
         @mutex.synchronize do
-          return @delegate.tracer(name, version) unless @delegate.nil?
+          return @delegate.tracer(name, version, attributes: attributes) unless @delegate.nil?
 
-          @registry[Key.new(name, version)] ||= ProxyTracer.new
+          @registry[Key.new(name, version, attributes)] ||= ProxyTracer.new
         end
       end
+
+      private
+
+      def supports_attributes?(provider)
+        provider.respond_to?(:tracer) &&
+          provider.method(:tracer).parameters.any? { |_, n| n == :attributes }
+      end
     end
   end
 end

data/lib/opentelemetry/trace/propagation/trace_context/trace_parent.rb

@@ -11,10 +11,12 @@ module OpenTelemetry
         # https://www.w3.org/TR/trace-context/
         # {Trace::SpanContext}
         class TraceParent
+          # rubocop:disable Style/EmptyClassDefinition
           InvalidFormatError = Class.new(Error)
           InvalidVersionError = Class.new(Error)
           InvalidTraceIDError = Class.new(Error)
           InvalidSpanIDError = Class.new(Error)
+          # rubocop:enable Style/EmptyClassDefinition
 
           TRACE_PARENT_HEADER = 'traceparent'
           SUPPORTED_VERSION = 0

data/lib/opentelemetry/trace/trace_flags.rb

@@ -40,7 +40,7 @@ module OpenTelemetry
       #
       # @return [Boolean]
       def sampled?
-        (@flags & 1) != 0
+        @flags.anybits?(1)
       end
 
       DEFAULT = from_byte(0)

data/lib/opentelemetry/trace/tracer.rb

@@ -34,7 +34,7 @@ module OpenTelemetry
       def in_span(name, attributes: nil, links: nil, start_timestamp: nil, kind: nil, record_exception: true)
         span = nil
         span = start_span(name, attributes: attributes, links: links, start_timestamp: start_timestamp, kind: kind)
-        Trace.with_span(span) { |s, c| yield s, c }
+        Trace.with_span(span) { |s, c| yield s, c } # rubocop:disable Style/ExplicitBlockArgument
       rescue Exception => e # rubocop:disable Lint/RescueException
         span&.record_exception(e) if record_exception
         span&.status = Status.error("Unhandled exception of type: #{e.class}")

data/lib/opentelemetry/trace/tracer_provider.rb

@@ -10,11 +10,20 @@ module OpenTelemetry
     class TracerProvider
       # Returns a {Tracer} instance.
       #
-      # @param [optional String] name Instrumentation package name
-      # @param [optional String] version Instrumentation package version
+      # Supports both positional arguments (legacy) and keyword arguments:
+      #   tracer('name', '1.0')                                    # legacy positional
+      #   tracer(name: 'name', version: '1.0', attributes: {...})  # keyword
+      #
+      # When both positional and keyword arguments are provided for the same
+      # parameter, the keyword argument takes precedence.
+      #
+      # @param [String] name Instrumentation scope name
+      # @param [String] version Instrumentation scope version
+      # @param [Hash{String => String, Numeric, Boolean, Array<String, Numeric, Boolean>}] attributes
+      #   Instrumentation scope attributes
       #
       # @return [Tracer]
-      def tracer(name = nil, version = nil)
+      def tracer(deprecated_name = nil, deprecated_version = nil, name: nil, version: nil, attributes: nil)
         @tracer ||= Tracer.new
       end
     end

data/lib/opentelemetry/trace/tracestate.rb

@@ -75,7 +75,7 @@ module OpenTelemetry
       # @return [Tracestate]
       def initialize(hash)
         excess = hash.size - MAX_MEMBER_COUNT
-        hash = Hash[hash.drop(excess)] if excess.positive?
+        hash = hash.drop(excess).to_h if excess.positive?
         @hash = hash.freeze
       end
 
@@ -105,7 +105,7 @@ module OpenTelemetry
           return self
         end
 
-        h = Hash[@hash]
+        h = @hash.to_h.dup
         h[key] = value
         self.class.create(h)
       end
@@ -118,7 +118,7 @@ module OpenTelemetry
       def delete(key)
         return self unless @hash.key?(key)
 
-        h = Hash[@hash]
+        h = @hash.to_h.dup
         h.delete(key)
         self.class.create(h)
       end

data/lib/opentelemetry/version.rb

@@ -6,5 +6,5 @@
 
 module OpenTelemetry
   ## Current OpenTelemetry version
-  VERSION = '1.10.1'
+  VERSION = '1.11.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: opentelemetry-api
 version: !ruby/object:Gem::Version
-  version: 1.10.1
+  version: 1.11.0
 platform: ruby
 authors:
 - OpenTelemetry Authors
@@ -88,10 +88,10 @@ homepage: https://github.com/open-telemetry/opentelemetry-ruby
 licenses:
 - Apache-2.0
 metadata:
-  changelog_uri: https://rubydoc.info/gems/opentelemetry-api/1.10.1/file/CHANGELOG.md
-  source_code_uri: https://github.com/open-telemetry/opentelemetry-ruby/tree/opentelemetry-api/v1.10.1/api
+  changelog_uri: https://rubydoc.info/gems/opentelemetry-api/1.11.0/file/CHANGELOG.md
+  source_code_uri: https://github.com/open-telemetry/opentelemetry-ruby/tree/opentelemetry-api/v1.11.0/api
   bug_tracker_uri: https://github.com/open-telemetry/opentelemetry-ruby/issues
-  documentation_uri: https://rubydoc.info/gems/opentelemetry-api/1.10.1
+  documentation_uri: https://rubydoc.info/gems/opentelemetry-api/1.11.0
 rdoc_options: []
 require_paths:
 - lib
@@ -106,7 +106,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.10
+rubygems_version: 4.0.16
 specification_version: 4
 summary: A stats collection and distributed tracing framework
 test_files: []