opentelemetry-metrics-sdk 0.4.1 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 65d8c5195153d2f5a5935ada32ad8045eec7d2aa867876fe98dedf48ccc42a6a
-  data.tar.gz: 2108b549a5eab96b9185eb45293074db155bd64554623c6d49921cb11ed0bea5
+  metadata.gz: a74df1307dfb40dbdaf08d87781c35d2736916d94ae06eef45b3237b3ba38631
+  data.tar.gz: 3a108b46150f768890f6cef2acd49557d83331cc4a84613b8c7de38861cfebdb
 SHA512:
-  metadata.gz: cc5a6f9d822abc4ddb9e77d558ed21391fa68823248db02452436a53d4e82294c7f7dba04887c782d7f9e01e12514db70cde8b2bd73ef85ddc6b6753fa8bca52
-  data.tar.gz: 17ac61e347fca948a49637d9699899ed16217a7bb06854f7451fbfc303fa8c553b43134c02a489cad06d0a4229694ecb8618080250c916297ec98ab5a7e2db2d
+  metadata.gz: 2b168a69a35cee4b798cf9195b0af540d79b2b9cbb687dd98abe295a517e38683fce1976a7028ab822f8e5aec3157b53043ed9ddbb436cf5a2f25101ddc50b61
+  data.tar.gz: a06ace144467243b00a4d19bec891d66d55f3da2c611d4569e393b805d31979ab47eed39dbb86d4b9d508519b69ce2f827acb3281c446d83fe8201a6e84150fe

data/CHANGELOG.md

@@ -1,22 +1,31 @@
 # Release History: opentelemetry-metrics-sdk
 
+### v0.6.0 / 2025-02-25
+
+- ADDED: Support 3.1 Min Version
+- FIXED: Add is_monotonic flag to sum
+
+### v0.5.0 / 2025-01-08
+
+- ADDED: Add synchronous gauge
+
 ### v0.4.1 / 2024-12-04
 
-* FIXED: Handle float value in NumberDataPoint
+- FIXED: Handle float value in NumberDataPoint
 
 ### v0.4.0 / 2024-11-20
 
-* ADDED: Update metrics configuration patch
+- ADDED: Update metrics configuration patch
 
 ### v0.3.0 / 2024-10-22
 
-* ADDED: Add basic metrics view
-* FIXED: Coerce aggregation_temporality to symbol
-* FIXED: Add warning if invalid meter name given
+- ADDED: Add basic metrics view
+- FIXED: Coerce aggregation_temporality to symbol
+- FIXED: Add warning if invalid meter name given
 
 ### v0.2.0 / 2024-08-27
 
-* ADDED: Add basic periodic exporting metric_reader
+- ADDED: Add basic periodic exporting metric_reader
 
 ### v0.1.0 / 2024-07-31
 

data/README.md

@@ -25,6 +25,7 @@ At this time, you should be able to:
   * observable up down counters
 * Export using a pull exporter
 * Use delta aggregation temporality
+* Periodic Exporting Metric Reader
 
 We do not yet have support for:
 
@@ -32,7 +33,6 @@ We do not yet have support for:
 * Cumulative aggregation temporality
 * Metrics Views
 * Metrics Exemplars
-* Periodic Exporting Metric Reader
 * Push metric exporting
 
 These lists are incomplete and are intended to give a broad description of what's available.

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

@@ -13,9 +13,10 @@ module OpenTelemetry
         class Sum
           attr_reader :aggregation_temporality
 
-          def initialize(aggregation_temporality: ENV.fetch('OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE', :delta))
+          def initialize(aggregation_temporality: ENV.fetch('OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE', :delta), monotonic: false)
             # TODO: the default should be :cumulative, see issue #1555
             @aggregation_temporality = aggregation_temporality.to_sym
+            @monotonic = monotonic
           end
 
           def collect(start_time, end_time, data_points)
@@ -38,7 +39,13 @@ module OpenTelemetry
             end
           end
 
+          def monotonic?
+            @monotonic
+          end
+
           def update(increment, attributes, data_points)
