Skip to main content

ADR-008: Gossip Protocol for Discovery

Status​

Accepted

Context​

Need automatic node discovery without central registry.

Decision​

Implement gossip protocol for peer discovery and health monitoring.

Consequences​

Positive​

  • No single point of failure
  • Self-healing
  • Scales well

Negative​

  • Eventual consistency
  • Network overhead

Alternatives Considered​

  1. mDNS: Limited to local network
  2. Central registry: Single point of failure
  3. Static configuration: Not dynamic

Implementation​

Each node maintains a partial view of the cluster and periodically exchanges membership information with random peers. Failed nodes are detected through heartbeat timeouts and removed from the membership list.