opentelemetry-sdk 1.12.0 → 1.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d3df2132b43045e07cb0f13e49c8d7e00d9f624396fea32fda8e21cabf2e7e55
-  data.tar.gz: 5ac5bc174189cefdf16fcc0579c52c5121c4590847b600ed1d2a7ae996449537
+  metadata.gz: d263c7e1224cad3b9e7a9ac1fc958dae76c9bc9788df4dde53b56d5603cfd22e
+  data.tar.gz: e2a8d6e023dfbc277b37bd0df76a4903adab343e3b3be2173a6943806141904d
 SHA512:
-  metadata.gz: 34379d5470bf7049327bc9d39c1ce33efed2239e5485145fd1e37382502c68fa73e81bf3808dbd665b54cbc88e0701a40829ed47e5df4112c0464eaf69fa7c7e
-  data.tar.gz: 675da7f819bf56f36b4290d29fe18bb2ffade8af3ad3a7c11a720730422bc31e6980af5621d45ed1441c31c45eee3e88b2d2e0633e33b4c93eb328d0df0f5679
+  metadata.gz: '088ced3e6d379e35df9790f999287ecca88c2f79ac7b4c8bdf162c89e8e19bca49bebd1d084ff4dfe872e2d70aaad1b0c8dd1c11e0e1686fd297b05d42f3435f'
+  data.tar.gz: 7b1c670d348ba097b8721c3b30843ceb693d62985e8e798d9589e87792d85388c7d32cd2c618c90317f53a780f2199a6916b07fc817456fec3c0c431f90e442e

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release History: opentelemetry-sdk
 
