View a markdown version of this page

Démarrez avec CloudWatch Contributor Insights pour DynamoDB - Amazon DynamoDB

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.

Démarrez avec CloudWatch Contributor Insights pour DynamoDB

Cette section explique comment activer et utiliser Amazon CloudWatch Contributor Insights dans différents modes afin de répondre à vos besoins de surveillance à l'aide de la console Amazon DynamoDB ou du AWS Command Line Interface ()AWS CLI.

Dans les exemples suivants, vous utilisez la table DynamoDB qui est définie dans le didacticiel Mise en route avec DynamoDB.

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 + É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 à Console de gestion AWS 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.

    Capture d’écran de la console illustrant l’onglet et le bouton Contrôler.
  6. 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.

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

    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 la référence DescribeContributorInsights FailureException de l'API Amazon DynamoDB pour connaître les raisons possibles.

  8. Les graphiques CloudWatch Contributor Insights sont désormais visibles dans l'onglet Monitor 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.

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.

  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.

    • Activez ou désactivez pour désactiver CloudWatch Contributor Insight pour un tableau ou un GSI.

  3. Sélectionnez Enregistrer les modifications.

    Une fois cette opération terminée, les graphiques refléteront 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 en consomme plus de 50 000 ConsumedThroughputUnits ou est ralentie.

  1. Connectez-vous à la console Console de gestion AWS et ouvrez la CloudWatch console à 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 touches accessibles et touches limitées uniquement) : choisissez DynamoDBContributorInsights-PKC-Music

    • Pour la surveillance des objets restreints (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.

    Capture d’écran de la console montrant l’onglet et le bouton Contributor Insights.
  7. 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.
  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.

    Capture d’écran de la console montrant l’onglet et le bouton Contributor Insights.
  9. Consultez la section Utilisation CloudWatch des alarmes Amazon pour plus de détails sur la configuration de la notification associée à l'alarme.

Utilisation de Contributor Insights (AWS CLI)

AWS CLI Il fournit un accès programmatique à Contributor Insights avec une prise en charge complète des 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 dans la table Music de base à l'aide du 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
  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

Activation du mode clés limitées

Pour activer Contributor Insights en mode clés limitées
  1. Activez CloudWatch Contributor Insights pour DynamoDB dans le tableau Music de base en mode touches 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.

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
  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 cette opération terminée, il s'affichera comme ENABLED dans 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 l'index secondaire AlbumTitle-index global.

    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

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.