Métriques et dimensions DynamoDB

Lorsque vous interagissez avec DynamoDB, celui-ci envoie des métriques et des dimensions à. CloudWatch

Affichage des métriques et dimensions

CloudWatch affiche les mesures suivantes pour DynamoDB :

Métriques DynamoDB

Note

Amazon CloudWatch agrège ces statistiques à intervalles d'une minute :

• ConditionalCheckFailedRequests

• ConsumedReadCapacityUnits

• ConsumedWriteCapacityUnits

• ReadThrottleEvents

• ReturnedBytes

• ReturnedItemCount

• ReturnedRecordsCount

• SuccessfulRequestLatency

• SystemErrors

• TimeToLiveDeletedItemCount

• ThrottledRequests

• TransactionConflict

• UserErrors

• WriteThrottleEvents

Pour toutes les autres métriques de DynamoDB, la granularité d'agrégation est de cinq minutes.

Certaines statistiques, telles que Moyenne ou Somme, s'appliquent à chaque métrique. Cependant, toutes ces valeurs sont disponibles via la console Amazon DynamoDB, ou à l'aide de CloudWatch la console AWS CLI ou de kits SDK pour toutes les AWS métriques.

Dans la liste suivante, chaque métrique dispose d'un ensemble de statistiques valides qui s'appliquent à cette métrique.

AccountMaxLis

Nombre maximum d'unités de capacité de lecture qu'un compte peut utiliser. Cette limite ne s'applique pas aux tables à la demande ni aux index secondaires globaux.

Unités Count:

Statistiques valides :

• Maximum – Nombre maximum d'unités de capacité de lecture qu'un compte peut utiliser.

AccountMaxTableLevelLis

Nombre maximum d'unités de capacité de lecture qu'une table ou un index secondaire global d'un compte peuvent utiliser. Pour les tables à la demande, cette limite limite le nombre maximal d'unités de demande de lecture qu'une table ou un index secondaire global peut utiliser.

Unités Count:

Statistiques valides :

• Maximum – Nombre maximum d'unités de capacité de lecture qu'une table ou un index secondaire global du compte peuvent utiliser.

AccountMaxTableLevelécrit

Nombre maximum d'unités de capacité d'écriture qu'une table ou un index secondaire global d'un compte peuvent utiliser. Pour les tables à la demande, cette limite limite le nombre maximal d'unités de demande d'écriture qu'une table ou un index secondaire global peuvent utiliser.

Unités Count:

Statistiques valides :

• Maximum – Nombre maximum d'unités de capacité d'écriture qu'une table ou un index secondaire global du compte peuvent utiliser.

AccountMaxécrit

Nombre maximum d'unités de capacité d'écriture qu'un compte peut utiliser. Cette limite ne s'applique pas aux tables à la demande ni aux index secondaires globaux.

Unités Count:

Statistiques valides :

• Maximum – Nombre maximum d'unités de capacité d'écriture qu'un compte peut utiliser.

AccountProvisionedReadCapacityUtilisation

Pourcentage d'unités de capacité de lecture approvisionnée qu'un compte utilise.

Unités : Percent

Statistiques valides :

• Maximum – Pourcentage maximum d'unités de capacité de lecture approvisionnée que le compte utilise.

• Minimum – Pourcentage minimum d'unités de capacité de lecture approvisionnée que le compte utilise.

• Average – Pourcentage moyen d'unités de capacité de lecture approvisionnée que le compte utilise. La métrique est publiée à intervalles de cinq minutes. Par conséquent, si vous ajustez rapidement les unités de capacité de lecture approvisionnée, il se peut que cette statistique ne reflète pas la moyenne réelle.

AccountProvisionedWriteCapacityUtilisation

Pourcentage d'unités de capacité d'écriture approvisionnée qu'un compte utilise.

Unités : Percent

Statistiques valides :

• Maximum – Pourcentage maximum d'unités de capacité d'écriture approvisionnée que le compte utilise.

• Minimum – Pourcentage minimum d'unités de capacité d'écriture approvisionnée que le compte utilise.

• Average – Pourcentage moyen d'unités de capacité d'écriture approvisionnée que le compte utilise. La métrique est publiée à intervalles de cinq minutes. Par conséquent, si vous ajustez rapidement les unités de capacité d'écriture approvisionnée, il se peut que cette statistique ne reflète pas la moyenne réelle.

AgeOfOldestUnreplicatedEnregistrer

