opentelemetry-metrics-sdk 0.13.1 → 0.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7334096b386c7cfbef752c28e4f0e21f10dad2fd6c7d200a6b2ac005199c1aa4
-  data.tar.gz: a885b64ee8021d1c53fcd647c114ae919197d4596aec37c72743f75b20e4e255
+  metadata.gz: 35222d1da9eadba8252b7110b20a504a5e5b339c7ecc50403b3d6056f6b2c282
+  data.tar.gz: 23732ae05bea5b79aa6678f636e429d5958a35b96cf7dbd54846212db33d6727
 SHA512:
-  metadata.gz: 1ec27c0c72f390a2d48c533ba021d714987f5183983e2aa968f0f03e8b07dadc2b63dce78c3b9379d9abfd22737f859745c9c3ce17d38520dfaee1a4dd652d89
-  data.tar.gz: 0c706c3757af11cd8cc65bdc07aea5498f88aabcf1d683f9178502f440cd5dc46a3b86e29a80ca0e21429ad5f4ae5d5412dce3f453b803b9733b51091ea19c4c
+  metadata.gz: 81abb739ad7ee5191f98d3577a2a7f65323dbb567ba137def5a0f35cf3937caf61f442e6ef3b8320d5cc2c0e6083c02a1f32e58d955d09461df1742f5df0e967
+  data.tar.gz: 83031636bdddd8317ca29fc8cf21f7bd17ca2f37cc06e16faba61b82d5286ea8e1c218de32461beb647ce8fd6a49928a0f73f26f26e0e219f19276214a744a5b

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Release History: opentelemetry-metrics-sdk
 
