opentelemetry-metrics-sdk 0.8.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 85882c7aaf7937f0442c130f4d350cf4b94a47e69b90022010ad09a66d5b4e50
-  data.tar.gz: 04a4e258be416b2a66bbd27a1caa64bfce75cd411a1fad90ecbc757dc3a86c06
+  metadata.gz: d6d7be59eeec2cd9ac11018c7d83dae815350d80c428dcb1ce3078b2435c6fc6
+  data.tar.gz: 3f23f0765a8b193ab67beea38c5c52804ab966b5e3d7c0436b4a0960ee9ebbb9
 SHA512:
-  metadata.gz: acd461eca177defb59f52887c77a1e2e4f65b1318da5de8f30c64e2afd7e7358d1316df4c86232e1d8178dc7f88548648e7cc9f25c2d52adadc869edc8f9feb6
-  data.tar.gz: a31db4511b453827cc0059884a0fd59b5767ed78db562e3d3b5e048960c0283164658a5054a9f398ef48cac9e245dfd9697da55d1d9155b8de60847f5e798f20
+  metadata.gz: 0dac2992b3eca5e5f42a1f503b600155995657e089be8d3bf49918a36b452a049dc8e7fe068e5f18ae9b9b989162d1128fbc28ca5ed96f4b7f183f93026543b4
+  data.tar.gz: 5707defc93ad7cbe2c0f56fabb9d992fe2620b0a2766df43da153ec5cf3b5f46b10089fc7805d02a341314fef134201489f93d52ed2bc223d8beb868c589a6a1

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release History: opentelemetry-metrics-sdk
 
+### v0.9.0 / 2025-08-19
+
+* ADDED: Add `LOWMEMORY` option to `OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE`
+
 ### v0.8.0 / 2025-08-14
 
 - BREAKING CHANGE: Update default aggregation temporality for counter, histogram, and up down counter to cumulative

data/lib/opentelemetry/sdk/metrics/aggregation/aggregation_temporality.rb

@@ -28,6 +28,31 @@ module OpenTelemetry
             def cumulative
               new(CUMULATIVE)
             end
+
+            # | Preference Value | Counter    | Async Counter    | Histogram  | UpDownCounter | Async UpDownCounter |
+            # |------------------|------------|------------------|----------- |---------------|-------------------- |
+            # | **Cumulative**   | Cumulative | Cumulative       | Cumulative | Cumulative    | Cumulative          |
+            # | **Delta**        | Delta      | Delta            | Delta      | Cumulative    | Cumulative          |
+            # | **LowMemory**    | Delta      | Cumulative       | Delta      | Cumulative    | Cumulative          |
+            def determine_temporality(aggregation_temporality: nil, instrument_kind: nil, default: nil)
+              # aggregation_temporality can't be nil because it always has default value in symbol
+              if aggregation_temporality.is_a?(::Symbol)
+                aggregation_temporality == :delta ? delta : cumulative
+
+              elsif aggregation_temporality.is_a?(::String)
+                case aggregation_temporality
+                when 'LOWMEMORY', 'lowmemory', 'low_memory'
+                  instrument_kind == :observable_counter ? cumulative : delta
+                when 'DELTA', 'delta'
+                  delta
+                when 'CUMULATIVE', 'cumulative'
+                  cumulative
+                else
+                  default == :delta ? delta : cumulative
+                end
+
+              end
+            end
           end
 
           attr_reader :temporality

data/lib/opentelemetry/sdk/metrics/aggregation/drop.rb

@@ -10,10 +10,6 @@ module OpenTelemetry
       module Aggregation
         # Contains the implementation of the Drop aggregation
         class Drop
-          def initialize
-            @aggregation_temporality = nil
-          end
-
           def collect(start_time, end_time, data_points)
             data_points.values.map!(&:dup)
           end
@@ -28,10 +24,6 @@ module OpenTelemetry
             )
             nil
           end
