Métriques et dimensions DynamoDB - Amazon DynamoDB
Affichage des métriques et dimensions Comprendre les métriques et dimensions pour DynamoDB

Métriques et dimensions DynamoDB

Lorsque vous interagissez avec DynamoDB, il envoie les métriques et les dimensions à CloudWatch.

DynamoDB produit le débit provisionné consommé pendant des périodes d’une minute. L’autoscaling se déclenche lorsque la capacité consommée dépasse l’utilisation cible configurée pendant deux minutes consécutives. Les alarmes CloudWatch peuvent présenter un court délai, allant jusqu’à quelques minutes, avant de déclencher l’autoscaling. Ce délai garantit une évaluation précise des métriques CloudWatch. Si les pics de débit consommés sont espacés de plus d’une minute, l’autoscaling risque de ne pas se déclencher. De même, un événement de réduction verticale peut être déclenché lorsque 15 points de données consécutifs sont en dessous de l’utilisation cible. Dans les deux cas, une fois l’autoscaling déclenché, l’API UpdateTable est invoquée. Plusieurs minutes sont ensuite nécessaires pour mettre à jour la capacité provisionnée pour la table ou l’index. Pendant cette période, toutes les demandes dépassant la capacité provisionnée précédente pour les tables seront limitées.

Affichage des métriques et dimensions

CloudWatch affiche les métriques suivantes pour DynamoDB :

Métriques DynamoDB

Note

Amazon CloudWatch regroupe ces métriques à des intervalles d’une minute :

  • ConditionalCheckFailedRequests

  • ConsumedReadCapacityUnits

  • ConsumedWriteCapacityUnits

  • ReadAccountLimitThrottleEvents

  • ReadKeyRangeThroughputThrottleEvents

  • ReadMaxOnDemandThroughputThrottleEvents

  • ReadProvisionedThroughputThrottleEvents

  • ReadThrottleEvents

  • ReturnedBytes

  • ReturnedItemCount

  • ReturnedRecordsCount

  • SuccessfulRequestLatency

  • SystemErrors

  • TimeToLiveDeletedItemCount

  • ThrottledRequests

  • TransactionConflict

  • UserErrors

  • WriteAccountLimitThrottleEvents

  • WriteKeyRangeThroughputThrottleEvents

  • WriteMaxOnDemandThroughputThrottleEvents

  • WriteProvisionedThroughputThrottleEvents

  • 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 en utilisant la console CloudWatch, AWS CLI ou des kits SDK AWS pour toutes les métriques.

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

AccountMaxReads

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

Unités Count:

Statistiques valides :

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

AccountMaxTableLevelReads

Nombre maximum d’unités de capacité de lecture qu’une table ou un index secondaire global d’un compte peuvent utiliser. Pour des tables à la demande, cette limite plafonne le nombre maximum d’unités de demande de lecture qu’une table ou un index secondaire global peuvent 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.

AccountMaxTableLevelWrites

Nombre maximum d’unités de capacité d’écriture qu’une table ou un index secondaire global d’un compte peuvent utiliser. Pour des tables à la demande, cette limite plafonne le nombre maximum 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.

AccountMaxWrites

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

Unités Count:

Statistiques valides :

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

AccountProvisionedReadCapacityUtilization

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 provisionnée, il se peut que cette statistique ne reflète pas la moyenne réelle.

AccountProvisionedWriteCapacityUtilization

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 provisionnée, il se peut que cette statistique ne reflète pas la moyenne réelle.

AgeOfOldestUnreplicatedRecord

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

ConsumedChangeDataCaptureUnits

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

