lex-health

Node health monitoring for LegionIO. Reads heartbeat messages from cluster nodes, updates the database with their health status, and runs a watchdog actor for detecting stale or dead nodes.

gem install lex-health

• Health - Process incoming heartbeat messages and update node status in the database
• Watchdog - Periodically scan for nodes with stale heartbeats and expire them to unknown status

The Health runner receives heartbeat messages published by lex-node and upserts node records in the database. It uses timestamp comparison to prevent out-of-order updates from rolling back newer status. On each update it also marks all digital workers reported by the node as online and any workers no longer reported as unknown.

The Watchdog actor runs every 5 seconds and queries for healthy nodes whose last heartbeat timestamp is older than expire_time seconds (default: 60 seconds). Expired nodes are transitioned to unknown and all digital workers hosted on that node are marked offline.

• Ruby >= 3.4
• LegionIO framework
• legion-data (database required)

MIT