opentelemetry-api 1.11.0 → 1.11.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 54f9aefb3cf00989b6f8ec91622bfcf4ed990bcc898fe8850655a13aa7502153
-  data.tar.gz: cdbe2376c9bed2b603dbd6fe0b554a506c2c82f21b340e43cc54368acfebc9e4
+  metadata.gz: 8f644a53d810a077cc3a490e49b8f4ae2b232557a51ff7764c5c137c4cf9065d
+  data.tar.gz: 5a8ce03439efaff86ae15ad66271700819b3331b94294b7e10b2a1bb8d89febe
 SHA512:
-  metadata.gz: 5cca57e3ddc7cbe682f1d606d45bd0336e0256f69acce2060d9905d2e5c54e96ff05ee30c5bbba671fa95ed736344873f1af8361f7a3a6ede6bd4ce2ee5a3558
-  data.tar.gz: 1ddc9c956939364f9b783abb42660859bbc2020a36d77b4b1cf348b401e1d3736a9b7758b44d7f41ff153db1eb2f102fee6ab708b555b79b05a35e1463068b63
+  metadata.gz: 64d8b2489ba3f982966be8edabaaf0d9ffb1b1e28657a5991f1abc84c06fb1228be7bee58a1d2cd432ff392a6abde2e54b6acfae7dc218b2f76f06e1d0166854
+  data.tar.gz: 1b2482b2cf3e8a6649b96a8f67c8e6fdd4da6c1ceaec08f7acd44b294763e55f0f9f6fc399738dabe476db61094a49c5bd98383d0f395d768d70b6ea63ac7ca7

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Release History: opentelemetry-api
 
