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
Sticky endpoints (sticky routing) utilizes [Envoy proxy’s ring hash load balancing](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/upstream/load_balancing/load_balancers#ring-hash). The main purpose of sticky endpoints is to increase the chance of cache reuse. It does not guarantee isolation.
10
+
Replica-aware routing (sticky sessions, routing) utilizes [Envoy proxy’s ring hash load balancing](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/upstream/load_balancing/load_balancers#ring-hash). The main purpose of replica-aware routing is to increase the chance of cache reuse. It does not guarantee isolation.
11
11
12
-
When enabling sticky endpoints for a service, we allow a wildcard subdomain on top of the service hostname. For a service with the host name `abcxyz123.us-west-2.aws.clickhouse.cloud`, you can use any hostname which matches `*.sticky.abcxyz123.us-west-2.aws.clickhouse.cloud` to visit the service:
12
+
When enabling replica-aware routing for a service, we allow a wildcard subdomain on top of the service hostname. For a service with the host name `abcxyz123.us-west-2.aws.clickhouse.cloud`, you can use any hostname which matches `*.sticky.abcxyz123.us-west-2.aws.clickhouse.cloud` to visit the service:
13
13
14
14
|Example hostnames|
15
15
|---|
@@ -21,16 +21,16 @@ When Envoy receives a hostname that matches such a pattern, it will compute the
21
21
22
22
Note the original hostname will still use `LEAST_CONNECTION` load balancing, which is the default routing algorithm.
23
23
24
-
## Limitations of Sticky Endpoints
24
+
## Limitations of Replica-aware routing
25
25
26
-
### Sticky endpoints do not guarantee isolation
26
+
### Replica-aware routing does not guarantee isolation
27
27
28
28
Any disruption to the service, e.g. server pod restarts (due to any reason like a version upgrade, crash, vertical scaling up, etc.), server scaled out / in, will cause a disruption to the routing hash ring. This will cause connections with the same hostname to land on a different server pod.
29
29
30
-
### Sticky endpoints do not work out of the box with private link
30
+
### Replica-aware routing does not work out of the box with private link
31
31
32
32
Customers need to manually add a DNS entry to make name resolution work for the new hostname pattern. It is possible that this can cause imbalance in the server load if customers use it incorrectly.
33
33
34
-
## Configuring Sticky Endpoints
34
+
## Configuring Replica-aware routing
35
35
36
-
To enable sticky endpoints, please contact [our support team](https://clickhouse.com/support).
36
+
To enable Replica-aware routing, please contact [our support team](https://clickhouse.com/support).
0 commit comments