Temps écoulé depuis qu'un registre devant encore être répliqué vers le flux de données Kinesis est apparu pour la première fois dans la table DynamoDB.

Unités : Milliseconds

Dimensions : TableName, DelegatedOperation

Statistiques valides :

• Maximum.

• Minimum.

• Average.

ConditionalCheckFailedRequests

Nombre de tentatives infructueuses d'exécution d'écritures conditionnelles. Les opérations PutItem, UpdateItem et DeleteItem vous permettent de fournir une condition logique dont l'évaluation doit être true avant que l'opération puisse continuer. Si l'évaluation de cette condition est false, ConditionalCheckFailedRequests est incrémenté d'une unité. ConditionalCheckFailedRequests est également incrémenté d'une unité pour les instructions PartiQL Update et Delete qui incluent une condition logique dont l'évaluation est false.

Note

Un échec d'écriture conditionnelle entraîne une erreur HTTP 400 (Demande incorrecte). Ces événements sont reflétés dans la métrique ConditionalCheckFailedRequests, mais pas dans la métrique UserErrors.

Unités : Count

Dimensions : TableName

Statistiques valides :

• Minimum

• Maximum

• Average

• SampleCount

• Sum

ConsumedChangeDataCaptureUnités

Nombre d'unités de récupération de données de modification consommées.

Unités : Count

Dimensions : TableName, DelegatedOperation

Statistiques valides :

• Minimum

• Maximum

• Average

ConsumedReadCapacityUnits

Nombre d'unités de capacité de lecture consommées sur la période spécifiée pour la capacité à la demande et provisionnée, de sorte que vous puissiez suivre la quantité de votre débit utilisée. Vous pouvez extraire la capacité totale de lecture consommée pour une table et tous ses index secondaires globaux, ou pour un index secondaire global particulier. Pour de plus amples informations, veuillez consulter Mode de capacité en lecture/écriture.

La dimension TableName renvoie la valeur ConsumedReadCapacityUnits pour la table, mais pas pour les index secondaires globaux. Pour afficher la valeur ConsumedReadCapacityUnits pour un index secondaire global, vous devez spécifier TableName et GlobalSecondaryIndexName.

Note

Dans Amazon DynamoDB, la métrique de capacité consommée est signalée CloudWatch à intervalles d'une minute sous forme de valeur moyenne. Cela signifie que les pics courts et intenses de consommation de capacité d'une seconde seulement peuvent ne pas être reflétés avec précision dans le CloudWatch graphique, ce qui peut entraîner une baisse du taux de consommation apparent pendant cette minute.

Utilisez la statistique Sum pour calculer le débit consommé. Par exemple, obtenez la valeur Sum sur une durée d'une minute, puis divisez-la par le nombre de secondes dans une minute (60) afin de calculer la valeur moyenne de ConsumedReadCapacityUnits par seconde. Vous pouvez comparer la valeur calculée à la valeur de débit approvisionné que vous fournissez à DynamoDB.

Unités : Count

Dimensions : TableName, GlobalSecondaryIndexName

Statistiques valides :

• Minimum – Nombre minimum d'unités de capacité de lecture consommées par une demande adressée à la table ou à l'index.

• Maximum – Nombre maximum d'unités de capacité de lecture consommées par une demande adressée à la table ou à l'index.

• Average – Capacité de lecture moyenne par demande consommée.

  Note

  La valeur Average est influencée par des périodes d'inactivité où la valeur de l'échantillon est nulle.

• Sum – Nombre total d'unités de capacité de lecture consommées. Il s'agit de la statistique la plus utile pour la métrique ConsumedReadCapacityUnits.

• SampleCount— Le nombre de demandes de lecture adressées à DynamoDB. Renvoie 0 si aucune capacité de lecture n'a été consommée.

  Note

  La valeur SampleCount est influencée par des périodes d'inactivité où la valeur de l'échantillon est nulle.

ConsumedWriteCapacityUnits

Nombre d'unités de capacité d’écriture consommées sur la période spécifiée pour la capacité à la demande et provisionnée, de sorte que vous puissiez suivre la quantité de votre débit utilisée. Vous pouvez extraire la capacité totale d'écriture consommée pour une table et tous ses index secondaires globaux, ou pour un index secondaire global particulier. Pour de plus amples informations, veuillez consulter Mode de capacité en lecture/écriture.

La dimension TableName renvoie la valeur ConsumedWriteCapacityUnits pour la table, mais pas pour les index secondaires globaux. Pour afficher la valeur ConsumedWriteCapacityUnits pour un index secondaire global, vous devez spécifier TableName et GlobalSecondaryIndexName.

Note

Utilisez la statistique Sum pour calculer le débit consommé. Par exemple, obtenez la Sum valeur sur une période d'une minute et divisez-la par le nombre de secondes par minute (60) pour calculer la moyenne ConsumedWriteCapacityUnits par seconde (en reconnaissant que cette moyenne ne met pas en évidence les pics importants mais brefs d'activité d'écriture survenus pendant cette minute). Vous pouvez comparer la valeur calculée à la valeur de débit approvisionné que vous fournissez à DynamoDB.

Unités : Count

Dimensions : TableName, GlobalSecondaryIndexName

Statistiques valides :

• Minimum – Nombre minimum d'unités de capacité d'écriture consommées par une demande adressée à la table ou à l'index.

• Maximum – Nombre maximum d'unités de capacité d'écriture consommées par une demande adressée à la table ou à l'index.

• Average – Capacité d'écriture moyenne par demande consommée.

  Note

  La valeur Average est influencée par des périodes d'inactivité où la valeur de l'échantillon est nulle.

• Sum – Nombre total d'unités de capacité d'écriture consommées. Il s'agit de la statistique la plus utile pour la métrique ConsumedWriteCapacityUnits.

• SampleCount – Nombre de demandes d'écriture adressées à DynamoDB, même si aucune capacité d'écriture n'a été consommée.

  Note

  La valeur SampleCount est influencée par des périodes d'inactivité où la valeur de l'échantillon est nulle.

FailedToReplicateRecordCompter

Nombre de registres que DynamoDB n'a pas pu répliquer sur votre flux de données Kinesis.

Unités : Count

Dimensions: TableName, DelegatedOperation

Statistiques valides :

• Sum

MaxProvisionedTableReadCapacityUtilization

Pourcentage de capacité de lecture allouée qu'utilisent la table de lecture ou l'index secondaire global les plus alloués d'un compte.

Unités Percent:

Statistiques valides :

• Maximum – Le pourcentage maximum d'unités de capacité de lecture allouée qu'utilisent la table de lecture ou l'index secondaire global les plus alloués d'un compte.

• Minimum – Le pourcentage minimum d'unités de capacité de lecture allouée qu'utilisent la table de lecture ou l'index secondaire global les plus alloués d'un compte.

• Average – Le pourcentage moyen d'unités de capacité de lecture allouée qu'utilisent la table de lecture ou l'index secondaire global les plus alloués du compte. La métrique est publiée à intervalles de cinq minutes. Par conséquent, si vous ajustez rapidement les unités de capacité de lecture approvisionnée, il se peut que cette statistique ne reflète pas la moyenne réelle.

MaxProvisionedTableWriteCapacityUtilization

Pourcentage de capacité d'écriture approvisionnée qu'utilisent la table d'écriture ou l'index secondaire global les plus approvisionnés d'un compte.

Unités : Percent

Statistiques valides :

• Maximum – Pourcentage maximum d'unités de capacité d'écriture approvisionnée qu'utilise la table d'écriture ou l'index secondaire global les plus approvisionnés d'un compte.

• Minimum – Pourcentage minimum d'unités de capacité d'écriture approvisionnée qu'utilise la table d'écriture ou l'index secondaire global les plus approvisionnés d'un compte.

• Average – Pourcentage moyen d'unités de capacité d'écriture approvisionnée qu'utilise la table d'écriture ou l'index secondaire global les plus approvisionnés du compte. La métrique est publiée à intervalles de cinq minutes. Par conséquent, si vous ajustez rapidement les unités de capacité d'écriture approvisionnée, il se peut que cette statistique ne reflète pas la moyenne réelle.

OnDemandMaxReadRequestUnits

Le nombre d'unités de demande de lecture à la demande spécifiées pour une table ou un index secondaire global.

OnDemandMaxReadRequestUnitsPour afficher une table, vous devez spécifierTableName. Pour afficher la valeur OnDemandMaxReadRequestUnits pour un index secondaire global, vous devez spécifier TableName et GlobalSecondaryIndexName.

Unités : nombre

Dimensions: TableName, GlobalSecondaryIndexName

Statistiques valides :

• Minimum— Le paramètre le plus bas pour les unités de demande de lecture à la demande. Si vous augmentez UpdateTable les unités de demande de lecture, cette métrique indique la valeur la plus faible de la demande ReadRequestUnits au cours de cette période.

