スロットリングの診断

アプリケーションでスロットリングが発生すると、DynamoDB はこれらのイベントの診断に役立つ詳細な例外情報とターゲットを絞った CloudWatch メトリクスを提供します。

このセクションでは、DynamoDB アプリケーションのスロットリングイベントを理解するための体系的なアプローチを示します。スロットリング例外を解釈し、CloudWatch メトリクスと関連付けてより深いインサイトを得る方法、DynamoDB アプリケーションのスロットリングを減らす変更を理解する方法を示します。

スロットリングの例外について

DynamoDB がリクエストを調整すると、詳細な診断情報を含む特定の例外が返されます。例えば、Java では、これらには ProvisionedThroughputExceededException、RequestLimitExceeded、または ThrottlingException が含まれます。

各例外には、スロットリングを識別して理解するのに役立つ 2 つのキーフィールドを含む個々の ThrottlingReason のコレクションである ThrottlingReasons が含まれます。

理由フィールドは、何が起こっているのかを正確に理解するのに役立つ一貫したパターンに従います。

リソース 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 - 進捗状況をモニタリングする