opentelemetry-sdk 1.13.0 → 1.13.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d263c7e1224cad3b9e7a9ac1fc958dae76c9bc9788df4dde53b56d5603cfd22e
-  data.tar.gz: e2a8d6e023dfbc277b37bd0df76a4903adab343e3b3be2173a6943806141904d
+  metadata.gz: 96d1d6f8f41f39408208c7fa58c1ba8617bb9249106bf8391eeb266c2d38362e
+  data.tar.gz: 03b8f1119d65b37cbe3098407b46d0753adbbe52e634a328bfbd5565ab341a22
 SHA512:
-  metadata.gz: '088ced3e6d379e35df9790f999287ecca88c2f79ac7b4c8bdf162c89e8e19bca49bebd1d084ff4dfe872e2d70aaad1b0c8dd1c11e0e1686fd297b05d42f3435f'
-  data.tar.gz: 7b1c670d348ba097b8721c3b30843ceb693d62985e8e798d9589e87792d85388c7d32cd2c618c90317f53a780f2199a6916b07fc817456fec3c0c431f90e442e
+  metadata.gz: b2feacbff16ce07fcbbbda0e040d08c1eb8db2fec25804d8d9a849ed4597c2e4f7f64c5c3700cad5d6fbdfcd30ca3f397e5d3341d5e318b2f6c9a74aef8dd94a
+  data.tar.gz: 007725376c74f995289bc476a34905fb0a37334ebb86b370ad5631621a8558ae25dde2e8e693b3d04bf64b45c8cce170215fb55b4381b8f56f698ff7b511867f

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release History: opentelemetry-sdk
 