• Maximum— Le paramètre le plus élevé pour les unités de demande de lecture à la demande. Si vous utilisez UpdateTable pour diminuer les unités de demande de lecture, cette métrique indique la valeur la plus élevée de la demande ReadRequestUnits au cours de cette période.

• Average— Nombre moyen d'unités de demande de lecture à la demande. La métrique OnDemandMaxReadRequestUnits est publiée à intervalles de cinq minutes. Par conséquent, si vous ajustez rapidement les unités de demande de lecture à la demande, cette statistique risque de ne pas refléter la vraie moyenne.

OnDemandMaxWriteRequestUnits

Le nombre d'unités de demande d'écriture à la demande spécifiées pour une table ou un index secondaire global.

OnDemandMaxWriteRequestUnitsPour afficher une table, vous devez spécifierTableName. Pour afficher la valeur OnDemandMaxWriteRequestUnits pour un index secondaire global, vous devez spécifier TableName et GlobalSecondaryIndexName.

Unités : Count

Dimensions: TableName, GlobalSecondaryIndexName

Statistiques valides :

• Minimum— Le paramètre le plus bas pour les unités de demande d'écriture à la demande. Si vous utilisez UpdateTable pour augmenter les unités de demande d'écriture, cette métrique indique la valeur la plus faible de la demande WriteRequestUnits au cours de cette période.

• Maximum— Le paramètre le plus élevé pour les unités de demande d'écriture à la demande. Si vous utilisez UpdateTable pour diminuer les unités de demande d'écriture, cette métrique indique la valeur la plus élevée de la demande WriteRequestUnits au cours de cette période.

• Average— Nombre moyen d'unités de demande d'écriture à la demande. La métrique OnDemandMaxWriteRequestUnits est publiée à intervalles de cinq minutes. Par conséquent, si vous ajustez rapidement les unités de demande d'écriture à la demande, cette statistique risque de ne pas refléter la vraie moyenne.

OnlineIndexConsumedWriteCapacité

Nombre d'unités de capacité d'écriture consommées lors de l'ajout d'un nouvel index secondaire global à une table. Si la capacité d'écriture de l'index est trop faible, l'activité d'écriture entrante pendant la phase de remplissage peut être limitée. Cela peut augmenter le temps nécessaire pour créer l'index. Vous devez surveiller cette statistique pendant la création de l'index afin de déterminer si la capacité d'écriture de l'index est insuffisamment approvisionnée.

Vous pouvez ajuster la capacité d'écriture de l'index à l'aide de l'opération UpdateTable, même si l'index est encore en cours de génération.

La ConsumedWriteCapacityUnits métrique de l'index n'inclut pas le débit d'écriture consommé lors de la création de l'index.

Note

Cette métrique peut ne pas être émise si la phase de remplissage du nouvel index secondaire global se termine rapidement (en moins de quelques minutes). Cela peut se produire si la table de base ne contient que peu ou pas d'éléments à remplir dans l'index.

Unités : Count

Dimensions : TableName, GlobalSecondaryIndexName

Statistiques valides :

• Minimum

• Maximum

• Average

• SampleCount

• Sum

OnlineIndexPercentageProgress

Pourcentage d'accomplissement lors de l'ajout un nouvel index secondaire global à une table. DynamoDB doit d'abord allouer des ressources pour le nouvel index, puis remplir les attributs de la table dans l'index. Pour les tables de grande taille, ce processus peut prendre beaucoup de temps. Vous devez surveiller cette statistique pour suivre la progression de la génération de l'index par DynamoDB.

Unités : Count

Dimensions : TableName, GlobalSecondaryIndexName

Statistiques valides :

• Minimum

• Maximum

• Average

• SampleCount

• Sum

OnlineIndexThrottleEvents

Nombre d'événements de limitation d'écriture qui se produisent lors de l'ajout d'un nouvel index secondaire global à une table. Ces événements indiquent que la création d'index prendra plus de temps, car l'activité d'écriture entrante dépasse le débit d'écriture approvisionné de l'index.

Vous pouvez ajuster la capacité d'écriture de l'index à l'aide de l'opération UpdateTable, même si l'index est encore en cours de génération.

La WriteThrottleEvents métrique de l'indice n'inclut aucun événement d'accélération qui se produit lors de la création de l'index.

Unités : Count

