From 2d75ef0c7a58c7c94dd3d96a1e3532f763221d1b Mon Sep 17 00:00:00 2001 From: Brandon Philips Date: Tue, 4 Feb 2014 17:13:24 -0800 Subject: [PATCH] feat(Documentation/discovery-protocol): explain heartbeating Explain more information about how the TTL works and etcds role. --- Documentation/discovery-protocol.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/Documentation/discovery-protocol.md b/Documentation/discovery-protocol.md index 24253455e..177a7186a 100644 --- a/Documentation/discovery-protocol.md +++ b/Documentation/discovery-protocol.md @@ -79,4 +79,10 @@ Using this information you can connect to the rest of the peers in the cluster. ### Heartbeating -At this point you will want to heartbeat your registration URL every few hours. This will be done via a Go routine inside of etcd. +At this point etcd will start heart beating to your registration URL. The +protocol uses a heartbeat so permanently deleted nodes get slowly removed from +the discovery information cluster. + +The heartbeat interval is about once per day and the TTL is one week. This +should give a sufficiently wide window to protect against a discovery service +taking a temporary outage yet provide adequate cleanup.