스로틀링 진단

애플리케이션에서 스로틀링이 발생할 경우 DynamoDB는 이러한 이벤트를 진단하는 데 도움이 되는 상세한 예외 정보와 대상 CloudWatch 지표들을 제공합니다.

이 섹션에서는 DynamoDB 애플리케이션의 스로틀링 이벤트를 이해하기 위한 체계적인 접근 방식을 제시합니다. 스로틀링 예외를 해석하는 방법, 더 깊은 인사이트를 위해 CloudWatch 지표와 연관 짓는 방법, DynamoDB 애플리케이션에서 스로틀링을 줄일 수 있는 변경 사항을 이해하는 방법을 보여 줍니다.

스로틀링 예외 이해

DynamoDB가 요청을 스로틀할 때, 상세한 진단 정보가 포함된 특정 예외를 반환합니다. 예를 들어, Java에서는 ProvisionedThroughputExceededException, RequestLimitExceeded, ThrottlingException 등이 포함됩니다.

각 예외에는 ThrottlingReasons가 포함되며, 이는 개별 ThrottlingReason의 모음으로 두 가지 주요 필드를 통해 스로틀링을 식별하고 이해하는 데 도움을 줍니다.

사유 필드는 일관된 패턴을 따르며, 정확히 무슨 일이 발생하는지 이해하는 데 도움이 됩니다.

리소스 ARN은 정확히 어떤 테이블 또는 인덱스가 스로틀된 상태인지 식별합니다.

전체 스로틀링 사유 예제:

이를 통해 정확히 어떤 리소스가 스로틀링되고 있는지, 어떤 유형의 작업이 이를 유발했는지, 스로틀링이 발생한 사유를 식별하는 데 도움이 됩니다.

예제 예외

예제 1: GSI에서 프로비저닝된 용량 초과

{
    "ThrottlingReasons": [
        {
            "reason": "IndexWriteProvisionedThroughputExceeded",
            "resource": "arn:aws:dynamodb:us-west-2:123456789012:table/CustomerOrders/index/OrderDateIndex"
        }
    ],
    "awsErrorDetails": {
        "errorCode": "ProvisionedThroughputExceeded",
        "errorMessage": "The level of configured provisioned throughput for the index was exceeded",
        "serviceName": "DynamoDB",
        "sdkHttpResponse": {
            "statusText": "Bad Request",
            "statusCode": 400
        }
    }
}

이 예제에서는 애플리케이션이 ProvisionedThroughputExceededException 사유로 IndexWriteProvisionedThroughputExceeded을 수신합니다. OrderDateIndex에 대한 쓰기 작업이 스로틀되고 있는데, 이는 쓰기 소비량이 GSI에 구성된 프로비저닝된 쓰기 용량을 초과했기 때문입니다.

예제 2: 온디맨드 최대 처리량 초과

{
    "ThrottlingReasons": [
        {
            "reason": "TableReadMaxOnDemandThroughputExceeded",
            "resource": "arn:aws:dynamodb:us-east-1:123456789012:table/UserSessions"
        }
    ],
    "awsErrorDetails": {
        "errorMessage": "Throughput exceeds the maximum OnDemandThroughput configured on table or index",
        "errorCode": "ThrottlingException",
        "serviceName": "DynamoDB",
        "sdkHttpResponse": {
            "statusText": "Bad Request",
            "statusCode": 400
        }
    }
}

이 예제에서는 UserSessions 테이블에 대한 읽기 작업이 테이블에 구성된 최대 온디맨드 처리량 한도를 초과하여 스로틀되고 있습니다.

DynamoDB 스로틀링 진단 프레임워크

애플리케이션에서 스로틀링이 발생하면 다음 단계를 따라 문제를 진단하고 해결합니다.

1단계 - ThrottlingReason 세부 정보 분석

2단계 - 관련 CloudWatch 지표 식별 및 분석

3단계 - CloudWatch Contributor Insights를 사용하여 스로틀된 키 및 높은 액세스 비율 확인(파티션 관련 스로틀링의 경우)

1단계에서 파티션 관련 문제(예: KeyRangeThroughputExceeded 오류)를 확인한 경우, CloudWatch Contributor Insights for DynamoDB를 통해 테이블 또는 인덱스에서 트래픽을 유발하고 스로틀링 이벤트가 발생하는 특정 키를 진단할 수 있습니다.

CloudWatch Contributor Insights 활성화 및 사용에 대한 자세한 내용은 CloudWatch Contributor Insights for DynamoDB를 참조하세요.

4단계 - 적절한 솔루션 결정

스로틀링의 구체적인 원인을 진단한 후, 특정 상황에 기반하여 권장 솔루션을 구현합니다. 적절한 솔루션은 스로틀링 시나리오, 테이블의 용량 모드, 테이블 및 키 설계 결정, 액세스 패턴과 쿼리 효율성, 글로벌 및 보조 인덱스 구성, 전체 시스템 아키텍처 및 통합 지점 등 여러 요소에 따라 달라집니다.

특정 스로틀링 시나리오에 대한 자세한 해결 방법은 DynamoDB 스로틀링 해결 가이드 섹션을 참조하세요. 이 리소스는 특정 스로틀링 사유와 용량 모드 구성에 사용자 지정된 표적 개선 전략을 제공합니다.

5단계 - 진행 상황 모니터링