Mise en route avec CloudWatch Contributor Insights for DynamoDB

Pour utiliser Contributor Insights dans la console

1. Connectez-vous à l’AWS Management Console et ouvrez la console DynamoDB à l’adresse https://console.aws.amazon.com/dynamodb/.

2. Dans le volet de navigation sur le côté gauche de la console, choisissez Tables.

3. Choisissez la table Music.

4. Choisissez l’onglet Surveiller.

5. Choisissez Activer CloudWatch Contributor Insights.

   

6. Dans la boîte de dialogue Gérer les paramètres de CloudWatch Contributor Insights, activez l’option Activer à la fois pour la table de base Music et pour l’index secondaire global AlbumTitle-index.

7. Laissez le commutateur Mode clés limitées uniquement en position désactivée pour les deux, puis sélectionnez Enregistrer les modifications.

   

   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 dans la Référence d’API Amazon DynamoDB afin de connaître les raisons possibles.

8. Les graphiques CloudWatch Contributor Insights sont désormais visibles sur l’onglet Contrôle pour la table Music. 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.

   

Pour basculer entre les modes de Contributor Insights

1. Dans l’onglet Contrôle de votre table, choisissez Gérer CloudWatch Contributor Insights.

2. Dans la boîte de dialogue Gérer les paramètres de Contributor Insights, pour chaque table de base ou GSI :

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

   • Basculez l’option Activer sur désactivé pour désactiver CloudWatch Contributor Insights pour une table ou un GSI.

3. Sélectionnez Enregistrer les modifications.

   Une fois que vous avez terminé, les graphiques reflètent le nouveau mode.

Suivez ces étapes pour créer une alarme CloudWatch et être averti lorsqu’une clé de partition consomme plus de 50 000 ConsumedThroughputUnits ou rencontre une limitation.

1. Connectez-vous à AWS Management Console et ouvrez la console CloudWatch à l’adresse https://console.aws.amazon.com/cloudwatch/

2. Dans le panneau de navigation situé sur le côté gauche de la console, choisissez Contributor Insights.

3. 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 clés consultées et limitées uniquement) : choisissez DynamoDBContributorInsights-PKC-Music.

   • Pour la surveillance des éléments limités (les deux modes) : choisissez DynamoDBContributorInsights-PKT-Music.

4. Choisissez la liste déroulante Actions.

5. Choisissez View in metrics (Afficher dans les métriques).

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

   

7. Dans la colonne Actions choisissez Create Alarm (Créer une alarme).

   

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

   

9. Consultez Utilisation des alarmes Amazon CloudWatch pour plus d’informations sur la manière de configurer la notification d’alarme.

Pour utiliser Contributor Insights avec les paramètres par défaut

1. Activez CloudWatch Contributor Insights for DynamoDB sur la table de base Music avec le mode clés consultées 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

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

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

4. Répertoriez l’état de la table Music ainsi que de tous ses index.

   aws dynamodb list-contributor-insights --table-name Music

Pour activer Contributor Insights en mode clés limitées

1. Activez CloudWatch Contributor Insights for DynamoDB sur la table de base Music avec le mode clés limitées.

   aws dynamodb update-contributor-insights \
       --table-name Music \
       --contributor-insights-action=ENABLE \
       --contributor-insights-mode=THROTTLED_KEYS

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

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

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

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

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

Pour gérer les paramètres de Contributor Insights

1. Désactivez CloudWatch 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=DISABLE

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

3. Obtenez des informations détaillées sur une configuration spécifique.

   aws dynamodb describe-contributor-insights \
                       --table-name Music \
                       --index-name AlbumTitle-index