Dimensions : TableName, GlobalSecondaryIndexName

Statistiques valides :

• Minimum

• Maximum

• Average

• SampleCount

• Sum

PendingReplicationCompter

Métrique pour Tableaux globaux version 2017.11.29 (ancienne version) (tables globales uniquement). Nombre de mises à jour d'éléments écrites dans une table de réplique, mais pas encore écrites dans un autre réplica dans la table globale.

Unités : Count

Dimensions : TableName, ReceivingRegion

Statistiques valides :

• Average

• Sample Count

• Sum

ProvisionedReadCapacityUnits

Nombre d'unités de capacité de lecture approvisionnée pour une table ou un index secondaire global. La dimension TableName renvoie la valeur ProvisionedReadCapacityUnits pour la table, mais pas pour les index secondaires globaux. Pour afficher la valeur ProvisionedReadCapacityUnits pour un index secondaire global, vous devez spécifier TableName et GlobalSecondaryIndexName.

Unités : Count

Dimensions : TableName, GlobalSecondaryIndexName

Statistiques valides :

• Minimum – Paramètre le plus bas pour la capacité de lecture approvisionnée. Si vous utilisez UpdateTable pour augmenter la capacité de lecture, cette métrique indique la valeur ReadCapacityUnits approvisionnée la plus faible pendant cette période.

• Maximum – Paramètre le plus élevé pour la capacité de lecture approvisionnée. Si vous utilisez UpdateTable pour réduire la capacité de lecture, cette métrique indique la valeur ReadCapacityUnits approvisionnée la plus élevée pendant cette période.

• Average – Capacité de lecture approvisionnée moyenne. La métrique ProvisionedReadCapacityUnits est publiée à intervalles de cinq minutes. Par conséquent, si vous ajustez rapidement les unités de capacité de lecture approvisionnée, il se peut que cette statistique ne reflète pas la moyenne réelle.

ProvisionedWriteCapacityUnits

Nombre d'unités de capacité d'écriture approvisionnée pour une table ou un index secondaire global.

La dimension TableName renvoie la valeur ProvisionedWriteCapacityUnits pour la table, mais pas pour les index secondaires globaux. Pour afficher la valeur ProvisionedWriteCapacityUnits pour un index secondaire global, vous devez spécifier TableName et GlobalSecondaryIndexName.

Unités : Count

Dimensions : TableName, GlobalSecondaryIndexName

Statistiques valides :

• Minimum – Paramètre le plus bas pour la capacité d'écriture approvisionnée. Si vous utilisez UpdateTable pour augmenter la capacité d'écriture, cette métrique indique la valeur WriteCapacityUnits approvisionnée la plus faible pendant cette période.

• Maximum – Paramètre le plus élevé pour la capacité d'écriture approvisionnée. Si vous utilisez UpdateTable pour réduire la capacité d'écriture, cette métrique indique la valeur WriteCapacityUnits approvisionnée la plus élevée pendant cette période.

• Average – Capacité d'écriture approvisionnée moyenne. La métrique ProvisionedWriteCapacityUnits est publiée à intervalles de cinq minutes. Par conséquent, si vous ajustez rapidement les unités de capacité d'écriture approvisionnée, il se peut que cette statistique ne reflète pas la moyenne réelle.

ReadThrottleÉvènements

Demandes adressées à DynamoDB qui dépassent le nombre d'unités de capacité de lecture approvisionnée pour une table ou un index secondaire global.

Une seule demande peut entraîner plusieurs événements. Par exemple, une opération BatchGetItem qui lit 10 éléments est traitée comme 10 événements GetItem. Pour chaque événement, ReadThrottleEvents est incrémenté d'une unité si l'événement est limité. La métrique ThrottledRequests pour l'opération BatchGetItem entière n'est incrémentée que si les 10 événements GetItem sont limités.

La dimension TableName renvoie la valeur ReadThrottleEvents pour la table, mais pas pour les index secondaires globaux. Pour afficher la valeur ReadThrottleEvents pour un index secondaire global, vous devez spécifier TableName et GlobalSecondaryIndexName.

Unités : Count

Dimensions : TableName, GlobalSecondaryIndexName

Statistiques valides :

• SampleCount

• Sum

ReplicationLatency

(Cette métrique a trait aux tables globales DynamoDB.) Temps écoulé entre la mise à jour d'un élément apparaissant dans le flux DynamoDB pour une table de réplique, et l'affichage de cet élément dans un autre réplica dans la table globale.

Unités : Milliseconds

Dimensions : TableName, ReceivingRegion

Statistiques valides :

• Average

• Minimum

• Maximum

ReturnedBytes

Nombre d'octets renvoyés par des opérations GetRecords (Amazon DynamoDB Streams) durant la période spécifiée.

Unités : Bytes

Dimensions : Operation, StreamLabel, TableName

Statistiques valides :

• Minimum

• Maximum

• Average

• SampleCount

• Sum

ReturnedItemCompter

Nombre de lignes renvoyées par (certaines) opérations Query, Scan ou ExecuteStatement durant la période spécifiée.

Le nombre d'éléments renvoyés n'est pas nécessairement le même que le nombre d'éléments évalués. Par exemple, supposons que vous ayez demandé une opération Scan sur une table ou un index contenant 100 éléments, mais spécifié une valeur FilterExpression réduisant les résultats de sorte que seuls 15 éléments ont été retournés. Dans ce cas, la réponse de l'opération Scan contient une valeur ScanCount de 100 et une valeur Count de 15 éléments renvoyés.

Unités : Count

Dimensions : TableName, Operation

Statistiques valides :

• Minimum

• Maximum

• Average

• SampleCount

• Sum

ReturnedRecordsCompter

Nombre de registres de flux renvoyés par des opérations GetRecords (Amazon DynamoDB Streams) durant la période spécifiée.

Unités : Count

Dimensions : Operation, StreamLabel, TableName

Statistiques valides :

• Minimum

• Maximum

• Average

• SampleCount

• Sum

SuccessfulRequestLatence

Latence des demandes réussies adressées à DynamoDB ou à Amazon DynamoDB Streams durant la période spécifiée. SuccessfulRequestLatency peut fournir deux types différents d'informations :

• Temps écoulé pour les demandes réussies (Minimum, Maximum, Sum ou Average).

• Nombre de requêtes réussies (SampleCount).

SuccessfulRequestLatencyreflète uniquement l'activité au sein de DynamoDB ou Amazon DynamoDB Streams, et ne prend pas en compte la latence du réseau ni l'activité côté client.

Unités : Milliseconds

Dimensions : TableName, Operation, StreamLabel

Statistiques valides :

• Minimum

• Maximum

• Average

• SampleCount

SystemErrors

Demandes adressées à DynamoDB ou à Amazon DynamoDB Streams qui génèrent un code d'état HTTP 500 durant la période spécifiée. Un état HTTP 500 indique généralement une erreur de service interne.

Unités : Count

Dimensions : TableName, Operation

Statistiques valides :

• Sum

• SampleCount

TimeToLiveDeletedItemCount

Nombre d'éléments supprimés par TTL pendant la période spécifiée. Cette métrique vous aide à surveiller le taux de suppressions par TTL sur votre table.

Unités : Count

Dimensions : TableName

Statistiques valides :

• Sum

ThrottledPutRecordCount

Le nombre de registres qui ont été limités sur votre flux de données Kinesis en raison d'une capacité insuffisante de Kinesis Data Streams.

Unités : Count

Dimensions : TableName, DelegatedOperation

Statistiques valides :

• Minimum

• Maximum

• Average

• SampleCount

ThrottledRequests