-
-          def aggregation_temporality
-            nil
-          end
         end
       end
     end

data/lib/opentelemetry/sdk/metrics/aggregation/explicit_bucket_histogram.rb

@@ -23,7 +23,7 @@ module OpenTelemetry
             boundaries: DEFAULT_BOUNDARIES,
             record_min_max: true
           )
-            @aggregation_temporality = aggregation_temporality.to_sym == :delta ? AggregationTemporality.delta : AggregationTemporality.cumulative
+            @aggregation_temporality = AggregationTemporality.determine_temporality(aggregation_temporality: aggregation_temporality, default: :cumulative)
             @boundaries = boundaries && !boundaries.empty? ? boundaries.sort : nil
             @record_min_max = record_min_max
           end

data/lib/opentelemetry/sdk/metrics/aggregation/exponential_bucket_histogram.rb

@@ -16,8 +16,6 @@ module OpenTelemetry
       module Aggregation
         # Contains the implementation of the {https://opentelemetry.io/docs/specs/otel/metrics/data-model/#exponentialhistogram ExponentialBucketHistogram} aggregation
         class ExponentialBucketHistogram # rubocop:disable Metrics/ClassLength
-          attr_reader :aggregation_temporality
-
           # relate to min max scale: https://opentelemetry.io/docs/specs/otel/metrics/sdk/#support-a-minimum-and-maximum-scale
           DEFAULT_SIZE  = 160
           DEFAULT_SCALE = 20
@@ -34,7 +32,7 @@ module OpenTelemetry
             record_min_max: true,
             zero_threshold: 0
           )
-            @aggregation_temporality = aggregation_temporality.to_sym
+            @aggregation_temporality = AggregationTemporality.determine_temporality(aggregation_temporality: aggregation_temporality, default: :delta)
             @record_min_max = record_min_max
             @min            = Float::INFINITY
             @max            = -Float::INFINITY
@@ -49,7 +47,7 @@ module OpenTelemetry
           end
 
           def collect(start_time, end_time, data_points)
-            if @aggregation_temporality == :delta
+            if @aggregation_temporality.delta?
               # Set timestamps and 'move' data point values to result.
               hdps = data_points.values.map! do |hdp|
                 hdp.start_time_unix_nano = start_time
@@ -168,6 +166,10 @@ module OpenTelemetry
           end
           # rubocop:enable Metrics/MethodLength
 
+          def aggregation_temporality
+            @aggregation_temporality.temporality
+          end
+
           private
 
           def grow_buckets(span, buckets)

data/lib/opentelemetry/sdk/metrics/aggregation/last_value.rb

@@ -10,28 +10,14 @@ module OpenTelemetry
       module Aggregation
         # Contains the implementation of the LastValue aggregation
         class LastValue
-          def initialize(aggregation_temporality: :delta)
-            @aggregation_temporality = aggregation_temporality == :cumulative ? AggregationTemporality.cumulative : AggregationTemporality.delta
-          end
-
           def collect(start_time, end_time, data_points)
-            if @aggregation_temporality.delta?
-              # Set timestamps and 'move' data point values to result.
-              ndps = data_points.values.map! do |ndp|
-                ndp.start_time_unix_nano = start_time
-                ndp.time_unix_nano = end_time
-                ndp
-              end
-              data_points.clear
-              ndps
-            else
-              # Update timestamps and take a snapshot.
-              data_points.values.map! do |ndp|
-                ndp.start_time_unix_nano ||= start_time # Start time of a data point is from the first observation.
-                ndp.time_unix_nano = end_time
-                ndp.dup
-              end
+            ndps = data_points.values.map! do |ndp|
+              ndp.start_time_unix_nano = start_time
+              ndp.time_unix_nano = end_time
+              ndp
             end
+            data_points.clear
+            ndps
           end
 
           def update(increment, attributes, data_points)
@@ -44,10 +30,6 @@ module OpenTelemetry
             )
             nil
           end
