lex-node 0.3.1 → 0.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a8bce7f974591cba97508bd1d4a9033315f4207050da3996f082438267c1de9c
-  data.tar.gz: 3af059ccb67edb50d52c749adbd8014cd29c9d75af4fa3b85c84c678a453301b
+  metadata.gz: 175c70421d225a25f82b9ead14a05e86bf144fcf34bb55c90ce77555c8274d69
+  data.tar.gz: fb186fbbeb5da2da48ba9ac7ec57621d36189520bf3b0fa4dc1e43d22de9bf41
 SHA512:
-  metadata.gz: 5dd82b1f0b200c50a7d4b3cedc639e73ad47b27335a8405182b6f2c1a9f6372930c51d1b3c52bcd0403198593d6b22679e989e83f944e75b28a59d86a19ce339
-  data.tar.gz: 5a3c3d9ffdccca307b9e8981b73f18021eabdfb2ee44167231b75290d7c8dd33fd2474e08db6ccb377eede6fb634e5274de5c558fe77aa914a9818a96c88ebc9
+  metadata.gz: ab54030dfc8acc9b1dc941cd283552f9fd0d502dd1066a7999cc79443cb9b3493c31656e613432c0c44e16358346f2795535ef076af59bad9895fbcf6620ad78
+  data.tar.gz: 050a882c62acf8b4f44e0816964a91a351d3d907de445b535c2275ad9dd183a589c338929f259261124bbec01546181321b23a388b21833a6563da59432ac6dc

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.3.2] - 2026-03-21
+
+### Added
+- `Helpers::Rabbitmq` module: queries RabbitMQ Management API for cluster health metrics (node count, quorum queue leaders, shovel link status)
+- Beat heartbeat message now includes `rabbitmq_cluster` section with node count, quorum leaders, and shovel links
+- 15 new specs covering all Rabbitmq helper methods (111 total, 0 failures)
+
 ## [0.3.1] - 2026-03-19
 
 ### Fixed

data/CLAUDE.md

@@ -10,7 +10,7 @@ Core Legion Extension responsible for node identity within a LegionIO cluster. H
 
 **GitHub**: https://github.com/LegionIO/lex-node
 **License**: MIT
-**Version**: 0.3.0
+**Version**: 0.3.1
 
 ## Architecture
 

data/README.md