+### v0.14.0 / 2026-05-12
+
+* BREAKING CHANGE: Use trace_based exemplar filter by default (#2112)
+* ADDED: Use trace_based exemplar filter by default (#2112)
+* ADDED: Add git tag to source URI in gemspec (#2101)
+* FIXED: Return false if it is noop_exemplar_reservoir (#2104)
+
 ### v0.13.1 / 2026-04-15
 
 * FIXED: Move the metrics-sdk requires to support "require 'opentelemetry/sdk/metrics'" (#1956)

data/README.md

@@ -39,8 +39,8 @@ At this time, you should be able to:
 * Export metrics on a schedule using `PeriodicMetricReader` with any compatible push exporter (e.g. OTLP via `opentelemetry-exporter-otlp-metrics`)
 * Attach exemplars to metric data points for trace correlation:
   * `AlwaysOnExemplarFilter` — every measurement is eligible
-  * `AlwaysOffExemplarFilter` — no exemplars collected (default)
-  * `TraceBasedExemplarFilter` — only measurements inside a sampled trace
+  * `AlwaysOffExemplarFilter` — no exemplars collected
+  * `TraceBasedExemplarFilter` — only measurements inside a sampled trace (default)
 
 We do not yet have support for:
 
@@ -278,7 +278,7 @@ OpenTelemetry.meter_provider.shutdown
 
 Exemplars attach individual raw measurements — along with the trace context active at the time of the measurement — to an exported metric data point. This lets you jump from a metric spike directly to the trace that caused it.
 
-By default exemplars are **disabled** (`AlwaysOffExemplarFilter`). Enable them via an environment variable or programmatically.
+By default, exemplars use `TraceBasedExemplarFilter`, which records measurements only when they occur inside a sampled trace.
 
 #### Enable via environment variable
 
@@ -289,7 +289,7 @@ export OTEL_METRICS_EXEMPLAR_FILTER=trace_based
 # Eligible for every measurement regardless of trace context
 export OTEL_METRICS_EXEMPLAR_FILTER=always_on
 
-# Disabled (default)
+# Disabled
 export OTEL_METRICS_EXEMPLAR_FILTER=always_off
 ```
 

data/lib/opentelemetry/sdk/metrics/exemplar/exemplar_reservoir.rb

@@ -32,6 +32,18 @@ module OpenTelemetry
           def collect(attributes: nil, aggregation_temporality: :delta)
             raise NotImplementedError, "#{self.class} must implement #collect"
           end
+
+          # Called after dup to reset internal state before reuse for a new attribute set.
+          # Subclasses that hold mutable per-attribute state must override this.
+          def reset; end
+
+          # Returns true if this reservoir never stores exemplars.
+          # Used to skip the exemplar filter and timestamp lookups entirely.
+          #
+          # @return [Boolean]
+          def noop?
+            false
+          end
         end
       end
     end

data/lib/opentelemetry/sdk/metrics/exemplar/noop_exemplar_reservoir.rb

@@ -15,6 +15,10 @@ module OpenTelemetry
           def collect(attributes: nil, aggregation_temporality: :delta)
             []
           end
+
+          def noop?
+            true
+          end
         end
       end
     end

data/lib/opentelemetry/sdk/metrics/meter_provider.rb

@@ -130,19 +130,17 @@ module OpenTelemetry
         end
         alias register_asynchronous_instrument register_synchronous_instrument
 
-        # spec: https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/configuration/sdk-environment-variables.md#exemplar
-        # this is one way to turn on the exemplar (exemplar should be turned off by default)
         def exemplar_filter_setup
           case ENV['OTEL_METRICS_EXEMPLAR_FILTER']
           when 'always_on'
             @exemplar_filter = Exemplar::AlwaysOnExemplarFilter
-          when 'trace_based'
+          when nil, '', 'trace_based'
             @exemplar_filter = Exemplar::TraceBasedExemplarFilter
           when 'always_off'
             @exemplar_filter = Exemplar::AlwaysOffExemplarFilter
           else
-            OpenTelemetry.logger.warn("OTEL_METRICS_EXEMPLAR_FILTER #{ENV['OTEL_METRICS_EXEMPLAR_FILTER']} is not part of the provided exemplar filters. Exemplar is off.")
-            @exemplar_filter = Exemplar::AlwaysOffExemplarFilter
+            OpenTelemetry.logger.warn("OTEL_METRICS_EXEMPLAR_FILTER #{ENV['OTEL_METRICS_EXEMPLAR_FILTER']} is not part of the provided exemplar filters. Using trace_based.")
+            @exemplar_filter = Exemplar::TraceBasedExemplarFilter
           end
         end
 

data/lib/opentelemetry/sdk/metrics/state/metric_stream.rb

@@ -120,6 +120,8 @@ module OpenTelemetry
           end
 
           def should_offer_exemplar?(value, attributes)
+            return false if @exemplar_reservoir&.noop?
+
             context = OpenTelemetry::Context.current
             time = OpenTelemetry::Common::Utilities.time_in_nanoseconds
             @exemplar_filter&.should_sample?(value, time, attributes, context)

data/lib/opentelemetry/sdk/metrics/version.rb

@@ -8,7 +8,7 @@ module OpenTelemetry
   module SDK
     module Metrics
       # Current OpenTelemetry metrics sdk version
-      VERSION = '0.13.1'
+      VERSION = '0.14.0'
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: opentelemetry-metrics-sdk
 version: !ruby/object:Gem::Version
-  version: 0.13.1
+  version: 0.14.0
 platform: ruby
 authors:
 - OpenTelemetry Authors
@@ -51,20 +51,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.2'
-- !ruby/object:Gem::Dependency
-  name: benchmark-ipsa
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.2.0
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.2.0
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -233,10 +219,10 @@ homepage: https://github.com/open-telemetry/opentelemetry-ruby
 licenses:
 - Apache-2.0
 metadata:
-  changelog_uri: https://open-telemetry.github.io/opentelemetry-ruby/opentelemetry-metrics-sdk/v0.13.1/file.CHANGELOG.html
-  source_code_uri: https://github.com/open-telemetry/opentelemetry-ruby/tree/main/metrics_sdk
+  changelog_uri: https://open-telemetry.github.io/opentelemetry-ruby/opentelemetry-metrics-sdk/v0.14.0/file.CHANGELOG.html
+  source_code_uri: https://github.com/open-telemetry/opentelemetry-ruby/tree/opentelemetry-metrics-sdk/v0.14.0/metrics_sdk
   bug_tracker_uri: https://github.com/open-telemetry/opentelemetry-ruby/issues
-  documentation_uri: https://open-telemetry.github.io/opentelemetry-ruby/opentelemetry-metrics-sdk/v0.13.1
+  documentation_uri: https://open-telemetry.github.io/opentelemetry-ruby/opentelemetry-metrics-sdk/v0.14.0
 rdoc_options: []
 require_paths:
 - lib