Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Diagnostic des problèmes de limitation

Lorsque votre application est confrontée à une limitation, DynamoDB fournit des informations détaillées sur les exceptions correspondantes et des métriques CloudWatch ciblées pour vous aider à diagnostiquer ces événements.

Cette section présente une approche systématique pour comprendre les événements de limitation dans vos applications DynamoDB. Elle explique comment interpréter les exceptions de limitation, comment les mettre en corrélation avec les métriques CloudWatch afin d’obtenir des informations plus approfondies et comment déterminer les modifications susceptibles de réduire la limitation dans vos applications DynamoDB.

Comprendre les exceptions de limitation

Lorsque DynamoDB limite une demande, il renvoie des exceptions spécifiques avec des informations de diagnostic détaillées. Parmi ces exceptions, citons notamment ProvisionedThroughputExceededException, RequestLimitExceeded ou ThrottlingException, en Java.

Chaque exception inclut un attribut ThrottlingReasons, qui rassemble des éléments ThrottlingReason individuels contenant deux champs clés pour vous aider à identifier et à comprendre la limitation :

Le champ Raison respecte un schéma cohérent qui vous permet de comprendre exactement ce qui se passe :

L’ARN de la ressource identifie précisément la table ou l’index qui est limité :

Exemples de raisons complètes de limitation :

Cela permet d’identifier exactement quelle ressource est limitée, quel type d’opération en est la cause et pourquoi cette limitation a eu lieu.

Exemples d’exception

Exemple 1 : dépassement de la capacité provisionnée sur un 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
        }
    }
}

Dans cet exemple, l’application reçoit une exception ProvisionedThroughputExceededException avec la raison IndexWriteProvisionedThroughputExceeded. Les écritures dans l’index OrderDateIndex sont limitées, car la consommation en écriture a dépassé la capacité d’écriture provisionnée configurée pour ce GSI.

Exemple 2 : dépassement du débit maximal à la demande

{
    "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
        }
    }
}

Dans cet exemple, les lectures de la table UserSessions sont limitées, car elles dépassent la limite de débit maximale à la demande configurée pour cette table.

Cadre de diagnostic des limitations DynamoDB

Lorsque votre application est confrontée à une limitation, procédez comme suit pour diagnostiquer et résoudre le problème.

Étape 1 : analyser les détails du champ ThrottlingReason

Étape 2 : identifier et analyser les métriques CloudWatch associées

Étape 3 : identifier les clés limitées et les taux d’accès élevés à l’aide de CloudWatch Contributor Insights (pour la limitation liée aux partitions)

Si vous avez identifié des problèmes liés aux partitions à l’étape 1 (tels que des erreurs KeyRangeThroughputExceeded), CloudWatch Contributor Insights pour DynamoDB peut vous aider à identifier les clés spécifiques qui génèrent votre trafic et qui sont confrontées à des événements de limitation dans votre table ou votre index.

Pour obtenir des informations détaillées sur l’activation et l’utilisation de CloudWatch Contributor Insights, consultez Using CloudWatch Contributor Insights for DynamoDB.

Étape 4 : déterminer la solution appropriée

Après avoir diagnostiqué la cause spécifique de la limitation, mettez en œuvre la solution recommandée en fonction de votre contexte spécifique. La solution appropriée dépend de plusieurs facteurs, notamment de votre scénario de limitation, du mode de capacité de la table, des décisions de conception de la table et des clés, de l’efficacité des requêtes et des modèles d’accès, de la configuration des index globaux et secondaires, ainsi que de l’architecture globale du système et des points d’intégration.

Pour obtenir des solutions détaillées répondant à vos scénarios de limitation spécifiques, consultez la section Guide de résolution des problèmes de limitation de DynamoDB. Cette ressource fournit des stratégies de correction ciblées adaptées à la raison particulière de la limitation et à la configuration du mode de capacité.

Étape 5 : suivre vos progrès