기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

재시도 동작

재시도 동작에는 SDK가 AWS 서비스에 보내진 요청으로 인한 장애 복구를 시도하는 방법에 대한 설정이 포함됩니다.

standard 및 adaptive 재시도 모드 중 선택

특별히 adaptive가 더 적합하다고 확신하지 않는 이상, standard 재시도 모드를 사용할 것을 권장합니다.

adaptive 모드를 사용하기로 선택한 경우, 애플리케이션은 스로틀링이 발생할 수 있는 각 리소스별로 클라이언트를 구성해야 합니다. 이 경우 리소스는 단순히 각 AWS 서비스 단위로만 생각하는 것보다 더 세분화된 개념입니다. AWS 서비스는 요청을 스로틀링하기 위해 추가적인 차원을 사용할 수 있습니다. Amazon DynamoDB 서비스를 예로 들어 보겠습니다. DynamoDB는 AWS 리전 및 액세스 중인 테이블을 사용하여 요청을 스로틀링합니다. 이는 코드에서 액세스하는 테이블 중 하나가 다른 테이블보다 더 많이 스로틀링될 수 있다는 뜻입니다. 코드에서 모든 테이블에 동일한 클라이언트를 사용하고 있고, 그중 하나의 테이블이 스로틀링되면, 적응형 재시도 모드는 모든 테이블에 대한 요청 속도를 낮추게 됩니다. 코드는 리전과 테이블의 각 조합마다 하나의 클라이언트를 사용하도록 설계해야 합니다. adaptive 모드를 사용할 때 예상치 못한 지연이 발생한다면, 사용 중인 서비스의 AWS 문서 안내서를 참고하세요.

재시도 모드 구현 세부 정보

AWS SDK는 토큰 버킷을 사용하여 요청을 재시도해야 하는지 여부와 요청을 얼마나 빠르게 전송해야 하는지(adaptive 재시도 모드의 경우)를 결정합니다. SDK는 재시도 토큰 버킷과 요청 속도 토큰 버킷이라는 두 개의 토큰 버킷을 사용합니다.

다음은 standard 모드와 adaptive 모드 모두에 대한 고급 의사코드입니다.

MakeSDKRequest() {
  attempts = 0
  loop {
    GetSendToken()
    response = SendHTTPRequest()
    RequestBookkeeping(response)
    if not Retryable(response)
      return response
    attempts += 1
    if attempts >= MAX_ATTEMPTS:
      return response
    if not HasRetryQuota(response)
      return response
    delay = ExponentialBackoff(attempts)
    sleep(delay)
  }
}

다음은 의사코드에 사용되는 구성 요소에 대한 자세한 내용입니다.

GetSendToken:

이 단계는 adaptive 재시도 모드에서만 사용됩니다. 이 단계에서는 요청 속도 토큰 버킷에서 토큰을 가져옵니다. 토큰을 사용할 수 없는 경우 토큰을 사용할 수 있을 때까지 기다립니다. SDK에는 대기 대신 요청을 즉시 실패하도록 설정할 수 있는 구성 옵션이 제공될 수도 있습니다. 버킷의 토큰은 클라이언트가 받은 스로틀링 응답 수에 따라 동적으로 결정되는 속도로 다시 채워집니다.

SendHTTPRequest:

이 단계에서는 AWS로 요청을 보냅니다. 대부분의 AWS SDK는 HTTP 요청을 보낼 때 기존 연결을 재사용하기 위해 연결 풀을 사용하는 HTTP 라이브러리를 사용합니다. 일반적으로 요청이 스로틀링 오류로 인해 실패한 경우에는 연결이 재사용되지만, 일시적 오류로 인해 실패한 경우에는 연결이 재사용되지 않습니다.

RequestBookkeeping:

요청이 성공하면 토큰이 토큰 버킷에 추가됩니다. adaptive 재시도 모드에서만, 요청 속도 토큰 버킷의 충전 속도는 수신한 응답 유형에 따라 업데이트됩니다.

Retryable:

이 단계에서는 다음을 기반으로 응답을 재시도할 수 있는지 여부를 결정합니다.

일시적 오류(HTTP 상태 코드 400, 408, 500, 502, 503, 504)와 조절 오류(HTTP 상태 코드 400, 403, 429, 502, 503, 509)는 모두 재시도될 수 있습니다. SDK 재시도 동작은 서비스의 오류 코드 또는 서비스의 기타 데이터와 조합하여 결정됩니다.

MAX_ATTEMPTS:

기본 최대 시도 횟수는 max_attempts 설정으로 재정의되지 않는 한 retry_mode 설정에 의해 결정됩니다.

HasRetryQuota

이 단계에서는 재시도 토큰 버킷에서 토큰을 가져옵니다. 재시도 토큰 버킷이 비어 있으면 요청이 재시도되지 않습니다.

ExponentialBackoff

재시도할 수 있는 오류의 경우 잘린 지수 백오프를 사용하여 재시도 지연을 계산합니다. SDK는 지터가 있는 잘린 이진 지수 백오프를 사용합니다. 다음 알고리즘은 요청에 대한 응답의 절전 시간(초)이 어떻게 정의되는지 보여줍니다. i

seconds_to_sleep_i = min(b*r^i, MAX_BACKOFF)

위 알고리즘에는 다음 값이 적용됩니다.

b = random number within the range of: 0 <= b <= 1

r = 2

대부분의 SDK용 MAX_BACKOFF = 20 seconds. 사용자 특정 SDK 가이드 또는 소스 코드를 참조하여 확인합니다.

AWS SDK 및 도구 지원

다음 SDK는 이 주제에서 설명하는 기능 및 설정을 지원합니다. 모든 일부 예외가 기록됩니다. 모든 JVM 시스템 속성 설정은 AWS SDK for Java 및 AWS SDK for Kotlin에서만 지원됩니다.