opentelemetry-api 1.10.0 → 1.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c73be354c7e8b1904d9b1e68db9c61dcce2accbca66b98e01dcfec6b0e0ed049
-  data.tar.gz: c2465cae1e0da0b093aef81546481fd78e7e26f79fc434f457365ec3abaa24ba
+  metadata.gz: 54f9aefb3cf00989b6f8ec91622bfcf4ed990bcc898fe8850655a13aa7502153
+  data.tar.gz: cdbe2376c9bed2b603dbd6fe0b554a506c2c82f21b340e43cc54368acfebc9e4
 SHA512:
-  metadata.gz: dd1a8b3b3854aba2ccb9a43130f56410e169c8299d73ea224c4cfbb33688d9e09640de176396d39a3aad3f479d03b8d99ba4079164bbec1997492758a2bf4eff
-  data.tar.gz: 8d3d993995f3c4bce31b2491db27f4e378579e91ba1b0f6cc12acd42d21d9c64f97b7be985769cc584a7e369407ed223ac4899b175763252445dfc4312de9472
+  metadata.gz: 5cca57e3ddc7cbe682f1d606d45bd0336e0256f69acce2060d9905d2e5c54e96ff05ee30c5bbba671fa95ed736344873f1af8361f7a3a6ede6bd4ce2ee5a3558
+  data.tar.gz: 1ddc9c956939364f9b783abb42660859bbc2020a36d77b4b1cf348b401e1d3736a9b7758b44d7f41ff153db1eb2f102fee6ab708b555b79b05a35e1463068b63

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # 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)
+
 ### v1.10.0 / 2026-05-12
 
 * ADDED: Add git tag to source URI in gemspec (#2101)
@@ -126,9 +134,6 @@
 ### v0.17.0 / 2021-04-22
 
 - BREAKING CHANGE: Replace TextMapInjector/TextMapExtractor pairs with a TextMapPropagator.
-
-  [Check the propagator documentation](https://open-telemetry.github.io/opentelemetry-ruby/) for the new usage.
-
 - BREAKING CHANGE: Remove metrics API.
 
   `OpenTelemetry::Metrics` and all of its behavior removed until spec stabilizes.

data/lib/opentelemetry/baggage/propagation/text_map_propagator.rb

@@ -34,7 +34,7 @@ module OpenTelemetry
           return if baggage.nil? || baggage.empty?
 
           encoded_baggage = encode(baggage)
-          setter.set(carrier, BAGGAGE_KEY, encoded_baggage) unless encoded_baggage&.empty?
+          setter.set(carrier, BAGGAGE_KEY, encoded_baggage) if encoded_baggage && !encoded_baggage.empty?
           nil
         end
 
@@ -63,7 +63,7 @@ module OpenTelemetry
               # the W3C spec where it's referred to as properties. We preserve
               # the properties (as-is) so that they can be propagated elsewhere.
               kv, meta = entry.split(';', 2)
-              k, v = kv.split('=').map!(&URI.method(:decode_uri_component))
+              k, v = kv.split('=').map! { |part| URI.decode_uri_component(part) }
               builder.set_value(k, v, metadata: meta)
             end
           end
@@ -99,7 +99,7 @@ module OpenTelemetry
         end
 
         def encode_value(key, entry)
-          result = +"#{URI.encode_uri_component(key.to_s)}=#{URI.encode_uri_component(entry.value.to_s)}"
+          result = "#{URI.encode_uri_component(key.to_s)}=#{URI.encode_uri_component(entry.value.to_s)}"
           # We preserve metadata received on extract and assume it's already formatted
           # for transport. It's sent as-is without further processing.
           result << ";#{entry.metadata}" if entry.metadata

data/lib/opentelemetry/context/propagation/rack_env_getter.rb

@@ -26,14 +26,13 @@ module OpenTelemetry
         # form to the original. The resulting keys will be lowercase and
         # underscores will be replaced with dashes.
         def keys(carrier)
-          carrier.keys.map(&method(:from_rack_key))
+          carrier.keys.map { |k| from_rack_key(k) }
         end
 
         private
 
         def to_rack_key(key)
-          # Use + for mutable string interpolation in pre-Ruby 3.0.
-          ret = +"HTTP_#{key}"
+          ret = "HTTP_#{key}"
           ret.tr!('-', '_')
           ret.upcase!
           ret

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
@@ -162,7 +162,7 @@ module OpenTelemetry # rubocop:disable Style/Documentation
     #   entries.
     # @param [Object] value Object to be stored under key
     # @return [Context]
-    def set_values(values) # rubocop:disable Naming/AccessorMethodName:
+    def set_values(values) # rubocop:disable Naming/AccessorMethodName
       Context.new(@entries.merge(values))
     end
 

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/propagation/trace_context.rb

@@ -14,6 +14,7 @@ module OpenTelemetry
       # for context propagation in the W3C Trace Context format.
       module TraceContext
         extend self
+
         TEXT_MAP_PROPAGATOR = TextMapPropagator.new
 
         private_constant :TEXT_MAP_PROPAGATOR

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

@@ -18,7 +18,7 @@ module OpenTelemetry
         # @param [String] header Encoding of the tracestate header defined by
         #   the W3C Trace Context specification https://www.w3.org/TR/trace-context/
         # @return [Tracestate] A new Tracestate instance or DEFAULT
-        def from_string(header) # rubocop:disable Metrics/CyclomaticComplexity:
+        def from_string(header) # rubocop:disable Metrics/CyclomaticComplexity
           return DEFAULT if header.nil? || header.empty?
 
           hash = header.split(',').each_with_object({}) do |member, memo|
@@ -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.0'
+  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.0
+  version: 1.11.0
 platform: ruby
 authors:
 - OpenTelemetry Authors
@@ -23,20 +23,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: benchmark-ips
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 2.14.0
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 2.14.0
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
   requirement: !ruby/object:Gem::Requirement
@@ -51,104 +37,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.3'
-- !ruby/object:Gem::Dependency
-  name: minitest
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.0'
-- !ruby/object:Gem::Dependency
-  name: opentelemetry-test-helpers
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '13.3'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '13.3'
-- !ruby/object:Gem::Dependency
-  name: rubocop
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.65'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.65'
-- !ruby/object:Gem::Dependency
-  name: simplecov
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.17'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.17'
-- !ruby/object:Gem::Dependency
-  name: yard
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.9'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.9'
-- !ruby/object:Gem::Dependency
-  name: yard-doctest
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.1.6
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.1.6
 description: A stats collection and distributed tracing framework
 email:
 - cncf-opentelemetry-contributors@lists.cncf.io
@@ -200,10 +88,10 @@ homepage: https://github.com/open-telemetry/opentelemetry-ruby
 licenses:
 - Apache-2.0
 metadata:
-  changelog_uri: https://open-telemetry.github.io/opentelemetry-ruby/opentelemetry-api/v1.10.0/file.CHANGELOG.html
-  source_code_uri: https://github.com/open-telemetry/opentelemetry-ruby/tree/opentelemetry-api/v1.10.0/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://open-telemetry.github.io/opentelemetry-ruby/opentelemetry-api/v1.10.0
+  documentation_uri: https://rubydoc.info/gems/opentelemetry-api/1.11.0
 rdoc_options: []
 require_paths:
 - lib
@@ -218,7 +106,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.6
+rubygems_version: 4.0.16
 specification_version: 4
 summary: A stats collection and distributed tracing framework
 test_files: []