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.
Métriques et dimensions DynamoDB
Lorsque vous interagissez avec DynamoDB, celui-ci envoie des métriques et des dimensions à. CloudWatch
DynamoDB génère le débit provisionné consommé pendant des périodes d'une minute. La mise à l'échelle automatique se déclenche lorsque la capacité consommée dépasse l'utilisation cible configurée pendant deux minutes consécutives. CloudWatch les alarmes peuvent avoir un court délai de quelques minutes avant de déclencher le redimensionnement automatique. Ce délai garantit une évaluation CloudWatch précise des mesures. Si les pics de débit consommés sont espacés de plus d'une minute, le dimensionnement automatique risque de ne pas se déclencher. De même, un événement de réduction peut se produire lorsque 15 points de données consécutifs sont inférieurs à l'utilisation cible. Dans les deux cas, après le déclenchement de l'autoscaling, le UpdateTableAPIest invoqué. Plusieurs minutes sont ensuite nécessaires pour mettre à jour la capacité allouée à la table ou à l'index. Au cours de cette période, toutes les demandes qui dépassent la capacité précédemment allouée aux tables sont limitées.
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 la console, ou pour toutes CloudWatch les métriques AWS SDKs. AWS CLI
Dans la liste suivante, chaque métrique dispose d'un ensemble de statistiques valides qui s'appliquent à cette métrique.
Répertorier les métriques disponibles
- AccountMaxReads
- AccountMaxTableLevelReads
- AccountMaxTableLevelWrites
- AccountMaxWrites
- AccountProvisionedReadCapacityUtilization
- AccountProvisionedWriteCapacityUtilization
- AgeOfOldestUnreplicatedRecord
- ConditionalCheckFailedRequests
- ConsumedChangeDataCaptureUnits
- ConsumedReadCapacityUnits
- ConsumedWriteCapacityUnits
- FailedToReplicateRecordCount
- MaxProvisionedTableReadCapacityUtilization
- MaxProvisionedTableWriteCapacityUtilization
- OnDemandMaxReadRequestUnits
- OnDemandMaxWriteRequestUnits
- OnlineIndexConsumedWriteCapacity
- OnlineIndexPercentageProgress
- OnlineIndexThrottleEvents
- PendingReplicationCount
- ProvisionedReadCapacityUnits
- ProvisionedWriteCapacityUnits
- ReadThrottleEvents
- ReplicationLatency
- ReturnedBytes
- ReturnedItemCount
- ReturnedRecordsCount
- SuccessfulRequestLatency
- SystemErrors
- TimeToLiveDeletedItemCount
- ThrottledPutRecordCount
- ThrottledRequests
- TransactionConflict
- UserErrors
- WriteThrottleEvents
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 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.
AccountMaxTableLevelReads
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.
AccountMaxTableLevelWrites
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.
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 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.
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 approvisionné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 approvisionné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înera une erreur HTTP 400 (mauvaise demande). 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
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étriqueConsumedReadCapacityUnits
. -
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étriqueConsumedWriteCapacityUnits
. -
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.
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 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.
OnDemandMaxReadRequestUnits
Pour 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 augmentezUpdateTable
les unités de demande de lecture, cette métrique indique la valeur la plus faible de la demandeReadRequestUnits
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 utilisezUpdateTable
pour diminuer les unités de demande de lecture, cette métrique indique la valeur la plus élevée de la demandeReadRequestUnits
au cours de cette période. -
Average
— Nombre moyen d'unités de demande de lecture à la demande. La métriqueOnDemandMaxReadRequestUnits
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.
OnDemandMaxWriteRequestUnits
Pour 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 utilisezUpdateTable
pour augmenter les unités de demande d'écriture, cette métrique indique la valeur la plus faible de la demandeWriteRequestUnits
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 utilisezUpdateTable
pour diminuer les unités de demande d'écriture, cette métrique indique la valeur la plus élevée de la demandeWriteRequestUnits
au cours de cette période. -
Average
— Nombre moyen d'unités de demande d'écriture à la demande. La métriqueOnDemandMaxWriteRequestUnits
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.
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 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
PendingReplicationCount
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 utilisezUpdateTable
pour augmenter la capacité de lecture, cette métrique indique la valeurReadCapacityUnits
approvisionnée la plus faible pendant cette période. -
Maximum
– Paramètre le plus élevé pour la capacité de lecture approvisionnée. Si vous utilisezUpdateTable
pour réduire la capacité de lecture, cette métrique indique la valeurReadCapacityUnits
approvisionnée la plus élevée pendant cette période. -
Average
– Capacité de lecture approvisionnée moyenne. La métriqueProvisionedReadCapacityUnits
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 utilisezUpdateTable
pour augmenter la capacité d'écriture, cette métrique indique la valeurWriteCapacityUnits
approvisionnée la plus faible pendant cette période. -
Maximum
– Paramètre le plus élevé pour la capacité d'écriture approvisionnée. Si vous utilisezUpdateTable
pour réduire la capacité d'écriture, cette métrique indique la valeurWriteCapacityUnits
approvisionnée la plus élevée pendant cette période. -
Average
– Capacité d'écriture approvisionnée moyenne. La métriqueProvisionedWriteCapacityUnits
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.
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
ouAverage
). -
Nombre de requêtes réussies (
SampleCount
).
SuccessfulRequestLatency
reflè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
Les demandes adressées à DynamoDB ou Amazon DynamoDB Streams qui génèrent HTTP un code de statut 500 au cours de la période spécifiée. Un HTTP 500 indique généralement une erreur de service interne.
Unités : Count
Dimensions : TableName, Operation
Statistiques valides :
-
Sum
-
SampleCount
TimeToLiveDeletedItemCount
Le nombre d'éléments supprimés par Time to Live (TTL) au cours de la période spécifiée. Cette métrique vous permet de surveiller le taux de TTL suppressions 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énementGetItem
limité dansBatchGetItem
. -
WriteThrottleEvents
– Pour un événementPutItem
ouDeleteItem
limité dansBatchWriteItem
.
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 se traduira par un code de statut 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 valeurSum
est incrémentée d'une unité pour chaque demandePut
,Update
,Delete
ouGet
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 valeurSampleCount
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
ouDeleteItem
. -
Max
– Nombre maximum de demandes au niveau de l'élément rejetées dans un appel àTransactWriteItems
,TransactGetItems
,PutItem
,UpdateItem
ouDeleteItem
. -
Average
– Nombre moyen de demandes au niveau de l'élément rejetées dans un appel àTransactWriteItems
,TransactGetItems
,PutItem
,UpdateItem
ouDeleteItem
.
UserErrors
Demandes adressées à DynamoDB ou Amazon DynamoDB Streams qui génèrent HTTP un code de statut 400 au cours de la période spécifiée. Un HTTP 400 indique généralement une erreur côté client, telle qu'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.
UserErrors
représente le total de HTTP 400 erreurs 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
WriteThrottleEvents
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
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 approvisionné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 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
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.