+### v1.13.0 / 2026-07-21
+
+* ADDED: Add attributes support to instrumentation scope for tracers (#2094)
+
+### v1.12.1 / 2026-07-08
+
+* DOCS: Update source for gemspec links to RubyDoc (#2123)
+
 ### v1.12.0 / 2026-05-12
 
 * ADDED: Add git tag to source URI in gemspec (#2101)
@@ -162,9 +170,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.
-
 - ADDED: Add zipkin exporter
 - ADDED: Processors validate exporters on init.
 - ADDED: Add configurable truncation of span and event attribute values

data/lib/opentelemetry/sdk/configurator.rb

@@ -190,11 +190,11 @@ module OpenTelemetry
           when 'otlp'
             otlp_protocol = ENV['OTEL_EXPORTER_OTLP_TRACES_PROTOCOL'] || ENV['OTEL_EXPORTER_OTLP_PROTOCOL'] || 'http/protobuf'
 
-            if otlp_protocol != 'http/protobuf'
+            if otlp_protocol == 'http/protobuf'
+              fetch_exporter(exporter, 'OpenTelemetry::Exporter::OTLP::Exporter')
+            else
               OpenTelemetry.logger.warn "The #{otlp_protocol} transport protocol is not supported by the OTLP exporter, spans will not be exported."
               nil
-            else
-              fetch_exporter(exporter, 'OpenTelemetry::Exporter::OTLP::Exporter')
             end
           when 'jaeger' then fetch_exporter(exporter, 'OpenTelemetry::Exporter::Jaeger::CollectorExporter')
           when 'zipkin' then fetch_exporter(exporter, 'OpenTelemetry::Exporter::Zipkin::Exporter')

data/lib/opentelemetry/sdk/forwarding_logger.rb

@@ -35,34 +35,34 @@ module OpenTelemetry
         end
       end
 
-      def add(severity, message = nil, progname = nil, &block)
+      def add(severity, message = nil, progname = nil, &)
         return true if severity < @level
 
-        @logger.add(severity, message, progname, &block)
+        @logger.add(severity, message, progname, &)
       end
 
-      def debug(progname = nil, &block)
-        add(Logger::DEBUG, nil, progname, &block)
+      def debug(progname = nil, &)
+        add(Logger::DEBUG, nil, progname, &)
       end
 
-      def info(progname = nil, &block)
-        add(Logger::INFO, nil, progname, &block)
+      def info(progname = nil, &)
+        add(Logger::INFO, nil, progname, &)
       end
 
-      def warn(progname = nil, &block)
-        add(Logger::WARN, nil, progname, &block)
+      def warn(progname = nil, &)
+        add(Logger::WARN, nil, progname, &)
       end
 
-      def error(progname = nil, &block)
-        add(Logger::ERROR, nil, progname, &block)
+      def error(progname = nil, &)
+        add(Logger::ERROR, nil, progname, &)
       end
 
-      def fatal(progname = nil, &block)
-        add(Logger::FATAL, nil, progname, &block)
+      def fatal(progname = nil, &)
+        add(Logger::FATAL, nil, progname, &)
       end
 
-      def unknown(progname = nil, &block)
-        add(Logger::UNKNOWN, nil, progname, &block)
+      def unknown(progname = nil, &)
+        add(Logger::UNKNOWN, nil, progname, &)
       end
     end
   end

data/lib/opentelemetry/sdk/instrumentation_scope.rb

@@ -8,6 +8,7 @@ module OpenTelemetry
   module SDK
     # InstrumentationScope is a struct containing scope information for export.
     InstrumentationScope = Struct.new(:name,
-                                      :version)
+                                      :version,
+                                      :attributes)
   end
 end

data/lib/opentelemetry/sdk/internal.rb

@@ -34,7 +34,7 @@ module OpenTelemetry
 
         case value.first
         when String
-          value.all? { |v| v.instance_of?(String) }
+          value.all?(String)
         when TrueClass, FalseClass
           value.all? { |v| boolean?(v) }
         when Numeric

data/lib/opentelemetry/sdk/resources/resource.rb

@@ -41,7 +41,7 @@ module OpenTelemetry
               SemanticConventions::Resource::TELEMETRY_SDK_VERSION => OpenTelemetry::SDK::VERSION
             }
 
-            resource_pairs = ENV['OTEL_RESOURCE_ATTRIBUTES']
+            resource_pairs = ENV.fetch('OTEL_RESOURCE_ATTRIBUTES', nil)
             return create(resource_attributes) unless resource_pairs.is_a?(String)
 
             resource_pairs.split(',').each do |pair|
@@ -68,7 +68,7 @@ module OpenTelemetry
           private
 
           def service_name_from_env
-            service_name = ENV['OTEL_SERVICE_NAME']
+            service_name = ENV.fetch('OTEL_SERVICE_NAME', nil)
             create(SemanticConventions::Resource::SERVICE_NAME => service_name) unless service_name.nil?
           end
         end

data/lib/opentelemetry/sdk/trace/export/batch_span_processor.rb

@@ -49,7 +49,7 @@ module OpenTelemetry
                          schedule_delay: Float(ENV.fetch('OTEL_BSP_SCHEDULE_DELAY', 5_000)),
                          max_queue_size: Integer(ENV.fetch('OTEL_BSP_MAX_QUEUE_SIZE', 2048)),
                          max_export_batch_size: Integer(ENV.fetch('OTEL_BSP_MAX_EXPORT_BATCH_SIZE', 512)),
-                         start_thread_on_boot: String(ENV['OTEL_RUBY_BSP_START_THREAD_ON_BOOT']) !~ /false/i,
+                         start_thread_on_boot: String(ENV.fetch('OTEL_RUBY_BSP_START_THREAD_ON_BOOT', nil)) !~ /false/i,
                          metrics_reporter: nil)
             raise ArgumentError if max_export_batch_size > max_queue_size
             raise ArgumentError, "exporter #{exporter.inspect} does not appear to be a valid exporter" unless Common::Utilities.valid_exporter?(exporter)
@@ -210,9 +210,11 @@ module OpenTelemetry
           end
 
           def lock
+            # rubocop:disable Style/ExplicitBlockArgument
             @mutex.synchronize do
               yield
             end
+            # rubocop:enable Style/ExplicitBlockArgument
           end
         end
       end