Cela signifie que les pics courts et intenses de consommation de capacité qui ne durent qu’une seconde peuvent ne pas être reflétés avec précision dans le graphique CloudWatch, ce qui pourrait entraîner une baisse du débit 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 – Représente la fréquence à laquelle la métrique est émise. Même pour les tables dont le trafic est nul, la valeur SampleCount est régulièrement émise, mais les valeurs d’échantillon seront toujours nulles.

    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, récupérez la valeur Sum sur une durée d’une minute, puis divisez-la par le nombre de secondes dans une minute (60) afin calculer la valeur ConsumedWriteCapacityUnits moyenne par seconde (en sachant que cette moyenne ne met pas en évidence les grands pics mais les pic brefs d’activité d’écriture 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 – Représente la fréquence à laquelle la métrique est émise. Même pour les tables dont le trafic est nul, la valeur SampleCount est régulièrement émise, mais les valeurs d’échantillon seront toujours nulles.

    Note

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

FailedToReplicateRecordCount

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 provisionné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 provisionnée, il se peut que cette statistique ne reflète pas la moyenne réelle.

OnDemandMaxReadRequestUnits

Nombre d’unités de demande de lecture à la demande pour une table ou un index secondaire global.

Pour afficher la valeur OnDemandMaxReadRequestUnits pour une table, vous devez spécifier TableName. 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 – Paramètre le plus bas pour les unités de demande de lecture à la demande. Si vous utilisez UpdateTable pour augmenter les unités de demande de lecture, cette métrique indique la valeur ReadRequestUnits à la demande la plus faible pendant cette période.

  • Maximum – 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 ReadRequestUnits à la demande la plus élevée pendant 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, il se peut que cette statistique ne reflète pas la moyenne réelle.

OnDemandMaxWriteRequestUnits

Nombre d’unités de demande d’écriture à la demande pour une table ou un index secondaire global.

Pour afficher la valeur OnDemandMaxWriteRequestUnits pour une table, vous devez spécifier TableName. 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 – 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 WriteRequestUnits à la demande la plus faible pendant cette période.

  • Maximum – 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 WriteRequestUnits à la demande la plus élevée pendant 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, il se peut que cette statistique ne reflète pas la moyenne réelle.

OnlineIndexConsumedWriteCapacity

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 métrique ConsumedWriteCapacityUnits pour l’index n’inclut pas le débit d’écriture consommé pendant 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 métrique WriteThrottleEvents pour l’index n’inclut pas les événements de limitation qui se produisent lors de la création de l’index.

Unités : Count

Dimensions : TableName, GlobalSecondaryIndexName

Statistiques valides :

  • Minimum

  • Maximum

  • Average

  • SampleCount

  • Sum

PendingReplicationCount

Métrique pour Tables globales de la version 2017.11.29 (héritée) (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 provisionné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 provisionnée, il se peut que cette statistique ne reflète pas la moyenne réelle.

ReadAccountLimitThrottleEvents

Nombre de demandes de lecture limitées en raison des limites du compte.

Unités : Count

Dimensions: TableName, GlobalSecondaryIndexName

Statistiques valides :

  • Sum – Nombre total d’événements limités.

  • SampleCount – Nombre d’occurrences de limitation.

  • Minimum – Nombre minimum d’événements limités dans un exemple donné.

  • Maximum – Nombre maximum d’événements limités dans un exemple donné.

ReadKeyRangeThroughputThrottleEvents

Nombre de demandes de lecture limitées en raison des limites de partition.

Unités : Count

Dimensions: TableName, GlobalSecondaryIndexName

Statistiques valides :

  • Sum – Nombre total d’événements limités.

  • SampleCount – Nombre d’occurrences de limitation.

  • Minimum – Nombre minimum d’événements limités dans un exemple donné.

  • Maximum – Nombre maximum d’événements limités dans un exemple donné.

ReadMaxOnDemandThroughputThrottleEvents

Nombre de demandes de lecture limitées en raison du débit maximal à la demande.

Unités : Count

Dimensions: TableName, GlobalSecondaryIndexName

Statistiques valides :

  • Sum – Nombre total d’événements limités.

  • SampleCount – Nombre d’occurrences de limitation.

  • Minimum – Nombre minimum d’événements limités dans un exemple donné.

  • Maximum – Nombre maximum d’événements limités dans un exemple donné.

ReadProvisionedThroughputThrottleEvents

Nombre de demandes de lecture limitées en raison de limites de débit approvisionné.

Unités : Count

Dimensions: TableName, GlobalSecondaryIndexName

Statistiques valides :

  • Sum – Nombre total d’événements limités.

  • SampleCount – Nombre d’occurrences de limitation.

  • Minimum – Nombre minimum d’événements limités dans un exemple donné.

  • Maximum – Nombre maximum d’événements limités dans un exemple donné.

ReadThrottleEvents

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

ReturnedItemCount

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

ReturnedRecordsCount

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

SuccessfulRequestLatency

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, Average ou Percentile).

  • Nombre de demandes réussies (SampleCount).

SuccessfulRequestLatency reflète l’activité uniquement au sein de DynamoDB ou d’Amazon DynamoDB Streams, et ne prend en compte ni la latence réseau, ni l’activité côté client.

Note

Pour analyser des valeurs de percentile personnalisées (telles que p99,9), vous pouvez saisir manuellement le percentile souhaité (par exemple, p99,9) dans le champ de statistique de métrique CloudWatch. Cela vous permet d’évaluer les distributions de latence au-delà des percentiles par défaut répertoriés dans la liste déroulante.

Unités : Milliseconds

Dimensions : TableName, Operation, StreamLabel

Statistiques valides :

  • Minimum

  • Maximum

  • Sum

  • Average

  • Percentile

  • 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.

Note

Lorsque DynamoDB renvoie une erreur système (HTTP 500), la plupart des kits SDK AWS effectuent automatiquement un nombre de tentatives configurable. Si le problème est résolu lors d’une nouvelle tentative, votre application continue sans que l’erreur ne s’affiche, et vous remarquerez peut-être une augmentation de la latence perçue côté client. Si l’erreur persiste après toutes les tentatives, elle se propage dans le code de votre application.

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 – Consultez la métrique ThrottledRequests dans cette section.

  • ConditionalCheckFailedException – Consultez la métrique ConditionalCheckFailedRequests dans cette section.

UserErrors représente l’ensemble des erreurs HTTP 400 liées à des demandes DynamoDB ou Amazon DynamoDB Streams pour la région AWS et le compte AWS actuels.

Unités : Count

Statistiques valides :

  • Sum

  • SampleCount

WriteAccountLimitThrottleEvents

Nombre de demandes d’écriture limitées en raison des limites du compte.

Unités : Count

Dimensions : TableName

Statistiques valides :

  • Sum – Nombre total d’événements limités.

  • SampleCount – Nombre d’occurrences de limitation.

  • Minimum – Nombre minimum d’événements limités dans un exemple donné.

  • Maximum – Nombre maximum d’événements limités dans un exemple donné.

WriteKeyRangeThroughputThrottleEvents

Nombre de demandes d’écriture limitées en raison des limites de partition.

Unités : Count

Dimensions: TableName, GlobalSecondaryIndexName

Statistiques valides :

  • Sum – Nombre total d’événements limités.

  • SampleCount – Nombre d’occurrences de limitation.

  • Minimum – Nombre minimum d’événements limités dans un exemple donné.

  • Maximum – Nombre maximum d’événements limités dans un exemple donné.

WriteMaxOnDemandThroughputThrottleEvents

Nombre de demandes d’écriture limitées en raison du débit maximal à la demande.

Unités : Count

Dimensions: TableName, GlobalSecondaryIndexName

Statistiques valides :

  • Sum – Nombre total d’événements limités.

  • SampleCount – Nombre d’occurrences de limitation.

  • Minimum – Nombre minimum d’événements limités dans un exemple donné.

  • Maximum – Nombre maximum d’événements limités dans un exemple donné.

WriteProvisionedThroughputThrottleEvents

Nombre de demandes d’écriture limitées en raison de limites de débit provisionné.

Unités : Count

Dimensions: TableName, GlobalSecondaryIndexName

Statistiques valides :

  • Sum – Nombre total d’événements limités.

  • SampleCount – Nombre d’occurrences de limitation.

  • Minimum – Nombre minimum d’événements limités dans un exemple donné.

  • Maximum – Nombre maximum d’événements limités dans un exemple donné.

WriteThrottleEvents

Demandes adressées à DynamoDB qui dépassent le nombre d’unités de capacité d’écriture provisionné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 dans CloudWatch vous permettent de gérer de manière proactive l’utilisation en visualisant les métriques dans la console CloudWatch, en créant des tableaux de bord personnalisés, en détectant les changements d’activité avec la détection d’anomalies CloudWatch et en configurant des alertes qui vous alertent lorsque l’utilisation approche d’un seuil.

DynamoDB intègre également ces métriques d’utilisation avec Service Quotas. Pour ces services, vous pouvez utiliser CloudWatch afin de 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.

AccountProvisionedWriteCapacityUnits

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 provisionnée, il se peut que cette statistique ne reflète pas la moyenne réelle.

AccountProvisionedReadCapacityUnits

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 provisionné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 console CloudWatch pour récupérer des données de DynamoDB en même temps que les dimensions figurant dans le tableau ci-dessous.

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 à un une région AWS particulière. 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 correspondre à n’importe quel nom de table dans la région et le compte AWS actuels.