Configure Lambda function memory

Lambda allocates CPU power in proportion to the amount of memory configured. Memory is the amount of memory available to your Lambda function at runtime. You can increase or decrease the memory and CPU power allocated to your function using the Memory setting. You can configure memory between 128 MB and 10,240 MB in 1-MB increments. At 1,769 MB, a function has the equivalent of one vCPU (one vCPU-second of credits per second).

This page describes how and when to update the memory setting for a Lambda function.

Determining the appropriate memory setting for a Lambda function

Memory is the principal lever for controlling the performance of a function. The default setting, 128 MB, is the lowest possible setting. We recommend that you only use 128 MB for simple Lambda functions, such as those that transform and route events to other Amazon services. A higher memory allocation can improve performance for functions that use imported libraries, Lambda layers, Amazon Simple Storage Service (Amazon S3) or Amazon Elastic File System (Amazon EFS). Adding more memory proportionally increases the amount of CPU, increasing the overall computational power available. If a function is CPU, network or memory-bound, then increasing the memory setting can dramatically improve its performance.

To find the right memory configuration for your functions, we recommend using the open source Amazon Lambda Power Tuning tool. This tool uses Amazon Step Functions to run multiple concurrent versions of a Lambda function at different memory allocations and measure the performance. The input function runs in your Amazon account, performing live HTTP calls and SDK interaction, to measure likely performance in a live production scenario. You can also implement a CI/CD process to use this tool to automatically measure the performance of new functions that you deploy.

Configuring function memory (console)

You can configure the memory of your function in the Lambda console.

Configuring function memory (Amazon CLI)

You can use the update-function-configuration command to configure the memory of your function.

aws lambda update-function-configuration \
  --function-name my-function \
  --memory-size 1024

Configuring function memory (Amazon SAM)

You can use the Amazon Serverless Application Model to configure memory for your function. Update the MemorySize property in your template.yaml file and then run sam deploy.

AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31
Description: An AWS Serverless Application Model template describing your function.
Resources:
  my-function:
    Type: AWS::Serverless::Function
    Properties:
      CodeUri: .
      Description: ''
      MemorySize: 1024
      # Other function properties...

Accepting function memory recommendations (console)

If you have administrator permissions in Amazon Identity and Access Management (IAM), you can opt in to receive Lambda function memory setting recommendations from Amazon Compute Optimizer. For instructions on opting in to memory recommendations for your account or organization, see Opting in your account in the Amazon Compute Optimizer User Guide.

When you've opted in and your Lambda function meets Compute Optimizer requirements, you can view and accept function memory recommendations from Compute Optimizer in the Lambda console in General configuration.