data/lib/opentelemetry/sdk/trace/samplers/trace_id_ratio_based.rb

@@ -16,7 +16,7 @@ module OpenTelemetry
 
           def initialize(probability)
             @probability = probability
-            @id_upper_bound = (probability * (2**64 - 1)).ceil
+            @id_upper_bound = (probability * ((2**64) - 1)).ceil
             @description = format('TraceIdRatioBased{%.6f}', probability)
           end
 
@@ -39,7 +39,9 @@ module OpenTelemetry
           private
 
           def sample?(trace_id)
+            # rubocop:disable Lint/FloatComparison
             @probability == 1.0 || trace_id[8, 8].unpack1('Q>') < @id_upper_bound
+            # rubocop:enable Lint/FloatComparison
           end
         end
       end

data/lib/opentelemetry/sdk/trace/span.rb

@@ -418,7 +418,7 @@ module OpenTelemetry
           excess_link_count = valid_links.size - link_count_limit
           valid_links.pop(excess_link_count) if excess_link_count.positive?
           valid_links.map! do |link|
-            attrs = Hash[link.attributes] # link.attributes is frozen, so we need an unfrozen copy to adjust.
+            attrs = link.attributes.to_h.dup # link.attributes is frozen, so we need an unfrozen copy to adjust.
             attrs.keep_if { |key, value| Internal.valid_key?(key) && Internal.valid_value?(value) }
             excess = attrs.size - link_attribute_count_limit
             excess.times { attrs.shift } if excess.positive?
@@ -444,7 +444,7 @@ module OpenTelemetry
 
           excess = event.attributes.size - event_attribute_count_limit
           if excess.positive? || !valid_attributes
-            attrs = Hash[event.attributes] # event.attributes is frozen, so we need an unfrozen copy to adjust.
+            attrs = event.attributes.to_h.dup # event.attributes is frozen, so we need an unfrozen copy to adjust.
             attrs.keep_if { |key, value| Internal.valid_key?(key) && Internal.valid_value?(value) }
             excess = attrs.size - event_attribute_count_limit
             excess.times { attrs.shift } if excess.positive?

data/lib/opentelemetry/sdk/trace/tracer.rb

@@ -13,13 +13,15 @@ module OpenTelemetry
         #
         # Returns a new {Tracer} instance.
         #
-        # @param [String] name Instrumentation package name
-        # @param [String] version Instrumentation package version
+        # @param [String] name Instrumentation scope name
+        # @param [String] version Instrumentation scope version
         # @param [TracerProvider] tracer_provider TracerProvider that initialized the tracer
+        # @param [Hash{String => String, Numeric, Boolean, Array<String, Numeric, Boolean>}] attributes
+        #   Instrumentation scope attributes
         #
         # @return [Tracer]
-        def initialize(name, version, tracer_provider)
-          @instrumentation_scope = InstrumentationScope.new(name, version)
+        def initialize(name, version, tracer_provider, attributes: nil)
+          @instrumentation_scope = InstrumentationScope.new(name, version, attributes || {}.freeze)
           @tracer_provider = tracer_provider
         end
 

data/lib/opentelemetry/sdk/trace/tracer_provider.rb

@@ -9,8 +9,10 @@ module OpenTelemetry
     module Trace
       # {TracerProvider} is the SDK implementation of {OpenTelemetry::Trace::TracerProvider}.
       class TracerProvider < OpenTelemetry::Trace::TracerProvider # rubocop:disable Metrics/ClassLength
-        Key = Struct.new(:name, :version)
-        private_constant(:Key)
+        Key = Struct.new(:name, :version, :attributes)
+        EMPTY_ATTRIBUTES = {}.freeze
+
+        private_constant(:Key, :EMPTY_ATTRIBUTES)
 
         attr_accessor :span_limits, :id_generator, :sampler
         attr_reader :resource
@@ -44,15 +46,28 @@ module OpenTelemetry
 
         # 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)