-
-          def aggregation_temporality
-            @aggregation_temporality.temporality
-          end
         end
       end
     end

data/lib/opentelemetry/sdk/metrics/aggregation/sum.rb

@@ -11,8 +11,8 @@ module OpenTelemetry
         # Contains the implementation of the Sum aggregation
         # https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/metrics/sdk.md#sum-aggregation
         class Sum
-          def initialize(aggregation_temporality: ENV.fetch('OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE', :cumulative), monotonic: false)
-            @aggregation_temporality = aggregation_temporality.to_sym == :delta ? AggregationTemporality.delta : AggregationTemporality.cumulative
+          def initialize(aggregation_temporality: ENV.fetch('OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE', :cumulative), monotonic: false, instrument_kind: nil)
+            @aggregation_temporality = AggregationTemporality.determine_temporality(aggregation_temporality: aggregation_temporality, instrument_kind: instrument_kind, default: :cumulative)
             @monotonic = monotonic
           end
 

data/lib/opentelemetry/sdk/metrics/instrument/observable_counter.rb

@@ -32,7 +32,7 @@ module OpenTelemetry
           private
 
           def default_aggregation
-            OpenTelemetry::SDK::Metrics::Aggregation::Sum.new(monotonic: true)
+            OpenTelemetry::SDK::Metrics::Aggregation::Sum.new(monotonic: true, instrument_kind: instrument_kind)
           end
         end
       end

data/lib/opentelemetry/sdk/metrics/instrument/observable_up_down_counter.rb

@@ -32,7 +32,7 @@ module OpenTelemetry
           private
 
           def default_aggregation
-            OpenTelemetry::SDK::Metrics::Aggregation::Sum.new(aggregation_temporality: :delta, monotonic: false)
+            OpenTelemetry::SDK::Metrics::Aggregation::Sum.new(aggregation_temporality: :cumulative, monotonic: false)
           end
         end
       end

data/lib/opentelemetry/sdk/metrics/instrument/up_down_counter.rb

@@ -35,7 +35,7 @@ module OpenTelemetry
           private
 
           def default_aggregation
-            OpenTelemetry::SDK::Metrics::Aggregation::Sum.new(monotonic: false)
+            OpenTelemetry::SDK::Metrics::Aggregation::Sum.new(aggregation_temporality: :cumulative, monotonic: false)
           end
         end
       end

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

@@ -72,6 +72,7 @@ module OpenTelemetry
           def aggregate_metric_data(start_time, end_time, aggregation: nil)
             aggregator = aggregation || @default_aggregation
             is_monotonic = aggregator.respond_to?(:monotonic?) ? aggregator.monotonic? : nil
+            aggregation_temporality = aggregator.respond_to?(:aggregation_temporality) ? aggregator.aggregation_temporality : nil
 
             MetricData.new(
               @name,
@@ -81,7 +82,7 @@ module OpenTelemetry
               @meter_provider.resource,
               @instrumentation_scope,
               aggregator.collect(start_time, end_time, @data_points),
-              aggregator.aggregation_temporality,
+              aggregation_temporality,
               start_time,
               end_time,
               is_monotonic

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

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: opentelemetry-metrics-sdk
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.9.0
 platform: ruby
 authors:
 - OpenTelemetry Authors
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-08-14 00:00:00.000000000 Z
+date: 2025-08-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: opentelemetry-api
@@ -251,10 +251,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.8.0/file.CHANGELOG.html
+  changelog_uri: https://open-telemetry.github.io/opentelemetry-ruby/opentelemetry-metrics-sdk/v0.9.0/file.CHANGELOG.html
   source_code_uri: https://github.com/open-telemetry/opentelemetry-ruby/tree/main/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.8.0
+  documentation_uri: https://open-telemetry.github.io/opentelemetry-ruby/opentelemetry-metrics-sdk/v0.9.0
 post_install_message:
 rdoc_options: []
 require_paths: