Struct InstanceRegistry 

pub struct InstanceRegistry { /* private fields */ }

Registry for instance self-registration in standalone multi-node deployments.

Each Box host registers its instances with the registry so Gateway can discover endpoints for traffic routing.

Implementations

impl InstanceRegistry

pub fn new() -> Self

Create a new empty registry.

pub fn register( &mut self, instance_id: &str, service: &str, endpoint: &str, host_id: &str, metadata: HashMap<String, String>, )

Register an instance.

pub fn deregister(&mut self, instance_id: &str) -> bool

Deregister an instance.

pub fn heartbeat(&mut self, instance_id: &str) -> bool

Record a heartbeat for an instance.

pub fn endpoints(&self, service: &str) -> Vec<String>

Get all endpoints for a service (for load balancing).

pub fn instances_for_service(&self, service: &str) -> Vec<&str>

Get all instances for a service.

pub fn instances_on_host(&self, host_id: &str) -> Vec<&str>

Get all instances on a specific host.

pub fn evict_stale(&mut self, max_age: Duration) -> Vec<String>

Remove stale entries that haven’t sent a heartbeat within the given duration.

pub fn len(&self) -> usize

Total number of registered instances.

pub fn is_empty(&self) -> bool

Whether the registry is empty.

pub fn services(&self) -> Vec<String>

List all unique services in the registry.

Trait Implementations

impl Default for InstanceRegistry

fn default() -> Self

Returns the “default value” for a type.