+            return if @monotonic && increment < 0
+
             ndp = data_points[attributes] || data_points[attributes] = NumberDataPoint.new(
               attributes,
               nil,

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

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

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

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+# Copyright The OpenTelemetry Authors
+#
+# SPDX-License-Identifier: Apache-2.0
+
+module OpenTelemetry
+  module SDK
+    module Metrics
+      module Instrument
+        # {Gauge} is the SDK implementation of {OpenTelemetry::Metrics::Gauge}.
+        class Gauge < OpenTelemetry::SDK::Metrics::Instrument::SynchronousInstrument
+          # Returns the instrument kind as a Symbol
+          #
+          # @return [Symbol]
+          def instrument_kind
+            :gauge
+          end
+
+          # Record the absolute value of the Gauge.
+          #
+          # @param [numeric] value The current absolute value.
+          # @param [Hash{String => String, Numeric, Boolean, Array<String, Numeric, Boolean>}] attributes
+          #   Values must be non-nil and (array of) string, boolean or numeric type.
+          #   Array values must not contain nil elements and all elements must be of
+          #   the same basic type (string, numeric, boolean).
+          def record(value, attributes: {})
+            # TODO: When the metrics SDK stabilizes and is merged into the main SDK,
+            # we can leverage the SDK Internal validation classes to enforce this:
+            # https://github.com/open-telemetry/opentelemetry-ruby/blob/6bec625ef49004f364457c26263df421526b60d6/sdk/lib/opentelemetry/sdk/internal.rb#L47
+            update(value, attributes)
+            nil
+          rescue StandardError => e
+            OpenTelemetry.handle_error(exception: e)
+            nil
+          end
+
+          private
+
+          def default_aggregation
+            OpenTelemetry::SDK::Metrics::Aggregation::LastValue.new
+          end
+        end
+      end
+    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
+            OpenTelemetry::SDK::Metrics::Aggregation::Sum.new(monotonic: false)
           end
         end
       end

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

@@ -20,3 +20,4 @@ require 'opentelemetry/sdk/metrics/instrument/observable_counter'
 require 'opentelemetry/sdk/metrics/instrument/observable_gauge'
 require 'opentelemetry/sdk/metrics/instrument/observable_up_down_counter'
 require 'opentelemetry/sdk/metrics/instrument/up_down_counter'
+require 'opentelemetry/sdk/metrics/instrument/gauge'

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

@@ -46,6 +46,7 @@ module OpenTelemetry
             case kind
             when :counter then OpenTelemetry::SDK::Metrics::Instrument::Counter.new(name, unit, description, @instrumentation_scope, @meter_provider)
             when :observable_counter then OpenTelemetry::SDK::Metrics::Instrument::ObservableCounter.new(name, unit, description, callback, @instrumentation_scope, @meter_provider)
+            when :gauge then OpenTelemetry::SDK::Metrics::Instrument::Gauge.new(name, unit, description, @instrumentation_scope, @meter_provider)
             when :histogram then OpenTelemetry::SDK::Metrics::Instrument::Histogram.new(name, unit, description, @instrumentation_scope, @meter_provider)
             when :observable_gauge then OpenTelemetry::SDK::Metrics::Instrument::ObservableGauge.new(name, unit, description, callback, @instrumentation_scope, @meter_provider)
             when :up_down_counter then OpenTelemetry::SDK::Metrics::Instrument::UpDownCounter.new(name, unit, description, @instrumentation_scope, @meter_provider)

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

@@ -18,7 +18,8 @@ module OpenTelemetry
                                 :data_points,               # Hash{Hash{String => String, Numeric, Boolean, Array<String, Numeric, Boolean>} => Numeric}
                                 :aggregation_temporality,   # Symbol
                                 :start_time_unix_nano,      # Integer nanoseconds since Epoch
-                                :time_unix_nano)            # Integer nanoseconds since Epoch
+                                :time_unix_nano,            # Integer nanoseconds since Epoch
+                                :is_monotonic)              # Boolean
       end
     end
   end

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

@@ -67,6 +67,8 @@ 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
+
             MetricData.new(
               @name,
               @description,
@@ -77,7 +79,8 @@ module OpenTelemetry
               aggregator.collect(start_time, end_time, @data_points),
               aggregator.aggregation_temporality,
               start_time,
-              end_time
+              end_time,
+              is_monotonic
             )
           end
 

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

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: opentelemetry-metrics-sdk
 version: !ruby/object:Gem::Version
-  version: 0.4.1
+  version: 0.6.0
 platform: ruby
 authors:
 - OpenTelemetry Authors
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-12-05 00:00:00.000000000 Z
+date: 2025-02-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: opentelemetry-api
@@ -30,14 +30,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.1
+        version: '0.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.1
+        version: '0.2'
 - !ruby/object:Gem::Dependency
   name: opentelemetry-sdk
   requirement: !ruby/object:Gem::Requirement
@@ -220,6 +220,7 @@ files:
 - lib/opentelemetry/sdk/metrics/export/periodic_metric_reader.rb
 - lib/opentelemetry/sdk/metrics/instrument.rb
 - lib/opentelemetry/sdk/metrics/instrument/counter.rb
+- lib/opentelemetry/sdk/metrics/instrument/gauge.rb
 - lib/opentelemetry/sdk/metrics/instrument/histogram.rb
 - lib/opentelemetry/sdk/metrics/instrument/observable_counter.rb
 - lib/opentelemetry/sdk/metrics/instrument/observable_gauge.rb
@@ -239,11 +240,11 @@ 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.4.1/file.CHANGELOG.html
+  changelog_uri: https://open-telemetry.github.io/opentelemetry-ruby/opentelemetry-metrics-sdk/v0.6.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.4.1
-post_install_message: 
+  documentation_uri: https://open-telemetry.github.io/opentelemetry-ruby/opentelemetry-metrics-sdk/v0.6.0
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -251,15 +252,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.0'
+      version: '3.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.33
-signing_key: 
+rubygems_version: 3.3.27
+signing_key:
 specification_version: 4
 summary: A stats collection and distributed tracing framework
 test_files: []