Skip to content

Commit e981002

Browse files
committed
fix(lb): correct info re: sticky sessions
1 parent ce03b77 commit e981002

File tree

2 files changed

+7
-6
lines changed

2 files changed

+7
-6
lines changed

pages/load-balancer/concepts.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ Backend servers must be Scaleway resources (Instances, Elastic Metal or Dedibox
3636

3737
## Backend protection
3838

39-
Backend protection is a set of configurable values that allow you to control how load is distributed to backend servers. You can use these settings to configure the **maximum number of simultaneous requests** to a given backend server before it is considered to be at maximum capacity. You can also configure a **queue timeout** value, which defines the maximum amount of time (in ms) to queue a request or connection for a particular backend server when [stickiness](#sticky-session) is enabled. Once this value is reached, the request/connection will be directed to a different backend server.
39+
Backend protection is a set of configurable values that allow you to control how load is distributed to backend servers. You can use these settings to configure the **maximum number of simultaneous requests** to a given backend server before it is considered to be at maximum capacity. You can also configure a **queue timeout** value, which defines the maximum amount of time (in ms) to queue a request or connection for a particular backend server. Read more in our [configuring backends documentation](/load-balancer/reference-content/configuring-backends/#backend-protection).
4040

4141
## Balancing methods
4242

pages/load-balancer/reference-content/configuring-backends.mdx

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -121,17 +121,18 @@ Backend protection settings define when the Load Balancer should view a backend
121121

122122
A **Limit backend load** toggle displays in the Backend protection screen.
123123
- **Toggle deactivated**: No settings to limit backend load are used. The Load Balancer can send an unlimited number of simultaneous connections/requests to backend servers.
124-
- **Toggle activated**: Additional settings to limit backend load are activated and appear for you to configure. These additional settings are **Max simultaneous** and (if you previously [activated sticky sessions](#sticky-sessions)) **Queue timeout**.
124+
- **Toggle activated**: Additional settings to limit backend load are activated and appear for you to configure. These additional settings are **Max simultaneous** and **Queue timeout**.
125125

126126
- **Max simultaneous**: Defines the maximum number of simultaneous requests (for HTTP) or simultaneous connections (for TCP) to any single backend server. A value of 20 means that each backend server will have a limit of 20 connections (even if, for example, there are only three servers in the backend). This setting is particularly relevant when using the [First available](#balancing-method) balancing method.
127127

128128
The minimum value for this field is 1, and the maximum value [depends on the Load Balancer type](/load-balancer/concepts/#maximum-connections). You should choose an appropriate value based on your backend server characteristics and traffic patterns.
129129

130-
When the maximum number of simultaneous connections/requests is reached for a single backend server, the Load Balancer will either:
131-
- Pass the request/connection to a different backend server that still has slots available, unless no backend server has available slots in which case the Load Balancer indicates to the client that the request cannot be handled (e.g. `503 service unavailable` for HTTP or connection closed for TCP), or
132-
- If sticky sessions are enabled: put the request into a queue for the backend server in question. Therefore, if and only if you enabled [activated sticky sessions](#sticky-sessions), you will also be prompted to set the following value:
130+
When the maximum number of simultaneous connections/requests is reached for a single backend server, the Load Balancer queues the incoming connection/requst, waiting for an available connection slot.
131+
- **If sticky sessions are not enabled**: Requests are queued only when **all** backend servers in the pool have reached their maximum limit.
132+
- ** If sticky sessions are enabled:**: Since traffic is pinned to specific backend servers, a request is queued as soon as its target backend reaches its maximum limit, even if other backends have available capacity.
133+
In both cases, if the request remains unprocessed after the **queue timeout** (see below), the Load Balancer indicates to the client that the request cannot be handled.
133134

134-
- **Queue timeout**: Defines the maximum length of time (in ms) to queue a request/connection for a given backend where [stickiness](#sticky-sessions) is enabled. The default value for this setting is 5 000, the minimum value is 1 and the maximum value is 2 147 483 647. Choose an appropriate value based the acceptable wait time for your users, and your application's characteristics and traffic patterns.
135+
- **Queue timeout**: Defines the maximum length of time (in ms) to queue a request/connection for a given backend. The default value for this setting is 5 000, the minimum value is 1 and the maximum value is 2 147 483 647. Choose an appropriate value based the acceptable wait time for your users, and your application's characteristics and traffic patterns.
135136

136137
Requests will wait in the queue for an available connection slot. If the queue timeout value is reached, the Load Balancer indicates to the client that the request cannot be handled (e.g. `503 service unavailable` for HTTP or connection closed for TCP).
137138

0 commit comments

Comments
 (0)