Demandes adressées à DynamoDB qui dépassent les limites de débit approvisionnées sur une ressource (telle qu'une table ou un index).

ThrottledRequests est incrémenté d'une unité si un événement au sein d'une demande dépasse une limite de débit approvisionné. Par exemple, si vous mettez à jour un élément dans une table ayant des index secondaires globaux, cela correspond à plusieurs événements : une écriture dans la table et une écriture dans chaque index. Si un ou plusieurs de ces événements sont limités, ThrottledRequests est incrémenté d'une unité.

Note

Dans une demande de lot (BatchGetItem ou BatchWriteItem), ThrottledRequests n'est incrémenté que si chaque demande dans le lot est limitée.

Si une demande dans le lot est limitée, l'une des métriques suivantes est incrémentée :

• ReadThrottleEvents – Pour un événement GetItem limité dans BatchGetItem.

• WriteThrottleEvents – Pour un événement PutItem ou DeleteItem limité dans BatchWriteItem.

Pour obtenir une information sur l'événement qui limite une demande, comparez la valeur ThrottledRequests avec les valeurs ReadThrottleEvents et WriteThrottleEvents pour la table et ses index.

Note

Une demande limitée génère un code d'état HTTP 400. Tous ces événements sont reflétés dans la métrique ThrottledRequests, mais pas dans la métrique UserErrors.

Unités : Count

Dimensions : TableName, Operation

Statistiques valides :

• Sum

• SampleCount

TransactionConflict

Demandes au niveau de l'élément rejetées en raison de conflits transactionnels entre des demandes simultanées sur les mêmes éléments. Pour plus d'informations, consultez Gestion des conflits de transaction dans DynamoDB.

Unités : Count

Dimensions : TableName

Statistiques valides :

• Sum – Nombre de demandes au niveau de l'élément rejetées en raison de conflits de transactions.

  Note

  Si plusieurs demandes au niveau de l'élément dans un appel à TransactWriteItems ou à TransactGetItems ont été rejetées, la valeur Sum est incrémentée d'une unité pour chaque demande Put, Update, Delete ou Get au niveau de l'élément.

• SampleCount – Nombre de demandes rejetées en raison de conflits de transactions.

  Note

  Si plusieurs demandes au niveau de l'élément dans un appel à TransactWriteItems ou à TransactGetItems ont été rejetées, la valeur SampleCount n'est incrémentée que d'une unité.

• Min – Nombre minimum de demandes au niveau de l'élément rejetées dans un appel à TransactWriteItems, TransactGetItems, PutItem, UpdateItem ou DeleteItem.

• Max – Nombre maximum de demandes au niveau de l'élément rejetées dans un appel à TransactWriteItems, TransactGetItems, PutItem, UpdateItem ou DeleteItem.

• Average – Nombre moyen de demandes au niveau de l'élément rejetées dans un appel à TransactWriteItems, TransactGetItems, PutItem, UpdateItem ou DeleteItem.

UserErrors

Demandes adressées à DynamoDB ou à Amazon DynamoDB Streams qui génèrent un code d'état HTTP 400 durant la période spécifiée. Une erreur HTTP 400 indique généralement une erreur côté client, comme une combinaison de paramètres non valide, une tentative de mise à jour d'une table inexistante ou une signature de demande incorrecte.

Voici quelques exemples d'exceptions qui enregistrent les métriques liées à UserErrors :

• ResourceNotFoundException

• ValidationException

• TransactionConflict

Tous ces événements sont reflétés dans la métrique UserErrors, à l'exception des événements suivants :

• ProvisionedThroughputExceededException— Voir la ThrottledRequests métrique dans cette section.

• ConditionalCheckFailedException— Voir la ConditionalCheckFailedRequests métrique dans cette section.

UserErrorsreprésente l'ensemble des erreurs HTTP 400 pour les demandes DynamoDB ou Amazon DynamoDB Streams pour la région actuelle et le compte courant. AWS AWS

Unités Count:

Statistiques valides :

• Sum

• SampleCount

WriteThrottleÉvènements

Demandes adressées à DynamoDB qui dépassent le nombre d'unités de capacité d'écriture approvisionnée pour une table ou un index secondaire global.

Une seule demande peut entraîner plusieurs événements. Par exemple, une demande PutItem sur une table avec trois index secondaires globaux entraîne quatre événements : une écriture dans la table et trois écritures dans les index. Pour chaque événement, la métrique WriteThrottleEvents est incrémentée d'une unité si l'événement est limité. Pour les demandes PutItem uniques, si l'un des événements est limité, la valeur ThrottledRequests est également incrémentée d'une unité. Concernant l'opération BatchWriteItem, la métrique ThrottledRequests pour l'opération BatchWriteItem entière n'est incrémentée que si tous les événements PutItem ou DeleteItem sont limités.

La dimension TableName renvoie la valeur WriteThrottleEvents pour la table, mais pas pour les index secondaires globaux. Pour afficher la valeur WriteThrottleEvents pour un index secondaire global, vous devez spécifier TableName et GlobalSecondaryIndexName.

Unités : Count

Dimensions : TableName, GlobalSecondaryIndexName

Statistiques valides :

• Sum

• SampleCount

Métriques d'utilisation

Les métriques d'utilisation vous CloudWatch permettent de gérer l'utilisation de manière proactive en visualisant les métriques dans la CloudWatch console, en créant des tableaux de bord personnalisés, en détectant les changements d'activité grâce à la détection des CloudWatch anomalies et en configurant des alarmes qui vous alertent lorsque l'utilisation approche un seuil.

DynamoDB intègre également ces métriques d'utilisation avec Service Quotas. Vous pouvez l'utiliser CloudWatch pour gérer l'utilisation de vos quotas de service par votre compte. Pour de plus amples informations, consultez Visualisation de vos quotas de service et définition des alarmes.

Liste des métriques d'utilisation disponibles

• AccountProvisionedWriteCapacityUnités
• AccountProvisionedReadCapacityUnités
• TableCount

AccountProvisionedWriteCapacityUnités

Nombre d'unités de capacité d'écriture provisionnées pour une table ou un index secondaire global.

Unités Count:

Statistiques valides :

• Minimum – Nombre d'unités de capacité d'écriture provisionnées le plus faible pendant une période.

• Maximum – Nombre d'unités de capacité d'écriture provisionnéed le plus élevé pendant une période.

• Average – Nombre moyen d'unités de capacité d'écriture provisionnées au cours d'une période.

La métrique est publiée à intervalles de cinq minutes. Par conséquent, si vous ajustez rapidement les unités de capacité d'écriture approvisionnée, il se peut que cette statistique ne reflète pas la moyenne réelle.

AccountProvisionedReadCapacityUnités

Nombre d'unités de capacité de lecture provisionnées pour une table ou un index secondaire global.

Unités Count:

Statistiques valides :

• Minimum – Nombre d'unités de capacité de lecture provisionnées le plus faible pendant une période.

• Maximum – Nombre d'unités de capacité de lecture provisionnées le plus élevé pendant une période.

• Average – Nombre moyen d'unités de capacité de lecture provisionnées au cours d'une période.

La métrique est publiée à intervalles de cinq minutes. Par conséquent, si vous ajustez rapidement les unités de capacité de lecture approvisionnée, il se peut que cette statistique ne reflète pas la moyenne réelle.

TableCount

Nombre de tables actives d'un compte.

Unités Count:

Statistiques valides :

• Minimum – Nombre de tables le plus faible au cours d'une période.

• Maximum – Nombre de tables le plus élevé pendant une période.

• Average – Nombre de tables moyen pendant une période.

Comprendre les métriques et dimensions pour DynamoDB

Les métriques associées à DynamoDB sont qualifiées par les valeurs du compte, du nom de table, du nom d'index secondaire ou de l'opération. Vous pouvez utiliser la CloudWatch console pour récupérer des données DynamoDB selon l'une des dimensions du tableau ci-dessous.

Liste des dimensions disponibles

• DelegatedOperation
• GlobalSecondaryIndexName
• Opération
• OperationType
• Verb
• ReceivingRegion
• StreamLabel
• TableName

DelegatedOperation

Cette dimension limite les données aux opérations que DynamoDB effectue pour vous. Les opérations capturées sont les suivantes :

• récupération de données de modification pour Kinesis Data Streams.

GlobalSecondaryIndexName

Cette dimension limite les données à un index secondaire global sur une table. Si vous spécifiez GlobalSecondaryIndexName, vous devez également spécifier TableName.

Opération

Cette dimension limite les données à l'une des opérations DynamoDB suivantes :

• PutItem

• DeleteItem

• UpdateItem

• GetItem

• BatchGetItem

• Scan

• Query

• BatchWriteItem

• TransactWriteItems

• TransactGetItems

• ExecuteTransaction

• BatchExecuteStatement

• ExecuteStatement

En outre, vous pouvez limiter les données à l'opération d'Amazon DynamoDB Streams suivante :

• GetRecords

OperationType

Cette dimension limite les données à l'un des types d'opérations suivants :

• Read

• Write

Cette dimension est émise pour des demandes ExecuteTransaction et BatchExecuteStatement.

Verb

Cette dimension limite les données à l'un des verbes DynamoDB PartiQL suivants :

• Insert : PartiQLInsert

• Select : PartiQLSelect

• Update : PartiQLUpdate

• Delete : PartiQLDelete

Cette dimension est émise pour l'opération ExecuteStatement.

ReceivingRegion

Cette dimension limite les données à une AWS région spécifique. Elle est utilisée avec des métriques provenant de tables de réplique au sein d'une table globale DynamoDB.

StreamLabel

Cette dimension limite les données à une étiquette de flux spécifique. Elle est utilisée avec des métriques provenant d'opérations GetRecords d'Amazon DynamoDB Streams.

TableName

Cette dimension limite les données à une table spécifique. Cette valeur peut être n'importe quel nom de table de la région actuelle et du AWS compte courant.