AWS SDK를 사용하여 Lambda 함수를 호출할 때 재시도 및 시간 초과 문제를 해결하려면 어떻게 해야 합니까?

최종 업데이트 날짜: 2021년 10월 22일

AWS SDK를 사용하여 AWS Lambda 함수를 호출할 때 함수가 시간 초과되거나 API 요청이 응답하지 않거나 API 작업이 중복됩니다. 이 문제를 해결하려면 어떻게 해야 합니까?

간략한 설명

AWS SDK를 사용하여 Lambda 함수를 호출할 때 재시도 및 시간 초과 문제가 발생하는 이유는 다음과 같습니다.

  • 원격 API에 연결할 수 없거나 API 호출에 응답하는 데 너무 오래 걸립니다.
  • API 호출 시 소켓 제한 시간 내에 응답을 받지 못합니다.
  • API 호출 시 Lambda 함수의 제한 시간 내에 응답을 받지 못합니다.

참고: 네트워크 연결 문제가 발생할 경우 API 호출이 예상보다 더 오래 걸릴 수 있습니다. 또한 네트워크 문제로 인해 재시도 및 중복 API 요청이 발생할 수도 있습니다. 이러한 문제에 대비하려면 Lambda 함수가 멱등인지 확인해야 합니다.

AWS SDK를 사용하여 API를 호출할 때 호출이 실패하면 AWS SDK에서 자동으로 호출을 다시 시도합니다. AWS SDK의 재시도 횟수와 기간은 AWS SDK에 따라 다른 설정에 의해 결정됩니다.

기본 AWS SDK 재시도 설정

참고: 다른 AWS 서비스의 경우 일부 값이 다를 수 있습니다.

AWS SDK 최대 재시도 횟수 연결 제한 시간 소켓 제한 시간
Python(Boto 3) 서비스에 따라 다름 60초 60초
JavaScript/Node.js 서비스에 따라 다름 해당 사항 없음 120초
Java 3 10초 50초
.NET 4 100초 300초
Go 3 해당 사항 없음 해당 사항 없음

재시도 및 시간 초과 문제를 해결하려면 먼저 API 호출 로그를 검토하여 문제를 찾습니다. 그런 다음 각 사용 사례의 필요에 따라 AWS SDK의 재시도 횟수 및 제한 시간 설정을 변경합니다. API 호출에 대한 응답에 충분한 시간을 허용하려면 [Lambda 함수 제한 시간 설정(Lambda function timeout setting)]의 시간을 늘립니다.

해결 방법

AWS SDK를 통해 수행된 API 호출 로깅

Amazon CloudWatch Logs를 사용하면 실패한 연결 및 각 연결마다 시도한 재시도 횟수에 대한 세부 정보를 확인할 수 있습니다. 자세한 내용은 AWS Lambda에 대한 Amazon CloudWatch Logs 액세스를 참조하세요. 또는 사용 중인 AWS SDK에 따라 다음 지침을 참조하세요.

API 호출에서 연결을 설정할 수 없는 경우에 대한 예제 오류 로그(연결 시간 초과)

