yggdrasil-engine 1.1.1-universal-java-17 → 1.2.0-universal-java-17

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1b8f57f1f079127e31324281d4e6b11eceee03c1fc6b9535e7fffefd2d2817f7
-  data.tar.gz: 19191e5f88df64758a99b315aee5cf089c284d2830ad8bf02b8307892d6e7690
+  metadata.gz: 743de4af671f1321c015f1c9c98b17d755d3addd017329f61840d80bc3e50ba5
+  data.tar.gz: 5fc1d28448949c4478d8e0d8cc9f34f1cf4ef8140e7a8fe7e74972a5dd32c84e
 SHA512:
-  metadata.gz: 91127174094430a2327e6adc7bdf395bde4249250443b2cf43dd42c1966a220ce492506fd4adcb7b633e028562f1665969e5b4f4a2cd878c98b4c06d01572666
-  data.tar.gz: 33f0a1b20274bdb46279a5110bf0037494fa77f39c0923d9cdee3e13d4d7fef246bade71fe0084cb932476e34d9627ea9e3aee55ff63ecfa80cb9c491b3a481e
+  metadata.gz: e0a2812e76491d84f81560200741c29a85b685b1c35f5d9ae64e9660890b6c908779feb654cbbb75d0f917634ffee8ea7cadc6726e88e3b402f0ecadcb70b45e
+  data.tar.gz: 8d0710fe87d9eab9e5379c84bd69ef053b7bb241e1cd243c133cb37951789eaae2efebaeb2fc8d5ad9cdae27edf919e87cc7dcd46374f54c169195cd06d72ebf

data/lib/yggdrasil_engine.rb

@@ -70,6 +70,15 @@ class YggdrasilEngine
 
   attach_function :list_known_toggles, [:pointer], :pointer
 
+  attach_function :define_counter, %i[pointer string string], :pointer
+  attach_function :inc_counter, %i[pointer string int64 string], :pointer
+  attach_function :collect_impact_metrics, [:pointer], :pointer
+  attach_function :restore_impact_metrics, %i[pointer string], :pointer
+  attach_function :define_gauge, %i[pointer string string], :pointer
+  attach_function :set_gauge, %i[pointer string double string], :pointer
+  attach_function :define_histogram, %i[pointer string string string], :pointer
+  attach_function :observe_histogram, %i[pointer string double string], :pointer
+
   class << self
     attr_accessor :logger
   end
@@ -167,4 +176,67 @@ class YggdrasilEngine
   def register_custom_strategies(strategies)
     @custom_strategy_handler.register_custom_strategies(strategies)
   end
+
+  def define_counter(name, help_text)
+    response_ptr = YggdrasilEngine.define_counter(@engine, name, help_text)
+    handle_response(response_ptr)
+  end
+
+  def inc_counter(name, value = 1, labels = nil)
+    labels_json = labels&.to_json
+    response_ptr = YggdrasilEngine.inc_counter(@engine, name, value, labels_json)
+    handle_response(response_ptr)
+  end
+
+  def collect_impact_metrics
+    response_ptr = YggdrasilEngine.collect_impact_metrics(@engine)
+    response_json = response_ptr.read_string
+    YggdrasilEngine.free_response(response_ptr)
+    response = JSON.parse(response_json, symbolize_names: true)
+
+    raise "Error: #{response[:error_message]}" if response[:status_code] == ERROR_RESPONSE
+
+    response[:value] || []
+  end
+
+  def restore_impact_metrics(metrics)
+    metrics_json = metrics.to_json
+    response_ptr = YggdrasilEngine.restore_impact_metrics(@engine, metrics_json)
+    handle_response(response_ptr)
+  end
+
+  def define_gauge(name, help_text)
+    response_ptr = YggdrasilEngine.define_gauge(@engine, name, help_text)
+    handle_response(response_ptr)
+  end
+
+  def set_gauge(name, value, labels = nil)
+    labels_json = labels&.to_json
+    response_ptr = YggdrasilEngine.set_gauge(@engine, name, value, labels_json)
+    handle_response(response_ptr)
+  end
+
+  def define_histogram(name, help_text, buckets = nil)
+    buckets_json = (buckets || []).to_json
+    response_ptr = YggdrasilEngine.define_histogram(@engine, name, help_text, buckets_json)
+    handle_response(response_ptr)
+  end
+
+  def observe_histogram(name, value, labels = nil)
+    labels_json = labels&.to_json
+    response_ptr = YggdrasilEngine.observe_histogram(@engine, name, value, labels_json)
+    handle_response(response_ptr)
+  end
+
+  private
+
+  def handle_response(response_ptr)
+    response_json = response_ptr.read_string
+    YggdrasilEngine.free_response(response_ptr)
+    response = JSON.parse(response_json, symbolize_names: true)
+
+    raise "Error: #{response[:error_message]}" if response[:status_code] == ERROR_RESPONSE
+
+    nil
+  end
 end

