docs(srv): add content reference on autoscaling MTA-5516

menu/navigation.json

@@ -3972,6 +3972,10 @@
                     "label": "Functions handlers",
                     "slug": "functions-handlers"
                   },
+                  {
+                    "label": "Functions autoscaling",
+                    "slug": "functions-autoscaling"
+                  },
                   {
                     "label": "Code examples",
                     "slug": "code-examples"
@@ -4158,6 +4162,10 @@
                     "label": "Containers concurrency",
                     "slug": "containers-concurrency"
                   },
+                  {
+                    "label": "Containers autoscaling",
+                    "slug": "containers-autoscaling"
+                  },
                   {
                     "label": "Containers billing",
                     "slug": "containers-billing"

pages/serverless-containers/reference-content/containers-autoscaling.mdx

@@ -0,0 +1,54 @@
+---
+meta:
+  title: Containers autoscaling reference
+  description: Understand how autoscaling works for Serverless Containers in Scaleway.
+content:
+  h1: Containers autoscaling reference
+  paragraph: Understand how autoscaling works for Serverless Containers in Scaleway.
+tags: serverless containers autoscaling scale up down min max
+dates:
+  validation: 2025-02-18
+  posted: 2025-02-18
+categories:
+  - serverless
+  - containers
+---
+
+## Benefits of autoscaling
+
+[Autoscaling](/serverless-containers/concepts/#autoscaling) offers several benefits, including improved responsiveness and cost efficiency. By automatically adjusting the number of instances of your resource based on current demand, you ensure that your applications can handle varying loads without manual intervention. This not only enhances user experience by maintaining performance levels but also helps in reducing costs by only using resources when necessary. Additionally, autoscaling helps in optimal resource utilization, minimizing the risk of performance degradation during peak times.
+
+## Minimum and maximum scales
+
+### Minimum scale (min-scale)
+
+This parameter sets the lowest value your resource is allowed to scale down to:
+
+- If you set a value of `0`, all instances of your resource will be terminated after 15 minutes of inactivity.
+
+- If you set a value of `1` or more, the corresponding number of instances of your resource will remain available at all time.
+
+Customizing the minimum scale for Serverless can help ensure that an instance remains pre-allocated and ready to handle requests, reducing delays associated with [cold starts](/serverless-containers/concepts/#cold-start). However, this setting also impacts the costs of your Serverless Container.
+
+### Maximum scale (max-scale)
+
+This parameter sets the maximum number of instances of your resource. You should adjust it based on your resource's traffic spikes, keeping in mind that you may wish to limit the max scale to manage costs effectively.
+
+When the maximum scale is reached, new requests are queued for processing. When the queue is full, the resource returns `503` errors for requests received beyond this point.
+
+### Autoscaler behavior
+
+The autoscaler decides to start new instances when:
+
+  - the existing instances are no longer able to handle the load because they are busy responding to other ongoing requests. By default, this happens if an instance is already processing 80 requests (max_concurrency = 80).
+
+  - our system detects an unusual number of requests. In this case, some instances may be started in anticipation to avoid a potential cold start.
+
+The same autoscaler decides to remove instances when:
+
+  - no more requests are being processed. If even a single request is being processed (or detected as being processed), then the autoscaler will not be able to remove this instance. The system also prioritizes instances with the fewest ongoing requests, or if very few requests are being sent, it tries to select a particular instance to shut down the others, and therefore scale down.
+  - an instance has not responded to a request for more than 15 minutes of inactivity. The instance is only shut down after this interval, once again to absorb any potential new peaks and thus avoid the cold start. These 15 minutes of inactivity are not configurable.
+
+<Message type="note">
+Redeploying your resource results in the termination of existing instances and a return to the min scale, which you observe when redeploying.
+</Message>

pages/serverless-functions/reference-content/functions-autoscaling.mdx

@@ -0,0 +1,53 @@
+---
+meta:
+  title: Functions autoscaling reference
+  description: Understand how autoscaling works for Serverless Functions in Scaleway.
+content:
+  h1: Functions autoscaling reference
+  paragraph: Understand how autoscaling works for Serverless Functions in Scaleway.
+tags: serverless functions autoscaling scale up down min max
+dates:
+  validation: 2025-02-18
+  posted: 2025-02-18
+categories:
+  - serverless
+  - functions
+---
+
+## Benefits of autoscaling
+
+[Autoscaling](/serverless-functions/concepts/#autoscaling) offers several benefits, including improved responsiveness and cost efficiency. By automatically adjusting the number of instances of your resource based on current demand, you ensure that your applications can handle varying loads without manual intervention. This not only enhances user experience by maintaining performance levels but also helps in reducing costs by only using resources when necessary. Additionally, autoscaling helps in optimal resource utilization, minimizing the risk of performance degradation during peak times.
+
+## Minimum and maximum scales
+
+### Minimum scale (min-scale)
+
+This parameter sets the lowest value your resource is allowed to scale down to:
+
+- If you set a value of `0`, all instances of your resource will be terminated after 15 minutes of inactivity.
+
+- If you set a value of `1` or more, the corresponding number of instances of your resource will remain available at all time.
+
+Customizing the minimum scale for Serverless can help ensure that an instance remains pre-allocated and ready to handle requests, reducing delays associated with [cold starts](/serverless-functions/concepts/#cold-start). However, this setting also impacts the costs of your Serverless Function.
+
+### Maximum scale (max-scale)
+
+This parameter sets the maximum number of instances of your resource. You should adjust it based on your resource's traffic spikes, keeping in mind that you may wish to limit the max scale to manage costs effectively.
+
+When the maximum scale is reached, new requests are queued for processing. When the queue is full, the resource returns `503` errors for requests received beyond this point.
+
+### Autoscaler behavior
+
+The autoscaler decides to start new instances when:
+
+  - the existing instances are no longer able to handle the load because they are busy responding to other ongoing requests. By default, this happens if an instance is already processing 80 requests (max_concurrency = 80).
+  - our system detects an unusual number of requests. In this case, some instances may be started in anticipation to avoid a potential cold start.
+
+The same autoscaler decides to remove instances when:
+
+  - no more requests are being processed. If even a single request is being processed (or detected as being processed), then the autoscaler will not be able to remove this instance. The system also prioritizes instances with the fewest ongoing requests, or if very few requests are being sent, it tries to select a particular instance to shut down the others, and therefore scale down.
+  - an instance has not responded to a request for more than 15 minutes of inactivity. The instance is only shut down after this interval, once again to absorb any potential new peaks and thus avoid the cold start. These 15 minutes of inactivity are not configurable.
+
+<Message type="note">
+Redeploying your resource results in the termination of existing instances and a return to the min scale, which you observe when redeploying.
+</Message>