diff --git a/CHANGELOG-3.3.md b/CHANGELOG-3.3.md index 9764da5478c1..9e494616fa3b 100644 --- a/CHANGELOG-3.3.md +++ b/CHANGELOG-3.3.md @@ -6,6 +6,7 @@ See [code changes](https://github.com/coreos/etcd/compare/v3.3.3...v3.3.4) and [ ### Metrics, Monitoring +- Add [`etcd_server_is_leader`](https://github.com/coreos/etcd/pull/9587) Prometheus metric. - Fix [`etcd_debugging_server_lease_expired_total`](https://github.com/coreos/etcd/pull/9557) Prometheus metric. - Fix [race conditions in v2 server stat collecting](https://github.com/coreos/etcd/pull/9562). @@ -16,6 +17,23 @@ See [code changes](https://github.com/coreos/etcd/compare/v3.3.3...v3.3.4) and [ - However, a certificate whose SAN field does [not include any domain names but only IP addresses](https://github.com/coreos/etcd/issues/9541) would request `*tls.ClientHelloInfo` with an empty `ServerName` field, thus failing to trigger the TLS reload on initial TLS handshake; this becomes a problem when expired certificates need to be replaced online. - Now, `(*tls.Config).Certificates` is created empty on initial TLS client handshake, first to trigger `(*tls.Config).GetCertificate`, and then to populate rest of the certificates on every new TLS connection, even when client SNI is empty (e.g. cert only includes IPs). +### Added: `etcd` + +- Add [`--initial-election-tick-advance`](https://github.com/coreos/etcd/pull/9591) flag to configure initial election tick fast-forward. + - By default, `--initial-election-tick-advance=true`, then local member fast-forwards election ticks to speed up "initial" leader election trigger. + - This benefits the case of larger election ticks. For instance, cross datacenter deployment may require longer election timeout of 10-second. If true, local node does not need wait up to 10-second. Instead, forwards its election ticks to 8-second, and have only 2-second left before leader election. + - Major assumptions are that: cluster has no active leader thus advancing ticks enables faster leader election. Or cluster already has an established leader, and rejoining follower is likely to receive heartbeats from the leader after tick advance and before election timeout. + - However, when network from leader to rejoining follower is congested, and the follower does not receive leader heartbeat within left election ticks, disruptive election has to happen thus affecting cluster availabilities. + - Now, this can be disabled by setting `--initial-election-tick-advance=false`. + - Disabling this would slow down initial bootstrap process for cross datacenter deployments. Make your own tradeoffs by configuring `--initial-election-tick-advance` at the cost of slow initial bootstrap. + - If single-node, it advances ticks regardless. + - Address [disruptive rejoining follower node](https://github.com/coreos/etcd/issues/9333). + +### Added: `embed` + +- Add [`embed.Config.InitialElectionTickAdvance`](https://github.com/coreos/etcd/pull/9591) to enable/disable initial election tick fast-forward. + - `embed.NewConfig()` would return `*embed.Config` with `InitialElectionTickAdvance` as true by default. + ## [v3.3.3](https://github.com/coreos/etcd/releases/tag/v3.3.3) (2018-03-29) diff --git a/CHANGELOG-3.4.md b/CHANGELOG-3.4.md index 54bae2953db3..f4d4ab61cc4f 100644 --- a/CHANGELOG-3.4.md +++ b/CHANGELOG-3.4.md @@ -92,6 +92,7 @@ See [code changes](https://github.com/coreos/etcd/compare/v3.3.0...v3.4.0) and [ ### Metrics, Monitoring +- Add [`etcd_server_is_leader`](https://github.com/coreos/etcd/pull/9587) Prometheus metric. - Add [`etcd_debugging_mvcc_db_total_size_in_use_in_bytes`](https://github.com/coreos/etcd/pull/9256) Prometheus metric. - Add missing [`etcd_network_peer_sent_failures_total` count](https://github.com/coreos/etcd/pull/9437). - Fix [`etcd_debugging_server_lease_expired_total`](https://github.com/coreos/etcd/pull/9557) Prometheus metric. @@ -122,6 +123,15 @@ See [security doc](https://github.com/coreos/etcd/blob/master/Documentation/op-g ### Added: `etcd` +- Add [`--initial-election-tick-advance`](https://github.com/coreos/etcd/pull/9591) flag to configure initial election tick fast-forward. + - By default, `--initial-election-tick-advance=true`, then local member fast-forwards election ticks to speed up "initial" leader election trigger. + - This benefits the case of larger election ticks. For instance, cross datacenter deployment may require longer election timeout of 10-second. If true, local node does not need wait up to 10-second. Instead, forwards its election ticks to 8-second, and have only 2-second left before leader election. + - Major assumptions are that: cluster has no active leader thus advancing ticks enables faster leader election. Or cluster already has an established leader, and rejoining follower is likely to receive heartbeats from the leader after tick advance and before election timeout. + - However, when network from leader to rejoining follower is congested, and the follower does not receive leader heartbeat within left election ticks, disruptive election has to happen thus affecting cluster availabilities. + - Now, this can be disabled by setting `--initial-election-tick-advance=false`. + - Disabling this would slow down initial bootstrap process for cross datacenter deployments. Make your own tradeoffs by configuring `--initial-election-tick-advance` at the cost of slow initial bootstrap. + - If single-node, it advances ticks regardless. + - Address [disruptive rejoining follower node](https://github.com/coreos/etcd/issues/9333). - Add [`--pre-vote`](https://github.com/coreos/etcd/pull/9352) flag to enable to run an additional Raft election phase. - For instance, a flaky(or rejoining) member may drop in and out, and start campaign. This member will end up with a higher term, and ignore all incoming messages with lower term. In this case, a new leader eventually need to get elected, thus disruptive to cluster availability. Raft implements Pre-Vote phase to prevent this kind of disruptions. If enabled, Raft runs an additional phase of election to check if pre-candidate can get enough votes to win an election. - `--pre-vote=false` by default. @@ -153,6 +163,8 @@ See [security doc](https://github.com/coreos/etcd/blob/master/Documentation/op-g ### Added: `embed` +- Add [`embed.Config.InitialElectionTickAdvance`](https://github.com/coreos/etcd/pull/9591) to enable/disable initial election tick fast-forward. + - `embed.NewConfig()` would return `*embed.Config` with `InitialElectionTickAdvance` as true by default. - Add [`embed.Config.Logger`](https://github.com/coreos/etcd/pull/9518) to support [structured logger `zap`](https://github.com/uber-go/zap) in server-side. - Define [`embed.CompactorModePeriodic`](https://godoc.org/github.com/coreos/etcd/embed#pkg-variables) for `compactor.ModePeriodic`. - Define [`embed.CompactorModeRevision`](https://godoc.org/github.com/coreos/etcd/embed#pkg-variables) for `compactor.ModeRevision`.