@@ -2,7 +2,7 @@
 
 Node identity and cluster management for [LegionIO](https://github.com/LegionIO/LegionIO). Handles heartbeat broadcasting, dynamic configuration distribution, cluster secret exchange, Vault token management, and RSA public key distribution between nodes.
 
-**Version**: 0.3.0
+**Version**: 0.3.1
 
 This is a core LEX installed by default with LegionIO.
 

data/lib/legion/extensions/node/helpers/rabbitmq.rb

@@ -0,0 +1,128 @@
+# frozen_string_literal: true
+
+require 'net/http'
+require 'json'
+require 'uri'
+
+module Legion
+  module Extensions
+    module Node
+      module Helpers
+        module Rabbitmq
+          module_function
+
+          def cluster_health(settings: nil)
+            settings ||= resolve_settings
+            http = build_http(settings)
+            {
+              node_count:     fetch_node_count(http, settings),
+              quorum_leaders: fetch_quorum_leaders(http, settings),
+              shovel_links:   fetch_shovel_links(http, settings)
+            }
+          rescue Errno::ECONNREFUSED, Errno::ETIMEDOUT, SocketError, Net::OpenTimeout, Net::ReadTimeout => e
+            log_warn("RabbitMQ management API unreachable: #{e.message}")
+            { node_count: unreachable, quorum_leaders: unreachable, shovel_links: unreachable }
+          end
+
+          def fetch_node_count(http, settings)
+            body = api_get(http, '/api/nodes', settings)
+            return unreachable unless body
+
+            running = body.count { |n| n['running'] }
+            total   = body.size
+            status  = if running == total
+                        'ok'
+                      else
+                        (running.positive? ? 'warn' : 'critical')
+                      end
+            { status: status, running: running, total: total }
+          end
+
+          def fetch_quorum_leaders(http, settings)
+            vhost = settings.dig(:connection, :vhost) || '/'
+            encoded_vhost = URI.encode_www_form_component(vhost)
+            body = api_get(http, "/api/queues/#{encoded_vhost}", settings)
+            return unreachable unless body
+
+            quorum_queues = body.select { |q| q['type'] == 'quorum' }
+            return { status: 'ok', quorum_queues: 0, leaders_on_this_node: 0 } if quorum_queues.empty?
+
+            node_name = resolve_node_name(http, settings)
+            leaders_here = quorum_queues.count { |q| q['leader'] == node_name }
+            { status: 'ok', quorum_queues: quorum_queues.size, leaders_on_this_node: leaders_here }
+          end
+
+          def fetch_shovel_links(http, settings)
+            vhost = settings.dig(:connection, :vhost) || '/'
+            encoded_vhost = URI.encode_www_form_component(vhost)
+            body = api_get(http, "/api/shovels/#{encoded_vhost}", settings)
+            return unreachable unless body
+
+            running = body.count { |s| s['state'] == 'running' }
+            total   = body.size
+            status  = if total.zero?
+                        'ok'
+                      else
+                        (running == total ? 'ok' : 'warn')
+                      end
+            { status: status, total: total, running: running }
+          rescue StandardError
+            { status: 'ok', total: 0, running: 0 }
+          end
+
+          def build_http(settings)
+            host = settings.dig(:connection, :host) || '127.0.0.1'
+            port = settings[:management_port] || 15_672
+            http = Net::HTTP.new(host, port)
+            http.open_timeout = 3
+            http.read_timeout = 5
+            http
+          end
+
+          def api_get(http, path, settings)
+            req = Net::HTTP::Get.new(path)
+            req.basic_auth(
+              settings.dig(:connection, :user) || 'guest',
+              settings.dig(:connection, :password) || 'guest'
+            )
+            response = http.request(req)
+            return nil unless response.code.start_with?('2')
+
+            ::JSON.parse(response.body)
+          rescue StandardError
+            nil
+          end
+
+          def resolve_node_name(http, settings)
+            body = api_get(http, '/api/whoami', settings)
+            return nil unless body
+
+            nodes = api_get(http, '/api/nodes', settings)
+            return nil unless nodes
+
+            nodes.first&.dig('name')
+          end
+
+          def resolve_settings
+            return Legion::Settings[:transport].to_h if defined?(Legion::Settings) && Legion::Settings.respond_to?(:[])
+
+            { connection:      { host: '127.0.0.1', user: 'guest', password: 'guest', vhost: '/' },
+              management_port: 15_672 }
+          end
+
+          def unreachable
+            { status: 'unknown', detail: 'management api unreachable' }
+          end
+
+          def log_warn(msg)
+            if defined?(Legion::Logging)
+              Legion::Logging.warn { msg }
+            elsif defined?(Legion::Transport) && Legion::Transport.respond_to?(:logger)
+              Legion::Transport.logger.warn(msg)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/node/transport/messages/beat.rb

@@ -33,6 +33,7 @@ module Legion
               hash[:version] = Legion::VERSION if defined?(Legion::VERSION)
               hash[:metrics] = collect_metrics
               hash[:hosted_worker_ids] = collect_worker_ids
+              hash[:rabbitmq_cluster] = collect_rabbitmq_cluster
               hash
             end
 
@@ -76,6 +77,14 @@ module Legion
               (::Process.clock_gettime(::Process::CLOCK_MONOTONIC) - BOOT_TIME).round(0)
             end
 
+            def collect_rabbitmq_cluster
+              return { status: 'unknown', detail: 'helper not loaded' } unless defined?(Legion::Extensions::Node::Helpers::Rabbitmq)
+
+              Legion::Extensions::Node::Helpers::Rabbitmq.cluster_health
+            rescue StandardError => e
+              { status: 'unknown', detail: e.message }
+            end
+
             def collect_worker_ids
               return [] unless defined?(Legion::DigitalWorker)
 

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

@@ -3,7 +3,7 @@
 module Legion
   module Extensions
     module Node
-      VERSION = '0.3.1'
+      VERSION = '0.3.2'
     end
   end
 end

data/lib/legion/extensions/node.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require 'legion/extensions/node/version'
+require 'legion/extensions/node/helpers/rabbitmq'
 
 module Legion
   module Extensions

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-node
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.3.2
 platform: ruby
 authors:
 - Esity
@@ -53,6 +53,7 @@ files:
 - lib/legion/extensions/node/data_test/migrations/002_node_history_table.rb
 - lib/legion/extensions/node/data_test/migrations/003_legion_version_colume.rb
 - lib/legion/extensions/node/data_test/migrations/004_node_extensions.rb
+- lib/legion/extensions/node/helpers/rabbitmq.rb
 - lib/legion/extensions/node/runners/beat.rb
 - lib/legion/extensions/node/runners/node.rb
 - lib/legion/extensions/node/runners/vault.rb