

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.

# Surveillance des métriques dans DynamoDB avec Amazon CloudWatch
<a name="Monitoring-metrics-with-Amazon-CloudWatch"></a>

Vous pouvez surveiller DynamoDB à CloudWatch l'aide de ce qui collecte et traite les données brutes de DynamoDB en métriques lisibles quasiment en temps réel. Ces statistiques étant conservées pendant un certain temps, vous pouvez accéder à des informations historiques pour acquérir une meilleure perspective sur les performances de votre service ou application web. Par défaut, les données métriques DynamoDB sont envoyées automatiquement à. CloudWatch Pour plus d'informations, consultez [Qu'est-ce qu'Amazon CloudWatch ?](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/WhatIsCloudWatch.html) et [conservation des métriques](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#metrics-retention) dans le *guide de CloudWatch l'utilisateur Amazon*.

**Topics**
+ [Comment utiliser les métriques de DynamoDB ?](#How-do-I-use-DynamoDB-metrics)
+ [Afficher les métriques dans la CloudWatch console](#Viewing-metrics-in-CloudWatch-console)
+ [Afficher les métriques dans le AWS CLI](#Viewing-metrics-in-the-cli)
+ [Métriques et dimensions DynamoDB](metrics-dimensions.md)
+ [Création d' CloudWatch alarmes dans DynamoDB](Monitoring-metrics-creating-cloudwatch-alarms.md)

## Comment utiliser les métriques de DynamoDB ?
<a name="How-do-I-use-DynamoDB-metrics"></a>

Les métriques rapportées par DynamoDB fournissent des informations que vous pouvez analyser de différentes manières. La liste suivante présente certaines utilisations courantes des métriques. Voici quelques suggestions pour vous aider à démarrer, qui ne forment pas une liste exhaustive.


**Comment utiliser les métriques de DynamoDB ?**  

|  Comment puis-je ?  |  Métriques pertinentes  | 
| --- | --- | 
|  Comment surveiller le taux de suppressions par TTL sur ma table ?   |  Vous pouvez surveiller `TimeToLiveDeletedItemCount` sur la période spécifiée afin de suivre le taux des suppressions par TTL sur votre table. Pour un exemple d'application sans serveur utilisant cette `TimeToLiveDeletedItemCount` métrique, consultez [Archiver automatiquement des éléments dans S3 à l'aide de DynamoDB time to live (TTL) with](https://aws.amazon.com/blogs/database/automatically-archive-items-to-s3-using-dynamodb-time-to-live-with-aws-lambda-and-amazon-kinesis-firehose/) et Amazon Data Firehose. AWS Lambda   | 
|  Comment puis-je déterminer la part de mon débit provisionné qui est utilisée ?  |  Vous pouvez surveiller les valeurs `ConsumedReadCapacityUnits` ou `ConsumedWriteCapacityUnits` sur la période spécifiée afin de suivre la quantité de votre débit provisionné utilisée.  | 
|  Comment puis-je déterminer les demandes qui dépassent les quotas de débit provisionné d’une table ?  |  `ThrottledRequests` est incrémenté de 1 si les événements au sein d’une demande dépassent un quota de débit provisionné. Ensuite, pour obtenir une information sur l’événement qui limite une demande, comparez la valeur `ThrottledRequests` avec les métriques `ReadThrottleEvents` et `WriteThrottleEvents` pour la table et ses index.  | 
|  Comment déterminer si des erreurs système se sont produites  |  Vous pouvez surveiller `SystemErrors` pour déterminer si des demandes ont entraîné un code HTTP 500 (erreur de serveur). En règle générale, cette métrique doit être égale à zéro. Si tel n’est pas le cas, vous pouvez enquêter.  | 
|  Comment surveiller la valeur de latences pour les opérations de mes tables ?  |  Vous pouvez surveiller `SuccessfulRequestLatency` en suivant la latence moyenne et la latence médiane à l’aide de mesures percentiles (p50). Les pics de latence occasionnels ne sont pas préoccupants. Toutefois, si la latence moyenne ou p50 (médiane) est élevée, il se peut qu’il y ait un problème sous-jacent que vous devez résoudre. Pour plus d’informations, consultez [Résolution des problèmes de latence dans Amazon DynamoDB](TroubleshootingLatency.md).  | 

## Afficher les métriques dans la CloudWatch console
<a name="Viewing-metrics-in-CloudWatch-console"></a>

Les métriques sont d’abord regroupées par espace de noms de service, puis par les différentes combinaisons de dimension au sein de chaque espace de noms.

**Pour afficher les métriques dans la CloudWatch console**

1. Ouvrez la CloudWatch console à l'adresse [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Dans le panneau de navigation, sélectionnez **Métriques, Toutes les métriques**.

1. Sélectionnez l’espace de noms **DynamoDB**. Vous pouvez également sélectionner l’espace de noms **Utilisation** pour afficher les métriques d’utilisation de DynamoDB. Pour plus d’informations sur les métriques, consultez [Métriques d’utilisation d’AWS](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Service-Quota-Integration.html).

1. L’onglet **Parcourir** affiche toutes les métriques dans l’espace de noms.

1. (Facultatif) Pour ajouter le graphique métrique à un CloudWatch tableau de bord, choisissez **Actions, Ajouter au tableau de bord**. 

## Afficher les métriques dans le AWS CLI
<a name="Viewing-metrics-in-the-cli"></a>

Pour obtenir des informations métriques à l'aide de AWS CLI, utilisez la CloudWatch commande`list-metrics`. Dans l’exemple indiqué ci-dessous, vous répertoriez toutes les métriques dans l’espace de noms `AWS/DynamoDB`.

```
1.                 aws cloudwatch list-metrics --namespace "AWS/DynamoDB"
```

Pour obtenir des statistiques de métriques, utilisez la commande`get-metric-statistics`. La commande suivante obtient des statistiques `ConsumedReadCapacityUnits` pour la table `ProductCatalog` au cours d’une période de 24 heures donnée, avec une précision d’un niveau de 5 minutes.

```
aws cloudwatch get-metric-statistics —namespace AWS/DynamoDB \
     —metric-name ConsumedReadCapacityUnits \
     —start-time 2023-11-01T00:00:00Z \
     —end-time 2023-11-02T00:00:00Z \
     —period 360 \
     —statistics Average \
     —dimensions Name=TableName,Value=ProductCatalog
```

L’exemple de sortie apparaît comme suit :

```
{
    "Datapoints": [
        {
            "Timestamp": "2023-11-01T 09:18:00+00:00", 
            "Average": 20, 
            "Unit": "Count"
        }, 
        {
            "Timestamp": "2023-11-01T 04:36:00+00:00", 
            "Average": 22.5, 
            "Unit": "Count"
        }, 
        {
            "Timestamp": "2023-11-01T 15:12:00+00:00", 
            "Average": 20, 
            "Unit": "Count"
        }, ...
        {
            "Timestamp": "2023-11-01T 17:30:00+00:00", 
            "Average": 25, 
            "Unit": "Count"
        }
    ], 
    "Label": " ConsumedReadCapacityUnits "
}
```

# Métriques et dimensions DynamoDB
<a name="metrics-dimensions"></a>

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

DynamoDB produit le débit provisionné consommé pendant des périodes d’une minute. Le [dimensionnement automatique](AutoScaling.md) 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, 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, après le déclenchement de l'autoscaling, l'[UpdateTable](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateTable.html)API 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
<a name="dynamodb-metrics-dimensions"></a>

CloudWatch affiche les mesures suivantes pour DynamoDB :

### Métriques DynamoDB
<a name="dynamodb-metrics"></a>

**Note**  
Amazon CloudWatch agrège ces statistiques à 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`
`FaultInjectionServiceInducedErrors`
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.

**Topics**<a name="available-metrics.title"></a>
+ [Métriques DynamoDB](#dynamodb-metrics)
+ [AccountMaxReads](#AccountMaxReads)
+ [AccountMaxTableLevelReads](#AccountMaxTableLevelReads)
+ [AccountMaxTableLevelWrites](#AccountMaxTableLevelWrites)
+ [AccountMaxWrites](#AccountMaxWrites)
+ [AccountProvisionedReadCapacityUtilization](#AccountProvisionedReadCapacityUtilization)
+ [AccountProvisionedWriteCapacityUtilization](#AccountProvisionedWriteCapacityUtilization)
+ [AgeOfOldestUnreplicatedRecord](#AgeOfOldestUnreplicatedRecord)
+ [ConditionalCheckFailedRequests](#ConditionalCheckFailedRequests)
+ [ConsumedChangeDataCaptureUnits](#ConsumedChangeDataCaptureUnits)
+ [ConsumedReadCapacityUnits](#ConsumedReadCapacityUnits)
+ [ConsumedWriteCapacityUnits](#ConsumedWriteCapacityUnits)
+ [FailedToReplicateRecordCount](#FailedToReplicateRecordCount)
+ [MaxProvisionedTableReadCapacityUtilization](#MaxProvisionedTableReadCapacityUtilization)
+ [MaxProvisionedTableWriteCapacityUtilization](#MaxProvisionedTableWriteCapacityUtilization)
+ [OnDemandMaxReadRequestUnits](#OnDemandMaxReadRequestUnits)
+ [OnDemandMaxWriteRequestUnits](#OnDemandMaxWriteRequestUnits)
+ [OnlineIndexConsumedWriteCapacity](#OnlineIndexConsumedWriteCapacity)
+ [OnlineIndexPercentageProgress](#OnlineIndexPercentageProgress)
+ [OnlineIndexThrottleEvents](#OnlineIndexThrottleEvents)
+ [PendingReplicationCount](#PendingReplicationCount)
+ [ProvisionedReadCapacityUnits](#ProvisionedReadCapacityUnits)
+ [ProvisionedWriteCapacityUnits](#ProvisionedWriteCapacityUnits)
+ [ReadAccountLimitThrottleEvents](#ReadAccountLimitThrottleEvents)
+ [ReadKeyRangeThroughputThrottleEvents](#ReadKeyRangeThroughputThrottleEvents)
+ [ReadMaxOnDemandThroughputThrottleEvents](#ReadMaxOnDemandThroughputThrottleEvents)
+ [ReadProvisionedThroughputThrottleEvents](#ReadProvisionedThroughputThrottleEvents)
+ [ReadThrottleEvents](#ReadThrottleEvents)
+ [ReplicationLatency](#ReplicationLatency)
+ [ReturnedBytes](#ReturnedBytes)
+ [ReturnedItemCount](#ReturnedItemCount)
+ [ReturnedRecordsCount](#ReturnedRecordsCount)
+ [SuccessfulRequestLatency](#SuccessfulRequestLatency)
+ [SystemErrors](#SystemErrors)
+ [TimeToLiveDeletedItemCount](#TimeToLiveDeletedItemCount)
+ [ThrottledPutRecordCount](#ThrottledPutRecordCount)
+ [ThrottledRequests](#ThrottledRequests)
+ [TransactionConflict](#TransactionConflict)
+ [UserErrors](#UserErrors)
+ [WriteAccountLimitThrottleEvents](#WriteAccountLimitThrottleEvents)
+ [WriteKeyRangeThroughputThrottleEvents](#WriteKeyRangeThroughputThrottleEvents)
+ [WriteMaxOnDemandThroughputThrottleEvents](#WriteMaxOnDemandThroughputThrottleEvents)
+ [WriteProvisionedThroughputThrottleEvents](#WriteProvisionedThroughputThrottleEvents)
+ [WriteThrottleEvents](#WriteThrottleEvents)
+ [Métriques d’utilisation](#w2aac41c15c13b7c11)
+ [FaultInjectionServiceInducedErrors](#FaultInjectionServiceInducedErrors)

### AccountMaxReads
<a name="AccountMaxReads"></a>

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
<a name="AccountMaxTableLevelReads"></a>

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
<a name="AccountMaxTableLevelWrites"></a>

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
<a name="AccountMaxWrites"></a>

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
<a name="AccountProvisionedReadCapacityUtilization"></a>

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
<a name="AccountProvisionedWriteCapacityUtilization"></a>

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
<a name="AgeOfOldestUnreplicatedRecord"></a>

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
<a name="ConditionalCheckFailedRequests"></a>

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
<a name="ConsumedChangeDataCaptureUnits"></a>

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
<a name="ConsumedReadCapacityUnits"></a>

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](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ProvisionedThroughputIntro.html).

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é 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` – 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
<a name="ConsumedWriteCapacityUnits"></a>

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](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ProvisionedThroughputIntro.html).

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`. La `Source` dimension peut renvoyer l'une des deux valeurs suivantes : `Customer` et`GlobalTable`. Les écritures répliquées auront `ConsumedWriteCapacityUnits` avec la source`GlobalTable`, mais les écritures de table régionales l'auront `ConsumedWriteCapacityUnits` avec la source`Customer`.

**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, Source`

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
<a name="FailedToReplicateRecordCount"></a>

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
<a name="MaxProvisionedTableReadCapacityUtilization"></a>

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
<a name="MaxProvisionedTableWriteCapacityUtilization"></a>

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
<a name="OnDemandMaxReadRequestUnits"></a>

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
<a name="OnDemandMaxWriteRequestUnits"></a>

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
<a name="OnlineIndexConsumedWriteCapacity"></a>

Cette métrique devrait afficher 0 lors de la création de l'index. Cette métrique indiquait précédemment le nombre d'unités de capacité d'écriture consommées lors de l'ajout d'un nouvel index secondaire global à une table.

Unités : `Count`

Dimensions : `TableName, GlobalSecondaryIndexName`

Statistiques valides :
+ `Minimum`
+ `Maximum`
+ `Average`
+ `SampleCount`
+ `Sum`

### OnlineIndexPercentageProgress
<a name="OnlineIndexPercentageProgress"></a>

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
<a name="OnlineIndexThrottleEvents"></a>

Cette métrique devrait afficher 0 lors de la création de l'index. Cette métrique indiquait précédemment le nombre d'événements de limitation d'écriture qui se produisent lors de l'ajout d'un nouvel index secondaire global à une table. 

Unités : `Count`

Dimensions : `TableName, GlobalSecondaryIndexName`

Statistiques valides :
+ `Minimum`
+ `Maximum`
+ `Average`
+ `SampleCount`
+ `Sum`

### PendingReplicationCount
<a name="PendingReplicationCount"></a>

Métrique pour [Tables globales de la version 2017.11.29 (héritée)](globaltables.V1.md) (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
<a name="ProvisionedReadCapacityUnits"></a>

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
<a name="ProvisionedWriteCapacityUnits"></a>

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
<a name="ReadAccountLimitThrottleEvents"></a>

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
<a name="ReadKeyRangeThroughputThrottleEvents"></a>

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
<a name="ReadMaxOnDemandThroughputThrottleEvents"></a>

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
<a name="ReadProvisionedThroughputThrottleEvents"></a>

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
<a name="ReadThrottleEvents"></a>

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
<a name="ReplicationLatency"></a>

(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
<a name="ReturnedBytes"></a>

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
<a name="ReturnedItemCount"></a>

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
<a name="ReturnedRecordsCount"></a>

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
<a name="SuccessfulRequestLatency"></a>

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 statistiques métriques. 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
<a name="SystemErrors"></a>

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 AWS SDKs plupart exécutent 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
<a name="TimeToLiveDeletedItemCount"></a>

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
<a name="ThrottledPutRecordCount"></a>

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
<a name="ThrottledRequests"></a>

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
<a name="TransactionConflict"></a>

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](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/transaction-apis.html#transaction-conflict-handling). 

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
<a name="UserErrors"></a>

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.

`UserErrors`repré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`

### WriteAccountLimitThrottleEvents
<a name="WriteAccountLimitThrottleEvents"></a>

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
<a name="WriteKeyRangeThroughputThrottleEvents"></a>

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
<a name="WriteMaxOnDemandThroughputThrottleEvents"></a>

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
<a name="WriteProvisionedThroughputThrottleEvents"></a>

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
<a name="WriteThrottleEvents"></a>

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
<a name="w2aac41c15c13b7c11"></a>

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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Quotas-Visualize-Alarms.html).

**Topics**<a name="ddb-usage-metrics.title"></a>
+ [AccountProvisionedWriteCapacityUnits](#w2aac41c15c13b7c11b9)
+ [AccountProvisionedReadCapacityUnits](#w2aac41c15c13b7c11c11)
+ [TableCount](#w2aac41c15c13b7c11c13)

#### AccountProvisionedWriteCapacityUnits
<a name="w2aac41c15c13b7c11b9"></a>

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
<a name="w2aac41c15c13b7c11c11"></a>

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
<a name="w2aac41c15c13b7c11c13"></a>

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. 

### FaultInjectionServiceInducedErrors
<a name="FaultInjectionServiceInducedErrors"></a>

Les demandes adressées à DynamoDB qui génèrent un code d'état HTTP 500 simulé pendant la période spécifiée et pendant le rattrapage à la suite de l'expérience. AWS FIS 

Unités : `Count`

Dimensions: `TableName`, `Operation`

Statistiques valides :
+ `Sum` 
+ `SampleCount` 

## Comprendre les métriques et dimensions pour DynamoDB
<a name="ddb-understanding-metric-dimensions"></a>

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.

**Topics**<a name="available-metrics.title"></a>
+ [DelegatedOperation](#w2aac41c15c13b9b7)
+ [GlobalSecondaryIndexName](#w2aac41c15c13b9b9)
+ [Opération](#w2aac41c15c13b9c11)
+ [OperationType](#w2aac41c15c13b9c13)
+ [Verb](#w2aac41c15c13b9c15)
+ [ReceivingRegion](#w2aac41c15c13b9c17)
+ [StreamLabel](#w2aac41c15c13b9c19)
+ [TableName](#w2aac41c15c13b9c21)

### DelegatedOperation
<a name="w2aac41c15c13b9b7"></a>

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
<a name="w2aac41c15c13b9b9"></a>

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
<a name="w2aac41c15c13b9c11"></a>

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
<a name="w2aac41c15c13b9c13"></a>

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
<a name="w2aac41c15c13b9c15"></a>

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
<a name="w2aac41c15c13b9c17"></a>

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
<a name="w2aac41c15c13b9c19"></a>

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
<a name="w2aac41c15c13b9c21"></a>

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.

# Création d' CloudWatch alarmes dans DynamoDB
<a name="Monitoring-metrics-creating-cloudwatch-alarms"></a>

Une [CloudWatch alarme](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) surveille une seule métrique sur une période spécifiée et exécute une ou plusieurs actions spécifiées, en fonction de la valeur de la métrique par rapport à un seuil au fil du temps. L’action est une notification envoyée à une rubrique Amazon SNS ou à une politique Auto Scaling. Vous pouvez également ajouter des alarmes aux tableaux de bord afin de surveiller et de recevoir des alertes concernant vos AWS ressources et applications dans plusieurs régions. Le nombre d'alarmes que vous pouvez créer est illimité. CloudWatch les alarmes n'appellent pas d'actions simplement parce qu'elles sont dans un état particulier ; l'état doit avoir changé et être maintenu pendant un certain nombre de périodes. Pour obtenir la liste des alarmes DynamoDB recommandées, consultez [Alarmes recommandées](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Best_Practice_Recommended_Alarms_AWS_Services.html#DynamoDB).

**Note**  
Vous devez spécifier toutes les dimensions requises lors de la création de votre CloudWatch alarme, car les mesures relatives à une dimension manquante ne CloudWatch seront pas agrégées. La création CloudWatch d'une alarme avec une dimension manquante ne provoquera pas d'erreur lors de la création de l'alarme.

Supposons que vous disposiez d’une table provisionnée avec cinq unités de capacité de lecture. Vous souhaitez être averti avant de consommer la totalité de la capacité de lecture allouée. Vous décidez donc de créer une CloudWatch alarme pour être averti lorsque la capacité consommée atteint 80 % de ce que vous avez provisionné pour la table. Vous pouvez créer des alarmes dans la CloudWatch console ou à l'aide du AWS CLI.

## Création d'une alarme dans la CloudWatch console
<a name="monitoring-metrics-creating-an-alarm-cw-console"></a>

**Pour créer une alarme dans la CloudWatch console**

1. Connectez-vous à la CloudWatch console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Dans le panneau de navigation, choisissez **Alarms** (alertes), **All alarms** (Toutes les alertes).

1. Choisissez **Create alarm (Créer une alerte)**.

1. Recherchez la rangée contenant le tableau que vous souhaitez surveiller et **`ConsumeReadCapacityUnits`** dans la colonne **Nom de la métrique**. Cochez la case en regard de cette ligne, puis choisissez **Sélectionner la métrique**.

1. Sous **Spécifier les métriques et les conditions**, dans le champ **Statistique**, sélectionnez **Somme**. Choisissez une **période** de **1 minute**.

1. Sous **Conditions**, spécifiez les éléments suivants :

   1. Pour **Threshold type** (Type de seuil), choisissez **Static** (Statique).

   1. Pour **Chaque fois que `ConsumedReadCapacityUnits` est**, choisissez **Supérieur à/Égal à** et spécifiez le seuil 240.

1. Choisissez **Suivant**.

1. Sous **Notification**, choisissez **`In alarm`** et sélectionnez une rubrique SNS à notifier lorsque l’alerte est en état `ALARM`.

1. Lorsque vous avez terminé, choisissez **Suivant**.

1. Saisissez le nom et la description de l’alarme, puis choisissez **Suivant**.

1. Dans **Prévisualiser et créer**, confirmez que les informations et les conditions sont telles que vous les voulez, puis choisissez **Créer une alarme**.

## Création d'une alarme dans le AWS CLI
<a name="Monitoring-metrics-creating-an-alarm-cli"></a>

```
aws cloudwatch put-metric-alarm \
    -\-alarm-name ReadCapacityUnitsLimitAlarm \
    -\-alarm-description "Alarm when read capacity reaches 80% of my provisioned read capacity" \
    -\-namespace AWS/DynamoDB \
    -\-metric-name ConsumedReadCapacityUnits \
    -\-dimensions Name=TableName,Value=myTable \
    -\-statistic Sum \
    -\-threshold 240 \
    -\-comparison-operator GreaterThanOrEqualToThreshold \
    -\-period 60 \                           
    -\-evaluation-periods 1 \
    -\-alarm-actions arn:aws:sns:us-east-1:123456789012:capacity-alarm
```

Testez l’alarme.

```
aws cloudwatch set-alarm-state -\-alarm-name ReadCapacityUnitsLimitAlarm -\-state-reason "initializing" -\-state-value OK
```

```
aws cloudwatch set-alarm-state -\-alarm-name ReadCapacityUnitsLimitAlarm -\-state-reason "initializing" -\-state-value ALARM
```

## Plus d'AWS CLI exemples
<a name="Monitoring-metrics-more-cli-examples"></a>

La procédure suivante décrit comment vous êtes averti si vos demandes dépassent les quotas de débit provisionnés pour une table.

1. Créez une rubrique Amazon SNS. `arn:aws:sns:us-east-1:123456789012:requests-exceeding-throughput` Pour plus d’informations, consultez [Configuration d’Amazon Simple Notification Service](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/US_SetupSNS.html).

1. Créez l’alerte.

   ```
   aws cloudwatch put-metric-alarm \
           -\-alarm-name ReadCapacityUnitsLimitAlarm \
           -\-alarm-description "Alarm when read capacity reaches 80% of my provisioned read capacity" \
           -\-namespace AWS/DynamoDB \
           -\-metric-name ConsumedReadCapacityUnits \
           -\-dimensions Name=TableName,Value=myTable \
           -\-statistic Sum \
           -\-threshold 240 \
           -\-comparison-operator GreaterThanOrEqualToThreshold \
           -\-period 60 \                           
           -\-evaluation-periods 1 \
           -\-alarm-actions arn:aws:sns:us-east-1:123456789012:capacity-alarm
   ```

1. Testez l’alarme.

   ```
   aws cloudwatch set-alarm-state --alarm-name RequestsExceedingThroughputAlarm --state-reason "initializing" --state-value OK
   ```

   ```
   aws cloudwatch set-alarm-state --alarm-name RequestsExceedingThroughputAlarm --state-reason "initializing" --state-value ALARM
   ```

La procédure suivante décrit comment vous êtes averti en cas d’erreur système.

1. Créez une rubrique Amazon SNS. `arn:aws:sns:us-east-1:123456789012:notify-on-system-errors` Pour plus d’informations, consultez [Configuration d’Amazon Simple Notification Service](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/US_SetupSNS.html).

1. Créez l’alerte.

   ```
   aws cloudwatch put-metric-alarm \
       --alarm-name SystemErrorsAlarm \
       --alarm-description "Alarm when system errors occur" \
       --namespace AWS/DynamoDB \
       --metric-name SystemErrors \
       --dimensions Name=TableName,Value=myTable Name=Operation,Value=aDynamoDBOperation \
       --statistic Sum \
       --threshold 0 \
       --comparison-operator GreaterThanThreshold \
       --period 60 \
       --unit Count \
       --evaluation-periods 1 \
       --treat-missing-data breaching \
       --alarm-actions arn:aws:sns:us-east-1:123456789012:notify-on-system-errors
   ```

1. Testez l’alarme.

   ```
   aws cloudwatch set-alarm-state --alarm-name SystemErrorsAlarm --state-reason "initializing" --state-value OK
   ```

   ```
   aws cloudwatch set-alarm-state --alarm-name SystemErrorsAlarm --state-reason "initializing" --state-value ALARM
   ```