+### v1.11.1 / 2026-09-15
+
+* FIXED: Enforce W3C Baggage limits on the extract path (#2298)
+* DOCS: Document custom error handlers (#2264)
+
 ### v1.11.0 / 2026-07-21
 
 * ADDED: Add attributes support to instrumentation scope for tracers (#2094)

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

@@ -55,17 +55,10 @@ module OpenTelemetry
           header = getter.get(carrier, BAGGAGE_KEY)
           return context if header.nil? || header.empty?
 
-          entries = header.gsub(/\s/, '').split(',')
+          entries = split_entries(header)
 
           OpenTelemetry::Baggage.build(context: context) do |builder|
-            entries.each do |entry|
-              # Note metadata is currently unused in OpenTelemetry, but is part
-              # 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! { |part| URI.decode_uri_component(part) }
-              builder.set_value(k, v, metadata: meta)
-            end
+            decode_entries(entries, builder)
           end
         rescue StandardError => e
           OpenTelemetry.logger.debug "Error extracting W3C baggage: #{e.message}"
@@ -82,6 +75,38 @@ module OpenTelemetry
 
         private
 
+        def split_entries(header)
+          return header.split(',') if header.bytesize <= MAX_TOTAL_LENGTH
+
+          window = header.byteslice(0, MAX_TOTAL_LENGTH + 1)
+          last_separator = window.byterindex(',')
+          return [] unless last_separator
+
+          window.byteslice(0, last_separator).split(',')
+        end
+
+        def decode_entries(entries, builder)
+          decoded_length = 0
+          decoded_count = 0
+          entries.each do |raw_entry|
+            break unless decoded_count < MAX_ENTRIES
+
+            entry = raw_entry.gsub(/\s/, '')
+            next if entry.empty?
+            next unless entry.bytesize <= MAX_ENTRY_LENGTH &&
+                        entry.bytesize + decoded_length <= MAX_TOTAL_LENGTH
+
+            # Note metadata is currently unused in OpenTelemetry, but is part
+            # 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! { |part| URI.decode_uri_component(part) }
+            builder.set_value(k, v, metadata: meta)
+            decoded_length += entry.bytesize + 1
+            decoded_count += 1
+          end
+        end
+
         def encode(baggage)
           result = +''
           encoded_count = 0

data/lib/opentelemetry/context.rb

@@ -67,6 +67,7 @@ module OpenTelemetry # rubocop:disable Style/Documentation
       #
       # @param [Context] ctx The context to be made active
       # @yield [context] Yields context to the block
+      # @yieldparam [Context] context The active context
       def with_current(ctx)
         token = attach(ctx)
         yield ctx
@@ -79,9 +80,10 @@ module OpenTelemetry # rubocop:disable Style/Documentation
 
       # @param [String] key The lookup key
       # @param [Object] value The object stored under key
-      # @param [Callable] Block to execute in a new context
       # @yield [context, value] Yields the newly created context and value to
       #   the block
+      # @yieldparam [Context] context The newly created context
+      # @yieldparam [Object] value The object stored under key
       def with_value(key, value)
         ctx = current.set_value(key, value)
         token = attach(ctx)
@@ -93,12 +95,12 @@ module OpenTelemetry # rubocop:disable Style/Documentation
       # Execute a block in a new context where its values are merged with the
       # incoming values. Restores the previous context after the block executes.
 
-      # @param [String] key The lookup key
       # @param [Hash] values Will be merged with values of the current context
       #  and returned in a new context
-      # @param [Callable] Block to execute in a new context
       # @yield [context, values] Yields the newly created context and values
       #   to the block
+      # @yieldparam [Context] context The newly created context
+      # @yieldparam [Hash] values The values merged into the new context
       def with_values(values)
         ctx = current.set_values(values)
         token = attach(ctx)
@@ -119,6 +121,9 @@ module OpenTelemetry # rubocop:disable Style/Documentation
         Fiber.current.opentelemetry_context = []
       end
 
+      # Returns an empty context.
+      #
+      # @return [Context]
       def empty
         new(EMPTY_ENTRIES)
       end
@@ -160,7 +165,6 @@ module OpenTelemetry # rubocop:disable Style/Documentation
     #
     # @param [Hash] values The values to be merged with the current context's
     #   entries.
-    # @param [Object] value Object to be stored under key
     # @return [Context]
     def set_values(values) # rubocop:disable Naming/AccessorMethodName
       Context.new(@entries.merge(values))

data/lib/opentelemetry/trace/span.rb

@@ -93,7 +93,7 @@ module OpenTelemetry
       # documents} certain "standard attributes" that have prescribed semantic
       # meanings.
       #
-      # @param [OpenTelemetry::Trace::Link] the link object to add on the {Span}.
+      # @param [OpenTelemetry::Trace::Link] link The link object to add on the {Span}.
       #
       # @return [self] returns itself
       def add_link(link)

data/lib/opentelemetry/trace.rb

@@ -53,8 +53,9 @@ module OpenTelemetry
     # Returns a context containing the span, derived from the optional parent
     # context, or the current context if one was not provided.
     #
-    # @param [optional Context] context The context to use as the parent for
-    #   the returned context
+    # @param [Span] span The span to store in the returned context.
+    # @param [Context] parent_context The optional context to use as the parent
+    #   for the returned context.
     def context_with_span(span, parent_context: Context.current)
       parent_context.set_value(CURRENT_SPAN_KEY, span)
     end

data/lib/opentelemetry/version.rb

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

data/lib/opentelemetry.rb

@@ -24,13 +24,28 @@ module OpenTelemetry
   @mutex = Mutex.new
   @tracer_provider = Internal::ProxyTracerProvider.new
 
-  attr_writer :propagation, :logger, :error_handler
+  attr_writer :propagation, :logger
 
   # @return [Object, Logger] configured Logger or a default STDOUT Logger.
   def logger
     @logger ||= Logger.new($stdout, level: ENV['OTEL_LOG_LEVEL'] || Logger::INFO)
   end
 
+  # Configures error handler used by {handle_error}.
+  #
+  # Assigned object must respond to +#call+ and accept the keyword arguments
+  # +exception:+ and +message:+.
+  #
+  # @param [#call] error_handler The error handler to use
+  #
+  # @example Log OpenTelemetry errors with a custom prefix
+  #   OpenTelemetry.error_handler = lambda do |exception: nil, message: nil|
+  #     OpenTelemetry.logger.warn("otel: #{[message, exception&.message].compact.join(' - ')}")
+  #   end
+  def error_handler=(error_handler)
+    @error_handler = error_handler
+  end
+
   # @return [Callable] configured error handler or a default that logs the
   #   exception and message at ERROR level.
   def error_handler

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: opentelemetry-api
 version: !ruby/object:Gem::Version
-  version: 1.11.0
+  version: 1.11.1
 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.11.0/file/CHANGELOG.md
-  source_code_uri: https://github.com/open-telemetry/opentelemetry-ruby/tree/opentelemetry-api/v1.11.0/api
+  changelog_uri: https://rubydoc.info/gems/opentelemetry-api/1.11.1/file/CHANGELOG.md
+  source_code_uri: https://github.com/open-telemetry/opentelemetry-ruby/tree/opentelemetry-api/v1.11.1/api
   bug_tracker_uri: https://github.com/open-telemetry/opentelemetry-ruby/issues
-  documentation_uri: https://rubydoc.info/gems/opentelemetry-api/1.11.0
+  documentation_uri: https://rubydoc.info/gems/opentelemetry-api/1.11.1
 rdoc_options: []
 require_paths:
 - lib