-          name ||= ''
-          version ||= ''
+        def tracer(deprecated_name = nil, deprecated_version = nil, name: nil, version: nil, attributes: nil) # rubocop:disable Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+          name ||= deprecated_name || ''
+          version ||= deprecated_version || ''
+          attributes = attributes&.dup&.freeze || EMPTY_ATTRIBUTES
           OpenTelemetry.logger.warn 'calling TracerProvider#tracer without providing a tracer name.' if name.empty?
-          @registry_mutex.synchronize { @registry[Key.new(name, version)] ||= Tracer.new(name, version, self) }
+          @registry_mutex.synchronize do
+            @registry[Key.new(name, version, attributes)] ||=
+              Tracer.new(name, version, self, attributes: attributes)
+          end
         end
 
         # Attempts to stop all the activity for this {TracerProvider}. Calls
@@ -170,7 +185,7 @@ module OpenTelemetry
         private
 
         def sampler_from_environment(default_sampler)
-          case ENV['OTEL_TRACES_SAMPLER']
+          case ENV.fetch('OTEL_TRACES_SAMPLER', nil)
           when 'always_on' then Samplers::ALWAYS_ON
           when 'always_off' then Samplers::ALWAYS_OFF
           when 'traceidratio' then Samplers.trace_id_ratio_based(Float(ENV.fetch('OTEL_TRACES_SAMPLER_ARG', 1.0)))

data/lib/opentelemetry/sdk/version.rb

@@ -7,6 +7,6 @@
 module OpenTelemetry
   module SDK
     ## Current OpenTelemetry version
-    VERSION = '1.12.0'
+    VERSION = '1.13.0'
   end
 end

data/lib/opentelemetry/sdk.rb

@@ -23,7 +23,7 @@ module OpenTelemetry
     # ConfigurationError is an exception type used to wrap configuration errors
     # passed to OpenTelemetry.error_handler. This can be used to distinguish
     # errors reported during SDK configuration.
-    ConfigurationError = Class.new(OpenTelemetry::Error)
+    ConfigurationError = Class.new(OpenTelemetry::Error) # rubocop:disable Style/EmptyClassDefinition
 
     # Configures SDK and instrumentation
     #

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: opentelemetry-sdk
 version: !ruby/object:Gem::Version
-  version: 1.12.0
+  version: 1.13.0
 platform: ruby
 authors:
 - OpenTelemetry Authors
@@ -79,160 +79,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !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-exporter-zipkin
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.19'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.19'
-- !ruby/object:Gem::Dependency
-  name: opentelemetry-instrumentation-base
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.20'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.20'
-- !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: pry
-  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
-- !ruby/object:Gem::Dependency
-  name: pry-byebug
-  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'
 description: A stats collection and distributed tracing framework
 email:
 - cncf-opentelemetry-contributors@lists.cncf.io
@@ -279,10 +125,10 @@ homepage: https://github.com/open-telemetry/opentelemetry-ruby
 licenses:
 - Apache-2.0
 metadata:
-  changelog_uri: https://open-telemetry.github.io/opentelemetry-ruby/opentelemetry-sdk/v1.12.0/file.CHANGELOG.html
-  source_code_uri: https://github.com/open-telemetry/opentelemetry-ruby/tree/opentelemetry-sdk/v1.12.0/sdk'
+  changelog_uri: https://rubydoc.info/gems/opentelemetry-sdk/1.13.0/file/CHANGELOG.md
+  source_code_uri: https://github.com/open-telemetry/opentelemetry-ruby/tree/opentelemetry-sdk/v1.13.0/sdk
   bug_tracker_uri: https://github.com/open-telemetry/opentelemetry-ruby/issues
-  documentation_uri: https://open-telemetry.github.io/opentelemetry-ruby/opentelemetry-sdk/v1.12.0
+  documentation_uri: https://rubydoc.info/gems/opentelemetry-sdk/1.13.0
 rdoc_options: []
 require_paths:
 - lib
@@ -297,7 +143,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: []