+### v1.13.1 / 2026-09-15
+
+* DOCS: Document custom error handlers (#2264)
+
 ### v1.13.0 / 2026-07-21
 
 * ADDED: Add attributes support to instrumentation scope for tracers (#2094)

data/README.md

@@ -97,5 +97,5 @@ The `opentelemetry-sdk` gem is distributed under the Apache 2.0 license. See [LI
 [license-github]: https://github.com/open-telemetry/opentelemetry-ruby/blob/main/LICENSE
 [examples-github]: https://github.com/open-telemetry/opentelemetry-ruby/tree/main/examples
 [ruby-sig]: https://github.com/open-telemetry/community#ruby-sig
-[community-meetings]: https://github.com/open-telemetry/community#community-meetings
+[community-meetings]: https://github.com/open-telemetry/community/blob/main/README.md#calendar
 [discussions-url]: https://github.com/open-telemetry/opentelemetry-ruby/discussions

data/lib/opentelemetry/sdk/configurator.rb

@@ -14,12 +14,15 @@ module OpenTelemetry
         EMPTY_LIST = [].freeze
         private_constant(:EMPTY_LIST)
 
+        # No-op because this propagator does not inject any values.
         def inject(carrier, context: Context.current, setter: Context::Propagation.text_map_setter); end
 
+        # Returns the passed context unchanged because there is nothing to extract.
         def extract(carrier, context: Context.current, getter: Context::Propagation.text_map_getter)
           context
         end
 
+        # Returns an empty list because this propagator does not use carrier fields.
         def fields
           EMPTY_LIST
         end
@@ -31,7 +34,7 @@ module OpenTelemetry
 
       private_constant :USE_MODE_UNSPECIFIED, :USE_MODE_ONE, :USE_MODE_ALL
 
-      attr_writer :propagators, :error_handler, :id_generator
+      attr_writer :propagators, :id_generator
 
       def initialize
         @instrumentation_names = []
@@ -43,6 +46,7 @@ module OpenTelemetry
         @id_generator = OpenTelemetry::Trace
       end
 
+      # Returns the configured logger or the global OpenTelemetry logger.
       def logger
         @logger ||= OpenTelemetry.logger
       end
@@ -56,6 +60,26 @@ module OpenTelemetry
         @logger = ForwardingLogger.new(new_logger, level: ENV['OTEL_LOG_LEVEL'] || Logger::INFO)
       end
 
+      # Configures the error handler that will be installed on
+      # OpenTelemetry during SDK configuration.
+      #
+      # Assigned object must respond to +#call+ and accept the keyword
+      # arguments +exception:+ and +message:+.
+      #
+      # @param [#call] error_handler The error handler to install
+      #
+      # @example Configure a custom error handler during SDK setup
+      #   OpenTelemetry::SDK.configure do |c|
+      #     c.error_handler = lambda do |exception: nil, message: nil|
+      #       OpenTelemetry.logger.warn("otel: #{[message, exception&.message].compact.join(' - ')}")
+      #     end
+      #   end
+      # rubocop:disable-next Style/TrivialAccessors
+      def error_handler=(error_handler)
+        @error_handler = error_handler
+      end
+
+      # Returns the configured error handler or the global OpenTelemetry error handler.
       def error_handler
         @error_handler ||= OpenTelemetry.error_handler
       end

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

@@ -13,9 +13,9 @@ module OpenTelemetry
         class << self
           private :new
 
-          # Returns a newly created {Resource} with the specified attributes
+          # Returns a newly created Resource with the specified attributes
           #
-          # @param [Hash{String => String, Numeric, Boolean} attributes Hash of key-value pairs to be used
+          # @param [Hash{String => String, Numeric, Boolean}] attributes Hash of key-value pairs to be used
           #   as attributes for this resource
           # @raise [ArgumentError] If attribute keys and values are not strings
           # @return [Resource]
@@ -30,10 +30,16 @@ module OpenTelemetry
             new(frozen_attributes)
           end
 
+          # Returns the default Resource for the current process and SDK.
+          #
+          # @return [Resource]
           def default
             @default ||= create(SemanticConventions::Resource::SERVICE_NAME => 'unknown_service').merge(process).merge(telemetry_sdk).merge(service_name_from_env)
           end
 
+          # Returns a Resource describing this telemetry SDK.
+          #
+          # @return [Resource]
           def telemetry_sdk
             resource_attributes = {
               SemanticConventions::Resource::TELEMETRY_SDK_NAME => 'opentelemetry',
@@ -53,6 +59,9 @@ module OpenTelemetry
             create(resource_attributes)
           end
 
+          # Returns a Resource describing the current process.
+          #
+          # @return [Resource]
           def process
             resource_attributes = {
               SemanticConventions::Resource::PROCESS_PID => Process.pid,
@@ -75,7 +84,7 @@ module OpenTelemetry
 
         # @api private
         # The constructor is private and only for use internally by the class.
-        # Users should use the {create} factory method to obtain a {Resource}
+        # Users should use the {create} factory method to obtain a Resource
         # instance.
         #
         # @param [Hash<String, String>] frozen_attributes Frozen-hash of frozen-string
@@ -85,15 +94,15 @@ module OpenTelemetry
           @attributes = frozen_attributes
         end
 
-        # Returns an enumerator for attributes of this {Resource}
+        # Returns an enumerator for attributes of this Resource
         #
         # @return [Enumerator]
         def attribute_enumerator
           @attribute_enumerator ||= attributes.to_enum
         end
 
-        # Returns a new, merged {Resource} by merging the current {Resource} with
-        # the other {Resource}. In case of a collision, the other {Resource}
+        # Returns a new, merged Resource by merging the current Resource with
+        # the other Resource. In case of a collision, the other Resource
         # takes precedence
         #
         # @param [Resource] other The other resource to merge

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

@@ -210,11 +210,10 @@ module OpenTelemetry
           end
 
           def lock
-            # rubocop:disable Style/ExplicitBlockArgument
+            # rubocop:disable-next 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

@@ -39,9 +39,8 @@ module OpenTelemetry
           private
 
           def sample?(trace_id)
-            # rubocop:disable Lint/FloatComparison
+            # rubocop:disable-next 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

@@ -14,7 +14,7 @@ module OpenTelemetry
       # Instrumentation should use the API provided by {OpenTelemetry::Trace::Span}
       # and should consider {Span} to be write-only.
       #
-      # rubocop:disable Metrics/ClassLength
+      # rubocop:disable-next Metrics/ClassLength
       class Span < OpenTelemetry::Trace::Span
         DEFAULT_STATUS = OpenTelemetry::Trace::Status.unset
         EMPTY_ATTRIBUTES = {}.freeze
@@ -133,7 +133,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)
@@ -475,7 +475,6 @@ module OpenTelemetry
           Process.clock_gettime(Process::CLOCK_MONOTONIC, :nanosecond)
         end
       end
-      # rubocop:enable Metrics/ClassLength
     end
   end
 end

data/lib/opentelemetry/sdk/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: opentelemetry-sdk
 version: !ruby/object:Gem::Version
-  version: 1.13.0
+  version: 1.13.1
 platform: ruby
 authors:
 - OpenTelemetry Authors
@@ -125,10 +125,10 @@ homepage: https://github.com/open-telemetry/opentelemetry-ruby
 licenses:
 - Apache-2.0
 metadata:
-  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
+  changelog_uri: https://rubydoc.info/gems/opentelemetry-sdk/1.13.1/file/CHANGELOG.md
+  source_code_uri: https://github.com/open-telemetry/opentelemetry-ruby/tree/opentelemetry-sdk/v1.13.1/sdk
   bug_tracker_uri: https://github.com/open-telemetry/opentelemetry-ruby/issues
-  documentation_uri: https://rubydoc.info/gems/opentelemetry-sdk/1.13.0
+  documentation_uri: https://rubydoc.info/gems/opentelemetry-sdk/1.13.1
 rdoc_options: []
 require_paths:
 - lib