You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: site/content/en/latest/tasks/traffic/zone-aware-routing.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -20,13 +20,13 @@ The `zoneAware` field supports two modes: `preferLocal` (prefer same-zone endpoi
20
20
|`RoundRobin`| ✓ | ✓ |
21
21
|`LeastRequest`| ✓ | ✓ |
22
22
|`Random`| ✓ | ✓ |
23
-
|`ConsistentHash`| ✗ |✗|
23
+
|`ConsistentHash`| ✗ |✓|
24
24
|`BackendUtilization`| ✗ | ✓ |
25
25
|`DynamicModule`| ✗ | ✗ |
26
26
27
27
**Why some combinations are unsupported:**
28
28
29
-
-**`ConsistentHash` + any zone-aware mode**: Neither `preferLocal` nor `weightedZones` are currently supported. `weightedZones`support is planned (see [#8146](https://github.com/envoyproxy/gateway/issues/8146)).
29
+
-**`ConsistentHash` + `preferLocal`**: Envoy's consistent hashing policies (Maglev/RingHash) route based on a request hash rather than endpoint locality, so the prefer-local algorithm cannot be layered on top. Use `weightedZones`to influence traffic distribution across zones while preserving hash-based affinity.
30
30
-**`BackendUtilization` + `preferLocal`**: Envoy's `wrr_locality` extension, which wraps `BackendUtilization` with locality-weight support, does not implement the prefer-local routing algorithm. Only `weightedZones` is supported.
31
31
-**`DynamicModule` + any zone-aware mode**: Custom load balancing modules manage their own endpoint selection entirely. Zone-aware routing cannot be layered on top of an opaque third-party algorithm.
32
32
@@ -194,7 +194,7 @@ spec:
194
194
195
195
#### WeightedZones
196
196
`weightedZones`distributes traffic across zones proportionally according to explicit weights. Zones not listed receive a default weight of 1.
197
-
This mode is supported by `RoundRobin`, `LeastRequest`, `Random`, and `BackendUtilization`.
197
+
This mode is supported by `RoundRobin`, `LeastRequest`, `Random`, `ConsistentHash`, and `BackendUtilization`.
198
198
199
199
The example below routes 70% of traffic to `us-east-1a` and 30% to `us-east-1b` using `BackendUtilization`, which combines ORCA-based backend load metrics with locality weighting via Envoy's `wrr_locality` extension.
0 commit comments