consul/docs/cluster-membership/README.md

# Cluster membership

This section is a work in progress. It will contain topics like the following:

   - hashicorp/serf
   - hashicorp/memberlist
   - network coordinates
   - consul events
   - consul exec


Both client and server mode agents participate in a [Gossip Protocol](https://www.consul.io/docs/internals/gossip.html) which provides two important mechanisms. First, it allows for agents to learn about all the other agents in the cluster, just by joining initially with a single existing member of the cluster. This allows clients to discover new Consul servers. Second, the gossip protocol provides a distributed failure detector, whereby the agents in the cluster randomly probe each other at regular intervals. Because of this failure detector, Consul can run health checks locally on each agent and just sent edge-triggered updates when the state of a health check changes, confident that if the agent dies altogether then the cluster will detect that. This makes Consul's health checking design very scaleable compared to centralized systems with a central polling type of design.
contributing: start an outline for more docs Add diagrams for rpc routing and acl entity relationship contributing: create directory structure for new docs WIP diagram for catalog entities Add overview diagram Co-Authored-By: Kelly Devlin <kdevlin@hashicorp.com> 2021-04-26 18:58:44 +00:00			`# Cluster membership`
docs: move the remaining content from INTERNALS.md Into the appropriate section of the docs. 2021-08-20 20:33:29 +00:00
			`This section is a work in progress. It will contain topics like the following:`

contributing: start an outline for more docs Add diagrams for rpc routing and acl entity relationship contributing: create directory structure for new docs WIP diagram for catalog entities Add overview diagram Co-Authored-By: Kelly Devlin <kdevlin@hashicorp.com> 2021-04-26 18:58:44 +00:00			`- hashicorp/serf`
			`- hashicorp/memberlist`
			`- network coordinates`
			`- consul events`
			`- consul exec`

docs: move the remaining content from INTERNALS.md Into the appropriate section of the docs. 2021-08-20 20:33:29 +00:00
			Both client and server mode agents participate in a [Gossip Protocol](https://www.consul.io/docs/internals/gossip.html) which provides two important mechanisms. First, it allows for agents to learn about all the other agents in the cluster, just by joining initially with a single existing member of the cluster. This allows clients to discover new Consul servers. Second, the gossip protocol provides a distributed failure detector, whereby the agents in the cluster randomly probe each other at regular intervals. Because of this failure detector, Consul can run health checks locally on each agent and just sent edge-triggered updates when the state of a health check changes, confident that if the agent dies altogether then the cluster will detect that. This makes Consul's health checking design very scaleable compared to centralized systems with a central polling type of design.