Help Center/ FunctionGraph/ User Guide/ Configuring Functions/ Configuring Single-Instance Multi-Concurrency
Updated on 2024-11-12 GMT+08:00
View PDF

Configuring Single-Instance Multi-Concurrency

This feature is supported only by FunctionGraph v2.

Overview

By default, each function instance processes only one request at a specific time. For example, to process three concurrent requests, FunctionGraph triggers three function instances. To address this issue, FunctionGraph has launched the single-instance multi-concurrency feature, allowing multiple requests to be processed concurrently on one instance.

Scenario

This feature is suitable for functions which spend a long time to initialize or wait for a response from downstream services. The feature has the following advantages:

  • Fewer cold starts and lower latency: Usually, FunctionGraph starts three instances to process three requests, involving three cold starts. If you configure the concurrency of three requests per instance, only one instance is required, involving only one cold start.
  • Shorter processing duration and lower cost: Normally, the total duration of multiple requests is the sum of each request's processing time. With this feature configured, the total duration is from the start of the first request to the end of the last request.

Comparison

If a function takes 5s to execute each time and you set the number of requests that can be concurrently processed by an instance to 1, three requests need to be processed in three instances, respectively. Therefore, the total execution duration is 15s.

When you set Max. Requests per Instance to 5, if three requests are sent, they will be concurrently processed by one instance. The total execution time is 5s.

If the maximum number of requests per instance is greater than 1, new instances will be automatically added when this number is reached. The maximum number of instances will not exceed Max. Instances per Function you set.

Table 1 Comparison

Comparison Item

Single-Instance Single-Concurrency

Single-Instance Multi-Concurrency

Log printing

-

To print logs, Node.js Runtime uses the console.info() function, Python Runtime uses the print() function, and Java Runtime uses the System.out.println() function. In this mode, current request IDs are included in the log content. However, when multiple requests are concurrently processed by an instance, the request IDs are incorrect if you continue to use the preceding functions to print logs. In this case, use context.getLogger() to obtain a log output object, for example, Python Runtime.

log = context.getLogger()

log.info("test")

Shared variables

Not involved.

Modifying shared variables will cause errors. Mutual exclusion protection is required when you modify non-thread-safe variables during function writing.

Monitoring metrics

Perform monitoring based on the actual situation.

Under the same load, the number of function instances decreases significantly.

Flow control error

Not involved.

When there are too many requests, the error code in the body is FSS.0429, the status in the response header is 429, and the error message is Your request has been controlled by overload sdk, please retry later.

Configuring Single-Instance Multi-Concurrency

  1. Log in to the FunctionGraph console. In the navigation pane, choose Functions > Function List.
  2. Click the function to be configured to go to the function details page.
  3. Choose Configuration > Concurrency.
    Set parameters by referring to Table 2 and click Save.
    Figure 1 Concurrency configuration
    Table 2 Description

    Parameter

    Description

    Max. Requests per Instance

    Number of concurrent requests supported by a single instance. The default value is 1. The value ranges from 1 to 1,000.

    Max. Instances per Function

    Maximum number of instances in which a function can run. Default: 400. Maximum: 1000. –1: The function can run in any number of instances.

    NOTE:

    Requests that exceed the processing capability of instances will be discarded.

    Errors caused by excessive requests will not be displayed in function logs. You can obtain error details by referring to Configuring Asynchronous Execution Notification.

Configuration Constraints

  • For Python functions, threads on an instance are bound to one core due to the Python Global Interpreter Lock (GIL) lock. As a result, concurrent requests can only be processed using the single core, not multiple cores. The function processing performance cannot be improved even if larger resource specifications are configured.
  • For Node.js functions, the single-process single-thread processing of the V8 engine results in processing of concurrent requests only using a single core, not multiple cores. The function processing performance cannot be improved even if larger resource specifications are configured.
Parent topic: Configuring Functions