재시도

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

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

는 기본 재시도 동작과 사용자 지정 가능한 구성 옵션을 AWS SDK for Rust 제공합니다. 예기치 않은 예외를 AWS 서비스 가끔 반환하도록를 호출합니다. 통화를 재시도하면 제한 또는 일시적인 오류와 같은 특정 유형의 오류가 성공할 수 있습니다.

공유 AWS config 파일의 환경 변수 또는 설정을 사용하여 전역적으로 재시도 동작을 구성할 수 있습니다. 이 접근 방식에 대한 자세한 내용은 SDK 및 도구 참조 안내서의 재시도 동작을 참조하세요. AWS SDKs 또한 재시도 전략 구현에 대한 자세한 정보와 하나를 선택하는 방법도 포함되어 있습니다.

또는 다음 섹션과 같이 코드에서 이러한 옵션을 구성할 수도 있습니다.

기본 재시도 구성

모든 서비스 클라이언트는 기본적으로 RetryConfig 구조를 통해 제공된 standard 재시도 전략 구성으로 설정됩니다. 기본적으로 호출은 세 번 시도됩니다(초기 시도와 두 번의 재시도). 또한 재시도 폭풍을 방지하기 위해 각 재시도가 짧은 무작위 기간만큼 지연됩니다. 이 규칙은 대부분의 사용 사례에 적합하지만 처리량이 많은 시스템과 같은 특정 상황에서는 적합하지 않을 수 있습니다.

일부 유형의 오류만 SDKs에서 재시도 가능한 것으로 간주됩니다. 재시도 가능한 오류의 예는 다음과 같습니다.

다음 예제는 재시도 가능한 것으로 간주되지 않습니다.

최대 시도 횟수, 지연 시간 및 백오프 구성을 설정하여 standard 재시도 전략을 사용자 지정할 수 있습니다.

최대 시도 횟수

에 수정된를 제공하여 코드의 최대 시도 RetryConfig 횟수를 사용자 지정할 수 있습니다aws_config::defaults.

const CUSTOM_MAX_ATTEMPTS: u32 = 5;
let retry_config = RetryConfig::standard()
    // Set max attempts. When max_attempts is 1, there are no retries.
    // This value MUST be greater than zero.
    // Defaults to 3.
    .with_max_attempts(CUSTOM_MAX_ATTEMPTS);
  
let config = aws_config::defaults(BehaviorVersion::latest())
    .retry_config(retry_config)
    .load()
    .await;

지연 및 백오프

재시도가 필요한 경우 기본 재시도 전략은 후속 시도를 수행하기 전에 대기합니다. 첫 번째 재시도의 지연 시간은 작지만 이후 재시도에서는 기하급수적으로 증가합니다. 최대 지연 시간은 너무 크게 증가하지 않도록 제한됩니다.

무작위 지터는 모든 시도 사이의 지연에 적용됩니다. 지터는 재시도 폭풍을 일으킬 수 있는 대규모 플릿의 영향을 완화하는 데 도움이 됩니다. 지수 백오프 및 지터에 대한 자세한 내용은 AWS 아키텍처 블로그의 지수 백오프 및 지터를 참조하세요.

에 수정된를 제공하여 코드의 지연 설정을 사용자 지정할 수 RetryConfig 있습니다aws_config::defaults. 다음 코드는 구성을 설정하여 최대 100밀리초 동안 첫 번째 재시도를 지연하고 재시도 사이의 최대 시간은 5초입니다.

let retry_config = RetryConfig::standard()
    // Defaults to 1 second.
    .with_initial_backoff(Duration::from_millis(100))
    // Defaults to 20 seconds.
    .with_max_backoff(Duration::from_secs(5));
  
let config = aws_config::defaults(BehaviorVersion::latest())
    .retry_config(retry_config)
    .load() 
    .await;

적응형 재시도 모드

standard 모드 재시도 전략의 대안으로 adaptive 모드 재시도 전략은 제한 오류를 최소화하기 위한 이상적인 요청 속도를 찾는 고급 접근 방식입니다.

적응형 재시도에는 표준 재시도의 모든 기능이 포함됩니다. 제한되지 않은 요청과 비교하여 제한되는 요청의 속도를 측정하는 클라이언트 측 속도 제한기를 추가합니다. 또한 트래픽을 제한하여 안전한 대역폭 내에 유지하려고 시도하므로 제한 오류가 발생하지 않는 것이 이상적입니다.

속도는 변화하는 서비스 조건 및 트래픽 패턴에 실시간으로 적응하며 그에 따라 트래픽 속도를 높이거나 낮출 수 있습니다. 매우 심각하게, 속도 제한기는 트래픽이 많은 시나리오에서 초기 시도를 지연시킬 수 있습니다.

수정된를 제공하여 코드에서 adaptive 재시도 전략을 선택할 수 있습니다RetryConfig.

let config = aws_config::defaults(BehaviorVersion::latest())
    .retry_config(RetryConfig::adaptive())
    .load()
    .await;