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 à un ralentissement, DynamoDB fournit des informations détaillées sur les exceptions et des CloudWatch mesures 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. Il montre comment interpréter les exceptions de limitation, les corréler avec des CloudWatch mesures pour obtenir des informations plus détaillées et comprendre 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ébit On-demand maximal dépassé

{
    "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 - Identifiez et analysez les CloudWatch métriques associées

Étape 3 - Identifiez vos clés bloquées et vos 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 à la partition à l'étape 1 (tels que KeyRangeThroughputExceeded des erreurs), CloudWatch Contributor Insights for DynamoDB peut vous aider à diagnostiquer quelles clés spécifiques génèrent votre trafic et rencontrent des événements de limitation dans votre table ou votre index.

Pour plus d'informations sur l'activation et l'utilisation de CloudWatch Contributor Insights, voir Utilisation de CloudWatch Contributor Insights pour 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