START RequestId: b81e56a9-90e0-11e8-bfa8-b9f44c99e76d Version: $LATEST
2018-07-26T14:32:27.393Z    b81e56a9-90e0-11e8-bfa8-b9f44c99e76d    [AWS ec2 undefined 40.29s 3 retries] describeInstances({})
2018-07-26T14:32:27.393Z    b81e56a9-90e0-11e8-bfa8-b9f44c99e76d    { TimeoutError: Socket timed out without establishing a connection

...

API 호출 연결이 성공했지만 API 응답이 너무 오래 걸려 시간 초과된 경우에 대한 예제 오류 로그(소켓 시간 초과)

START RequestId: 3c0523f4-9650-11e8-bd98-0df3c5cf9bd8 Version: $LATEST
2018-08-02T12:33:18.958Z    3c0523f4-9650-11e8-bd98-0df3c5cf9bd8    [AWS ec2 undefined 30.596s 3 retries] describeInstances({})
2018-08-02T12:33:18.978Z    3c0523f4-9650-11e8-bd98-0df3c5cf9bd8    { TimeoutError: Connection timed out after 30s

참고: API 요청에서 Lambda 함수의 제한 시간 내에 응답을 받지 못하면 이러한 로그가 생성되지 않습니다. 함수 제한 시간으로 인해 API 요청이 종료된 경우 다음 중 하나를 수행합니다.

  • 모든 재시도가 제한 시간 내에 수행되도록 SDK의 재시도 설정을 변경합니다.
  • 일시적으로 Lambda 함수 제한 시간 설정을 늘려 SDK 로그 생성에 충분한 시간을 허용합니다.

AWS SDK 설정 변경

AWS SDK의 재시도 횟수 및 제한 시간 설정에서 API 호출이 응답을 받는 데 충분한 시간을 허용해야 합니다. 각 설정에 대해 적절한 값을 결정하려면 다양한 구성을 테스트하고 다음 정보를 얻어야 합니다.

  • 성공적인 연결을 설정하는 데 걸린 평균 시간
  • 전체 API 요청에 소요된(성공적으로 반환될 때까지) 평균 시간
  • AWS SDK 또는 코드로 재시도를 수행해야 하는지 여부

재시도 횟수 및 제한 시간 설정 변경에 대한 자세한 내용은 다음 AWS SDK 클라이언트 구성 설명서를 참조하세요.

다음은 각 런타임에 대한 재시도 횟수 및 제한 시간 설정을 변경하는 몇 가지 예제 명령입니다.

중요: 다음 명령을 사용하려면 먼저 각 설정의 예제 값을 사용 사례의 해당 값으로 바꿉니다.

재시도 횟수 및 제한 시간 설정을 변경하는 예제 Python(Boto 3) 명령

# max_attempts: retry count / read_timeout: socket timeout / connect_timeout: new connection timeout

from botocore.session import Session
from botocore.config import Config

s = Session()
c = s.create_client('s3', config=Config(connect_timeout=5, read_timeout=60, retries={'max_attempts': 2}))

재시도 횟수 및 제한 시간 설정을 변경하는 예제 JavaScript/Node.js 명령

// maxRetries: retry count / timeout: socket timeout / connectTimeout: new connection timeout

var AWS = require('aws-sdk');

AWS.config.update({

    maxRetries: 2,

    httpOptions: {

        timeout: 30000,

        connectTimeout: 5000

    }

});

재시도 횟수 및 제한 시간 설정을 변경하는 예제 Java 명령

// setMaxErrorRetry(): retry count / setSocketTimeout(): socket timeout / setConnectionTimeout(): new connection timeout

ClientConfiguration clientConfig = new ClientConfiguration(); 

clientConfig.setSocketTimeout(60000); 
clientConfig.setConnectionTimeout(5000);
clientConfig.setMaxErrorRetry(2);

AmazonDynamoDBClient ddb = new AmazonDynamoDBClient(credentialsProvider,clientConfig);

재시도 횟수 및 제한 시간 설정을 변경하는 예제 .NET 명령

// MaxErrorRetry: retry count / ReadWriteTimeout: socket timeout / Timeout: new connection timeout

var client = new AmazonS3Client(

    new AmazonS3Config {
        Timeout = TimeSpan.FromSeconds(5),
        ReadWriteTimeout = TimeSpan.FromSeconds(60),
        MaxErrorRetry = 2
});

재시도 횟수 설정을 변경하는 예제 Go 명령

// Create Session with MaxRetry configuration to be shared by multiple service clients.
sess := session.Must(session.NewSession(&aws.Config{
    MaxRetries: aws.Int(3),
}))
 
// Create S3 service client with a specific Region.
svc := s3.New(sess, &aws.Config{
    Region: aws.String("us-west-2"),
})

요청 제한 시간 설정을 변경하는 예제 Go 명령

ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
defer cancel()
// SQS ReceiveMessage
params := &sqs.ReceiveMessageInput{ ... }
req, resp := s.ReceiveMessageRequest(params)
req.HTTPRequest = req.HTTPRequest.WithContext(ctx)
err := req.Send()

(선택 사항) Lambda 함수의 제한 시간 설정 변경

Lambda 함수 제한 시간 값이 낮으면 정상적인 연결이 조기에 중단될 수 있습니다. 사용 사례에서 이런 상황이 발생하는 경우 함수 제한 시간 설정 설정을 늘려서 API 호출이 응답을 받는 데 충분한 시간을 허용해야 합니다.

다음 공식을 사용하여 함수 제한 시간에 필요한 기본 시간을 계산할 수 있습니다.

First attempt (connection timeout + socket timeout) + Number of retries x (connection timeout + socket timeout) + 20 seconds additional code runtime margin = Required Lambda function timeout

Lambda 함수 제한 시간 계산 예

참고: 다음 계산은 3번의 재시도, 10초의 연결 제한 시간 및 30초의 소켓 제한 시간으로 구성된 AWS SDK에 대한 계산입니다.

First attempt (10 seconds + 30 seconds) + Number of retries [3 * (10 seconds + 30 seconds)] + 20 seconds additional code runtime margin = 180 seconds

이 문서가 도움이 되었나요?


결제 또는 기술 지원이 필요하세요?