lex-telemetry 0.1.2 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 297c8cd758a46a949db0cc219413fe1d3640707b88a956a8523afe530f352c15
-  data.tar.gz: 0b8eaeb3500a514ea1e8207915b8bb6cbdfdc61a67b074820cce4ff8e47c8102
+  metadata.gz: 783eceb3850cecfce20c43c308552378cf9c974c41c00ef9c977c55bd0f878fd
+  data.tar.gz: 06ac5a8ea95873f8936e0e8155f0563e622bbff9d21053bab0d8dada2aedb0b5
 SHA512:
-  metadata.gz: 4c79f6fe97ec74a2067e29a195bda11ba1bfa318a496407c6daeb8bc8780f10fbc52fef86663c29c4f4c32ec16b7bf74ad96c7f860dfd9c8931e47f6d4ffdb95
-  data.tar.gz: dba3f9f4671cfe42f263ec72855de99d9ca01aa039483b504044dd00a85bb57f985939a5170e7d18537c39edc98e490021552208dfc0b735343381e8401586fb
+  metadata.gz: f35fe3b501776e7fa383bb4cff16b06a17ef388ba3d0dafddb6e1ffcc7c62d98d2376d3a87e55fe93d344739ed3860cbbb34e9bdb61ae2126f47c5d69a923d81
+  data.tar.gz: f98c67177e37a991164b2e583b5cf36ef66dbfc851485c1fbb700924c4e256acd72649e4a72ffe2356965df50f64115ceb4d3e9a69c79567f08bd8ea78bcbe01

data/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## [0.1.4] - 2026-03-21
+
+### Added
+- `record_cross_region(from_region:, to_region:)`: thread-safe atomic counter for cross-region message routing
+- `record_replication_lag(region:, lag_seconds:)`: stores latest replication lag sample per region
+- `region_stats`: returns cross-region counters and replication lag samples
+- `concurrent-ruby` runtime dependency for `Concurrent::AtomicFixnum` and `Concurrent::Hash`
+- Subscription actor now records cross-region metrics when lex-telemetry is loaded
+
+### Changed
+- `RegionReporter` actor interval reduced from 120s to 60s
+- `RegionReporter` now calls `region_stats` instead of `region_metrics`
+
+## [0.1.3] - 2026-03-21
+
+### Added
+- `region_metrics` runner method: reports current region, primary, failover, peers, affinity, and is_primary status
+- `RegionReporter` actor: publishes region metrics every 120 seconds
+
 ## [0.1.2] - 2026-03-20
 
 ### Added

data/Gemfile

@@ -2,3 +2,5 @@
 
 source 'https://rubygems.org'
 gemspec
+
+gem 'concurrent-ruby'

data/lex-telemetry.gemspec

@@ -28,6 +28,8 @@ Gem::Specification.new do |spec|
   end
   spec.require_paths = ['lib']
 
+  spec.add_dependency 'concurrent-ruby', '>= 1.2'
+
   spec.add_development_dependency 'rake'
   spec.add_development_dependency 'rspec'
   spec.add_development_dependency 'rubocop'

data/lib/legion/extensions/telemetry/actors/region_reporter.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Telemetry
+      module Actor
+        class RegionReporter < Legion::Extensions::Actors::Every
+          def runner_class
+            'Legion::Extensions::Telemetry::Runners::Telemetry'
+          end
+
+          def runner_function
+            'region_stats'
+          end
+
+          def time
+            60
+          end
+
+          def run_now?
+            false
+          end
+
+          def use_runner?
+            false
+          end
+
+          def check_subtask?
+            false
+          end
+
+          def generate_task?
+            false
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/telemetry/runners/telemetry.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require 'concurrent'
+
 module Legion
   module Extensions
     module Telemetry
@@ -7,6 +9,34 @@ module Legion
         module Telemetry
           module_function
 
+          def cross_region_counters
+            @cross_region_counters ||= Concurrent::Hash.new { |h, k| h[k] = Concurrent::AtomicFixnum.new(0) }
+          end
+
+          def replication_lag_samples
+            @replication_lag_samples ||= Concurrent::Hash.new
+          end
+
+          def record_cross_region(from_region:, to_region:, **_opts)
+            key = "#{from_region}->#{to_region}"
+            cross_region_counters[key].increment
+            { success: true, key: key, count: cross_region_counters[key].value }
+          end
+
+          def record_replication_lag(region:, lag_seconds:, **_opts)
+            replication_lag_samples[region] = { lag_seconds: lag_seconds, recorded_at: Time.now.to_i }
+            { success: true, region: region, lag_seconds: lag_seconds }
+          end
+
+          def region_stats(**_opts)
+            {
+              success:         true,
+              cross_region:    cross_region_counters.transform_values(&:value),
+              replication_lag: replication_lag_samples.dup,
+              timestamp:       Time.now.to_i
+            }
+          end
+
           SCAN_DIRS = [
             File.expand_path('~/.claude/projects')
           ].freeze
@@ -129,6 +159,41 @@ module Legion
             { success: false, error: e.message }
           end
 
+          def region_metrics(**_opts)
+            region_info = if defined?(Legion::Region)
+                            {
+                              current:  Legion::Region.current,
+                              primary:  Legion::Region.primary,
+                              failover: Legion::Region.failover,
+                              peers:    Legion::Region.peers
+                            }
+                          else
+                            { current: nil, primary: nil, failover: nil, peers: [] }
+                          end
+
+            affinity = if defined?(Legion::Settings)
+                         begin
+                           Legion::Settings.dig(:region, :default_affinity)
+                         rescue StandardError
+                           'prefer_local'
+                         end
+                       else
+                         'prefer_local'
+                       end
+
+            is_primary = region_info[:current] && region_info[:current] == region_info[:primary]
+
+            {
+              success:          true,
+              region:           region_info,
+              default_affinity: affinity,
+              is_primary:       is_primary,
+              timestamp:        Time.now.to_i
+            }
+          rescue StandardError => e
+            { success: false, error: e.message }
+          end
+
           def privacy_mode?
             if defined?(Legion::Settings) && Legion::Settings.respond_to?(:enterprise_privacy?)
               Legion::Settings.enterprise_privacy?
@@ -141,6 +206,8 @@ module Legion
             @event_store = nil
             @parsers = nil
             @high_water_mark = nil
+            @cross_region_counters = nil
+            @replication_lag_samples = nil
           end
         end
       end

data/lib/legion/extensions/telemetry/version.rb

@@ -3,7 +3,7 @@
 module Legion
   module Extensions
     module Telemetry
-      VERSION = '0.1.2'
+      VERSION = '0.1.4'
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-telemetry
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.4
 platform: ruby
 authors:
 - Esity
@@ -9,6 +9,20 @@ bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: concurrent-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.2'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -100,6 +114,7 @@ files:
 - lib/legion/extensions/telemetry.rb
 - lib/legion/extensions/telemetry/actors/collector.rb
 - lib/legion/extensions/telemetry/actors/publisher.rb
+- lib/legion/extensions/telemetry/actors/region_reporter.rb
 - lib/legion/extensions/telemetry/helpers/event_store.rb
 - lib/legion/extensions/telemetry/helpers/high_water_mark.rb
 - lib/legion/extensions/telemetry/helpers/scrubber.rb