Post

Understanding EC2ThrottledException in AWS Lambda for Optimal Performance

AWS Lambda has transformed how developers deploy and manage serverless applications, allowing businesses to focus on coding rather than infrastructure management. However, developers often face pitfalls with resource limits under heavy workloads. One such exception that can pop up during peak activity is the EC2ThrottledException. This article explores this exception in detail, offering solutions and code examples to help you avoid or manage throttling effectively in AWS Lambda.

What is EC2ThrottledException?

The EC2ThrottledException occurs in AWS Lambda when you’ve hit the service limits on EC2 resources that Lambda relies on. AWS Lambda scales your functions automatically based on incoming requests, but this is subject to limits on EC2 capacity. When your function invokes other AWS services that also rely on EC2 instances, you might encounter EC2ThrottledException.

Common Causes

  1. High Concurrent Executions: When multiple instances of your function run concurrently, the underlying EC2 instances may throttle due to resource constraints.

  2. Network or API Limits: If your function makes multiple HTTP calls to APIs or databases, the associated services may have rate limits that lead to throttling.

  3. Resource Constraints: If your AWS account has limited EC2 resources due to the default service quotas, you may run into throttling.

How to Handle EC2ThrottledException

1. Implement Retry Logic

Use an exponential backoff strategy to retry the operation when catching EC2ThrottledException. This helps by reducing the load temporarily and gives service time to recover.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
import com.amazonaws.services.lambda.runtime.Context;
import com.amazonaws.services.lambda.runtime.RequestHandler;
import com.amazonaws.services.lambda.model.EC2ThrottledException;

public class MyLambdaFunction implements RequestHandler<String, String> {
    
    private static final int MAX_RETRIES = 5;

    @Override
    public String handleRequest(String input, Context context) {
        int retries = 0;
        boolean success = false;

        while (retries < MAX_RETRIES && !success) {
            try {
                // Your business logic or API call
                // Simulating a potential exception throw
                performTask(input);
                success = true;
            } catch (EC2ThrottledException e) {
                retries++;
                if (retries < MAX_RETRIES) {
                    long sleepTime = (long) Math.pow(2, retries) * 1000; // Exponential backoff
                    Thread.sleep(sleepTime);
                } else {
                    throw e; // Re-throw after max retries
                }
            } catch (Exception e) {
                throw e;
            }
        }
        return "Task Completed";
    }

    private void performTask(String input) throws EC2ThrottledException {
        // Example function that may throw EC2ThrottledException
        // Simulating a throttled scenario
        if (input.equals("throttle")) {
            throw new EC2ThrottledException("Throttled by EC2");
        }
    }
}

2. Optimize Lambda Configuration

  • Provisioned Concurrency: Switch to provisioned concurrency for your Lambda function. This ensures that a specific number of execution environments are always warm and ready to handle incoming requests.

  • Adjust Memory and Timeout: Ensure your Lambda function is allocated enough memory and time to execute to prevent timeouts that can lead to excessive retries.

3. Monitor and Scale with CloudWatch

Use AWS CloudWatch to monitor Lambda metrics. Set up alerts to notify you of Common issues:

  • Monitor Throttles metric: This tells you how many times your API requests are throttled.
  • Monitor ConcurrentExecutions: This indicates if you are reaching your account’s limits.
1
2
3
4
aws cloudwatch put-metric-alarm --alarm-name "LambdaThrottles" \
--metric-name "Throttles" --namespace "AWS/Lambda" --statistic "Sum" \
--period 300 --threshold 1 --comparison-operator "GreaterThanThreshold" \
--evaluation-periods 1 --alarm-actions "arn:aws:sns:region:account-id:NotifyMe"

4. Request Limit Increases

If your application consistently hits throttling limits, consider requesting a limit increase via the AWS Support Center.

Code Example: Handling API Rate Limits

Often, EC2ThrottledException may arise from external API rate limits. Here’s an example on how to manage API calls that may hit throttling limits by using a custom HTTP client.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
import java.util.concurrent.TimeUnit;
import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;

public class CustomApiCaller {

    private static final int MAX_RETRIES = 3;
    private OkHttpClient client;

    public CustomApiCaller() {
        client = new OkHttpClient.Builder()
                .connectTimeout(10, TimeUnit.SECONDS)
                .readTimeout(30, TimeUnit.SECONDS)
                .build();
    }

    public String callApi(String url) throws Exception {
        int retries = 0;

        while (retries < MAX_RETRIES) {
            Request request = new Request.Builder()
                    .url(url)
                    .build();

            try (Response response = client.newCall(request).execute()) {
                if (response.isSuccessful()) {
                    return response.body().string();
                } else if (response.code() == 429) { // Too Many Requests
                    retries++;
                    long sleepTime = (long) Math.pow(2, retries) * 1000; // Backoff
                    Thread.sleep(sleepTime);
                } else {
                    throw new Exception("API call failed: " + response.code());
                }
            }
        }
        throw new Exception("Max retries reached");
    }
}

Conclusion

The EC2ThrottledException can limit the effectiveness of your AWS Lambda functions during high demand periods. Understanding this exception and implementing strategies to handle it efficiently is crucial for maintaining performance in serverless applications. By applying best practices such as retry logic, optimizing Lambda configurations, and leveraging monitoring tools, developers can enhance the resilience of their applications against throttling.

References

This post is licensed under CC BY 4.0 by the author.