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.
# Commencer à utiliser CloudWatch Contributor Insights pour DynamoDB
Cette section explique comment activer et utiliser Amazon CloudWatch Contributor Insights dans différents modes pour répondre à vos besoins de surveillance à l'aide de la console Amazon DynamoDB ou AWS Command Line Interface du ().AWS CLI
Dans les exemples suivants, vous utilisez la table DynamoDB qui est définie dans le didacticiel [Mise en route avec DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/GettingStartedDynamoDB.html).
**Topics**
+ [Choix d’un mode Contributor Insights](#contributorinsights_tutorial.modes)
+ [Utilisation de Contributor Insights (console)](#usecontributorinsights_console)
+ [Utilisation de Contributor Insights (AWS CLI)](#usecontributorinsights_cli)
## Choix d’un mode Contributor Insights
Avant d’activer Contributor Insights, vous devez connaître les deux modes disponibles. Passez en revue la comparaison des modes pour sélectionner l’option qui correspond le mieux à vos besoins spécifiques.
| Aspect | Mode clés consultées et limitées | Mode clés limitées |
| --- | --- | --- |
| Moniteurs | Toutes les demandes (réussies et limitées) | Demandes en mode limité uniquement |
| Graphiques | Éléments ayant le plus grand nombre d’accès \$1 Éléments les plus limités | Éléments les plus limités uniquement |
| Idéal pour | Analyse et optimisation ciblées | Surveillance de la limitation |
| À utiliser lorsque | Vous avez besoin d’une visibilité complète sur les modèles d’accès. Vous effectuez une analyse ou un débogage à court terme. | Votre principale préoccupation est d’identifier et de résoudre les problèmes de limitation. Vous souhaitez que Contributor Insights reste activé en permanence pour les alertes de limitation en temps réel. |
## Utilisation de Contributor Insights (console)
La console fournit un moyen intuitif d’activer Contributor Insights et de sélectionner le mode approprié à vos besoins de surveillance.
**Pour utiliser Contributor Insights dans la console**
1. Connectez-vous à la console DynamoDB AWS Management Console et ouvrez-la à l'adresse. [https://console.aws.amazon.com/dynamodb/](https://console.aws.amazon.com/dynamodb/)
1. Dans le volet de navigation sur le côté gauche de la console, choisissez **Tables**.
1. Choisissez la table `Music`.
1. Choisissez l’onglet **Surveiller**.
1. Choisissez **Activer CloudWatch Contributor Insights**.
![\[Capture d’écran de la console illustrant l’onglet et le bouton Contrôler.\]](http://docs.aws.amazon.com/fr_fr/amazondynamodb/latest/developerguide/images/CI_ChooseAndManageNew.PNG)
1. Dans la boîte de dialogue **des paramètres de gestion des informations sur les CloudWatch contributeurs****, activez** l'option Activer à la fois pour la table de `Music` base et pour l'index secondaire `AlbumTitle-index` global.
1. Laissez le commutateur **Mode clés limitées uniquement** en position désactivée pour les deux, puis sélectionnez **Enregistrer les modifications**.
![\[Capture d’écran de la console montrant les options de la liste d’états de Contributor Insights.\]](http://docs.aws.amazon.com/fr_fr/amazondynamodb/latest/developerguide/images/CI_Enable.png)
Cela active le mode *clés consultées et limitées* par défaut pour la table et le GSI, qui permet de surveiller les éléments consultés et limités. Placer le commutateur du **Mode clés limitées uniquement** en position activée permettrait d’activer le mode *clés limitées*.
Si l'opération échoue, consultez [DescribeContributorInsights FailureException](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DescribeContributorInsights.html#DDB-DescribeContributorInsights-response-FailureException)le manuel *Amazon DynamoDB API* Reference pour connaître les raisons possibles.
1. Les graphiques de CloudWatch Contributor Insights sont désormais visibles dans l'onglet **Surveiller** du `Music` tableau. Comme vous avez activé le mode *clés consultées et limitées*, vous voyez à la fois les graphiques des éléments consultés et des éléments limités.
![\[Capture d’écran de la console montrant l’onglet Contributor Insights avec plusieurs graphiques pour la table Musique.\]](http://docs.aws.amazon.com/fr_fr/amazondynamodb/latest/developerguide/images/CI_Graphs.png)
### Basculement entre les modes
Vous pouvez passer d’un mode à l’autre à tout moment sans désactiver Contributor Insights.
**Pour basculer entre les modes de Contributor Insights**
1. Dans l'onglet **Surveiller** de votre tableau, choisissez **Gérer les informations sur les CloudWatch contributeurs**.
1. Dans la boîte de dialogue **des paramètres de gestion des informations sur les contributeurs**, pour chaque table de base ou GSIs :
+ Activez ou désactivez le **Mode clés limitées uniquement** pour activer le mode *clés limitées* ou revenez au mode *clés consultées et limitées* par défaut.
+ **Activez ou désactivez pour désactiver CloudWatch Contributor Insight pour une table ou un GSI.**
1. Sélectionnez **Enregistrer les modifications**.
Une fois que vous avez terminé, les graphiques reflètent le nouveau mode.
### Création d' CloudWatch alarmes
Suivez ces étapes pour créer une CloudWatch alarme et être averti lorsqu'une clé de partition consomme plus de 50 000 unités [ConsumedThroughputUnits](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/contributorinsights_HowItWorks.html#contributorinsights_HowItWorks.Graphs.most-accessed)ou subit un ralentissement.
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 situé sur le côté gauche de la console, choisissez **Contributor Insights**.
1. Choisissez la règle appropriée en fonction de votre mode et de ce que vous souhaitez surveiller :
+ **Pour la surveillance des éléments consultés (mode touches accessibles et limitées uniquement) : choisissez Dynamo Insights-PKC-Music DBContributor**
+ **Pour la surveillance limitée des objets (les deux modes) : choisissez Dynamo Insights-PKT-Music DBContributor**
1. Choisissez la liste déroulante **Actions**.
1. Choisissez **View in metrics (Afficher dans les métriques)**.
1. Choisissez **Max Contributor Value (Valeur maximale du contributeur)**.
**Note**
Seules `Max Contributor Value` et `Maximum` renvoient des statistiques utiles. Les autres statistiques de cette liste ne renvoient pas de valeurs intéressantes.
![\[Capture d’écran de la console montrant l’onglet et le bouton Contributor Insights.\]](http://docs.aws.amazon.com/fr_fr/amazondynamodb/latest/developerguide/images/CI_AlarmsViewinMetrics.png)
1. Dans la colonne **Actions** choisissez **Create Alarm (Créer une alarme)**.
![\[Capture d’écran de la console montrant les options de la liste d’états de Contributor Insights.\]](http://docs.aws.amazon.com/fr_fr/amazondynamodb/latest/developerguide/images/CI_AlarmsSetAlarm.png)
1. Entrez une valeur de seuil appropriée et choisissez **Suivant** :
+ Pour les éléments consultés (règles PKC) : entrez 50 000 pour `ConsumedThroughputUnits`.
+ Pour les éléments limités (règles PKT) : entrez 1 pour `ThrottleCount` pour être alerté en cas de limitation.
![\[Capture d’écran de la console montrant l’onglet et le bouton Contributor Insights.\]](http://docs.aws.amazon.com/fr_fr/amazondynamodb/latest/developerguide/images/CI_AlarmsSetAlarmThreashold.png)
1. Consultez la section [Utilisation des CloudWatch alarmes Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) pour plus de détails sur la configuration de la notification pour l'alarme.
## Utilisation de Contributor Insights (AWS CLI)
AWS CLI Fournit un accès programmatique à Contributor Insights avec un support complet pour les deux modes. Vous pouvez spécifier le mode lorsque vous activez Contributor Insights ou changer de mode ultérieurement.
### Opérations de base avec le mode par défaut
**Pour utiliser Contributor Insights avec les paramètres par défaut**
1. Activez CloudWatch Contributor Insights pour DynamoDB sur `Music` la table de base avec *le mode touches accessibles et limitées*. Comme `ACCESSED_AND_THROTTLED_KEYS` est le mode par défaut, vous pouvez omettre le paramètre `--contributor-insights-mode=ACCESSED_AND_THROTTLED_KEYS`.
```
aws dynamodb update-contributor-insights \
--table-name Music \
--contributor-insights-action=ENABLE
```
1. Activez Contributor Insights pour DynamoDB sur l’index secondaire global `AlbumTitle-index`.
```
aws dynamodb update-contributor-insights \
--table-name Music \
--index-name AlbumTitle-index \
--contributor-insights-action=ENABLE
```
1. Obtenez le statut et les règles pour la table `Music` et tous ses index.
```
aws dynamodb describe-contributor-insights
--table-name Music
```
La réponse inclura le champ `ContributorInsightsMode` indiquant `ACCESSED_AND_THROTTLED_KEYS`.
1. Répertoriez l’état de la table `Music` ainsi que de tous ses index.
```
aws dynamodb list-contributor-insights --table-name Music
```
### Activation du mode clés limitées
**Pour activer Contributor Insights en mode clés limitées**
1. *Activez CloudWatch Contributor Insights pour DynamoDB sur `Music` la table de base en mode touches limitées.*
```
aws dynamodb update-contributor-insights \
--table-name Music \
--contributor-insights-action=ENABLE \
--contributor-insights-mode=THROTTLED_KEYS
```
1. Activez Contributor Insights en mode *clés limitées* pour l’index secondaire global `AlbumTitle-index`.
```
aws dynamodb update-contributor-insights \
--table-name Music \
--index-name AlbumTitle-index \
--contributor-insights-action=ENABLE \
--contributor-insights-mode=THROTTLED_KEYS
```
1. Vérifiez le mode en décrivant la configuration de Contributor Insights.
```
aws dynamodb describe-contributor-insights --table-name Music
```
La réponse affichera `ContributorInsightsMode` comme `THROTTLED_KEYS` et indiquera moins de règles que le mode par défaut.
### Basculement entre les modes
**Pour basculer entre les modes de Contributor Insights**
1. Passez du mode *clés limitées* au mode *clés consultées et limitées*.
```
aws dynamodb update-contributor-insights \
--table-name Music \
--contributor-insights-action=ENABLE \
--contributor-insights-mode=ACCESSED_AND_THROTTLED_KEYS
```
1. Passez du mode *clés consultées et limitées* au mode *clés limitées*.
```
aws dynamodb update-contributor-insights \
--table-name Music \
--contributor-insights-action=ENABLE \
--contributor-insights-mode=THROTTLED_KEYS
```
1. Vérifiez l’état pendant la transition.
```
aws dynamodb describe-contributor-insights --table-name Music
```
Pendant le changement de mode, l’état `ContributorInsightsStatus` indiquera `ENABLING`. Une fois l’opération terminée, il apparaîtra comme `ENABLED` avec le nouveau mode.
### Gestion de Contributor Insights
**Pour gérer les paramètres de Contributor Insights**
1. Désactivez CloudWatch Contributor Insights pour DynamoDB sur `AlbumTitle-index` l'index secondaire global.
```
aws dynamodb update-contributor-insights \
--table-name Music --index-name AlbumTitle-index \
--contributor-insights-action=DISABLE
```
1. Répertoriez toutes les configurations de Contributor Insights de votre compte.
```
aws dynamodb list-contributor-insights
```
Cela affiche toutes les tables et tous les index pour lesquels Contributor Insights est activé, ainsi que leurs modes.
1. Obtenez des informations détaillées sur une configuration spécifique.
```
aws dynamodb describe-contributor-insights \
--table-name Music \
--index-name AlbumTitle-index
```
### Exemple de réponses
Voici des exemples de réponses illustrant les différences entre les modes :
#### Réponse en mode clés consultées et limitées
```
{
"TableName": "Music",
"ContributorInsightsRuleList": [
"DynamoDBContributorInsights-PKC-Music-1234567890123",
"DynamoDBContributorInsights-PKT-Music-1234567890123",
"DynamoDBContributorInsights-SKC-Music-1234567890123",
"DynamoDBContributorInsights-SKT-Music-1234567890123"
],
"ContributorInsightsStatus": "ENABLED",
"ContributorInsightsMode": "ACCESSED_AND_THROTTLED_KEYS",
"LastUpdateDateTime": "2024-01-15T10:30:00.000Z"
}
```
#### Réponse en mode clés limitées
```
{
"TableName": "Music",
"ContributorInsightsRuleList": [
"DynamoDBContributorInsights-PKT-Music-1234567890123",
"DynamoDBContributorInsights-SKT-Music-1234567890123"
],
"ContributorInsightsStatus": "ENABLED",
"ContributorInsightsMode": "THROTTLED_KEYS",
"LastUpdateDateTime": "2024-01-15T10:35:00.000Z"
}
```
Notez que le mode clés limitées comporte moins de règles (uniquement PKT et SKT), ce qui correspond à une surveillance plus ciblée.