data/spec/impact_metrics_spec.rb

@@ -0,0 +1,166 @@
+require 'rspec'
+require 'json'
+require_relative '../lib/yggdrasil_engine'
+
+RSpec.describe YggdrasilEngine do
+  let(:yggdrasil_engine) { YggdrasilEngine.new }
+
+  describe '#inc_counter' do
+    it 'should increment counter value' do
+      yggdrasil_engine.define_counter('test_counter', 'Test counter')
+      yggdrasil_engine.inc_counter('test_counter', 5)
+      yggdrasil_engine.inc_counter('test_counter', 3)
+
+      metrics = yggdrasil_engine.collect_impact_metrics()
+      counter = metrics.find { |m| m[:name] == 'test_counter' }
+
+      expect(counter).not_to be_nil
+      expect(counter[:help]).to eq('Test counter')
+      expect(counter[:samples].length).to eq(1)
+      expect(counter[:samples][0][:value]).to eq(8)
+    end
+
+    it 'should increment counter with labels' do
+      yggdrasil_engine.define_counter('test_counter', 'Test counter')
+      yggdrasil_engine.inc_counter('test_counter', 5, { 'env' => 'test' })
+      yggdrasil_engine.inc_counter('test_counter', 3, { 'env' => 'prod' })
+
+      metrics = yggdrasil_engine.collect_impact_metrics()
+      counter = metrics.find { |m| m[:name] == 'test_counter' }
+
+      expect(counter).not_to be_nil
+      expect(counter[:samples].length).to eq(2)
+
+      test_sample = counter[:samples].find { |s| s[:labels][:env] == 'test' }
+      prod_sample = counter[:samples].find { |s| s[:labels][:env] == 'prod' }
+
+      expect(test_sample[:value]).to eq(5)
+      expect(prod_sample[:value]).to eq(3)
+    end
+  end
+
+  describe '#set_gauge' do
+    it 'should set gauge value' do
+      yggdrasil_engine.define_gauge('test_gauge', 'Test gauge')
+      yggdrasil_engine.set_gauge('test_gauge', 5.5)
+      yggdrasil_engine.set_gauge('test_gauge', 10.7)
+
+      metrics = yggdrasil_engine.collect_impact_metrics()
+      gauge = metrics.find { |m| m[:name] == 'test_gauge' }
+
+      expect(gauge).not_to be_nil
+      expect(gauge[:help]).to eq('Test gauge')
+      expect(gauge[:samples].length).to eq(1)
+      expect(gauge[:samples][0][:value]).to eq(10.7)
+    end
+
+    it 'should set gauge with labels' do
+      yggdrasil_engine.define_gauge('test_gauge', 'Test gauge')
+      yggdrasil_engine.set_gauge('test_gauge', 5.25, { 'env' => 'test' })
+      yggdrasil_engine.set_gauge('test_gauge', 3.14, { 'env' => 'prod' })
+
+      metrics = yggdrasil_engine.collect_impact_metrics()
+      gauge = metrics.find { |m| m[:name] == 'test_gauge' }
+
+      expect(gauge).not_to be_nil
+      expect(gauge[:samples].length).to eq(2)
+
+      test_sample = gauge[:samples].find { |s| s[:labels][:env] == 'test' }
+      prod_sample = gauge[:samples].find { |s| s[:labels][:env] == 'prod' }
+
+      expect(test_sample[:value]).to eq(5.25)
+      expect(prod_sample[:value]).to eq(3.14)
+    end
+  end
+
+  describe '#observe_histogram' do
+    it 'should observe histogram values' do
+      yggdrasil_engine.define_histogram('request_duration', 'Request duration', [0.1, 0.5, 1.0, 5.0])
+      yggdrasil_engine.observe_histogram('request_duration', 0.05)
+      yggdrasil_engine.observe_histogram('request_duration', 0.75)
+      yggdrasil_engine.observe_histogram('request_duration', 3.0)
+
+      metrics = yggdrasil_engine.collect_impact_metrics()
+      histogram = metrics.find { |m| m[:name] == 'request_duration' }
+
+      expect(histogram).not_to be_nil
+      expect(histogram[:help]).to eq('Request duration')
+      expect(histogram[:type]).to eq('histogram')
+      expect(histogram[:samples].length).to eq(1)
+    end
+
+    it 'should observe histogram with labels' do
+      yggdrasil_engine.define_histogram('request_duration', 'Request duration', [0.1, 0.5, 1.0, 5.0])
+      yggdrasil_engine.observe_histogram('request_duration', 0.05, { 'env' => 'test' })
+      yggdrasil_engine.observe_histogram('request_duration', 0.75, { 'env' => 'prod' })
+
+      metrics = yggdrasil_engine.collect_impact_metrics()
+      histogram = metrics.find { |m| m[:name] == 'request_duration' }
+
+      expect(histogram).not_to be_nil
+      expect(histogram[:samples].length).to eq(2)
+
+      test_sample = histogram[:samples].find { |s| s[:labels][:env] == 'test' }
+      prod_sample = histogram[:samples].find { |s| s[:labels][:env] == 'prod' }
+
+      expect(test_sample).not_to be_nil
+      expect(prod_sample).not_to be_nil
+    end
+  end
+
+  describe '#define_histogram' do
+    it 'should define histogram with default buckets' do
+      yggdrasil_engine.define_histogram('request_duration', 'Request duration')
+      yggdrasil_engine.observe_histogram('request_duration', 0.05)
+
+      metrics = yggdrasil_engine.collect_impact_metrics()
+      histogram = metrics.find { |m| m[:name] == 'request_duration' }
+
+      expect(histogram).not_to be_nil
+      expect(histogram[:type]).to eq('histogram')
+      expect(histogram[:samples].length).to eq(1)
+    end
+  end
+
+  describe '#collect_impact_metrics' do
+    it 'should return empty list when no metrics' do
+      metrics = yggdrasil_engine.collect_impact_metrics()
+      expect(metrics).to eq([])
+    end
+  end
+
+  describe '#restore_impact_metrics' do
+    it 'should restore impact metrics' do
+      yggdrasil_engine.define_counter('test_counter', 'Test counter')
+      yggdrasil_engine.inc_counter('test_counter', 10)
+      yggdrasil_engine.define_gauge('test_gauge', 'Test gauge')
+      yggdrasil_engine.set_gauge('test_gauge', 42)
+      yggdrasil_engine.define_histogram('test_histogram', 'Test histogram', [0.1, 0.5, 1.0])
+      yggdrasil_engine.observe_histogram('test_histogram', 0.25)
+
+      metrics = yggdrasil_engine.collect_impact_metrics()
+      expect(metrics.length).to eq(3)
+
+      counter = metrics.find { |m| m[:name] == 'test_counter' }
+      gauge = metrics.find { |m| m[:name] == 'test_gauge' }
+      histogram = metrics.find { |m| m[:name] == 'test_histogram' }
+
+      expect(counter[:samples][0][:value]).to eq(10)
+      expect(gauge[:samples][0][:value]).to eq(42)
+      expect(histogram).not_to be_nil
+
+      yggdrasil_engine.restore_impact_metrics(metrics)
+
+      restored_metrics = yggdrasil_engine.collect_impact_metrics()
+      expect(restored_metrics.length).to eq(3)
+
+      restored_counter = restored_metrics.find { |m| m[:name] == 'test_counter' }
+      restored_gauge = restored_metrics.find { |m| m[:name] == 'test_gauge' }
+      restored_histogram = restored_metrics.find { |m| m[:name] == 'test_histogram' }
+
+      expect(restored_counter[:samples][0][:value]).to eq(10)
+      expect(restored_gauge[:samples][0][:value]).to eq(42)
+      expect(restored_histogram).not_to be_nil
+    end
+  end
+end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: yggdrasil-engine
 version: !ruby/object:Gem::Version
-  version: 1.1.1
+  version: 1.2.0
 platform: universal-java-17
 authors:
 - Unleash
 bindir: bin
 cert_chain: []
-date: 2025-12-04 00:00:00.000000000 Z
+date: 2026-01-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ffi
@@ -42,12 +42,13 @@ files:
 - lib/yggdrasilffi_i686.dll
 - lib/yggdrasilffi_x86_64.dll
 - spec/custom_strategy_spec.rb
+- spec/impact_metrics_spec.rb
 - spec/yggdrasil_engine_spec.rb
 homepage: https://github.com/Unleash/yggdrasil-bindings
 licenses:
 - MIT
 metadata:
-  yggdrasil_core_version: 0.18.2
+  yggdrasil_core_version: 0.20.0
 rdoc_options: []
 require_paths:
 - lib