Commencer à utiliser CloudWatch Contributor Insights pour DynamoDB - Amazon DynamoDB
Choisir un mode Contributor InsightsUtilisation de Contributor Insights (console)Utilisation de Contributor Insights (AWS CLI)

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.

Choisir 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 touches accessibles et limitées Mode touches limitées
Moniteurs Toutes les demandes (réussies et limitées) Demandes limitées uniquement
Graphiques Articles les plus consultés + Articles les plus limités La plupart des objets limités uniquement
Idéal pour Analyse et optimisation ciblées Surveillance de l'étranglement
À 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 régulation. Vous souhaitez que Contributor Insights reste activé en permanence pour les alertes de régulation 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/

  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 mode Touches limitées uniquement en position désactivée pour les deux, puis choisissez Enregistrer les modifications.

    Capture d'écran de la console montrant les options de la liste d'états de Contributor Insights.

    Cela active le mode touches accessibles et limitées par défaut pour la table et le GSI, qui permet de surveiller à la fois les éléments accessibles et limités. Le fait de passer le mode touches limitées uniquement à la position activée activerait le mode touches d'étranglement.

    Si l'opération échoue, consultez DescribeContributorInsights FailureExceptionle manuel Amazon DynamoDB API Reference pour connaître les raisons possibles.

  8. Les graphiques de CloudWatch Contributor Insights sont désormais visibles dans l'onglet Surveiller du Music tableau. Depuis que vous avez activé le mode touches accessibles et limitées, vous pouvez voir les graphiques des éléments accessibles et limités.

    Capture d'écran de la console montrant l'onglet Contributor Insights avec plusieurs graphiques pour la table Musique.

Basculer entre les modes

Vous pouvez passer d'un mode à l'autre à tout moment sans désactiver Contributor Insights.

Pour changer de mode 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 des paramètres de gestion des informations sur les contributeurs, pour chaque table de base ou GSIs :

    • Activez ou désactivez le mode touches limitées uniquement pour activer le mode touches limitées ou revenez au mode touches limitées par défaut.

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

  3. Sélectionnez Enregistrer les modifications.

    Une fois terminé, 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 consomme plus de 50 000 unités ConsumedThroughputUnitsou subit un ralentissement.

  1. Connectez-vous à la CloudWatch console AWS Management Console et ouvrez-la à 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 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

  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 Next :

    • Pour les articles consultés (règles PKC) : Entrez 50 000 pour ConsumedThroughputUnits

    • Pour les objets limités (règles PKT) : entrez 1 pour être alerté ThrottleCount en cas de limitation

    Capture d'écran de la console montrant l'onglet et le bouton Contributor Insights.

  9. Consultez la section Utilisation des CloudWatch alarmes Amazon 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 il s'agit du mode par défaut, vous pouvez omettre le --contributor-insights-mode=ACCESSED_AND_THROTTLED_KEYS paramètre.

    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 ContributorInsightsMode champ affichéACCESSED_AND_THROTTLED_KEYS.

  4. Répertoriez l'état de la Music table et de tous ses index.

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

Activation du mode touches limitées

Pour activer Contributor Insights en mode touches 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

  2. Activez Contributor Insights en mode touches limitées pour l'index secondaire AlbumTitle-index global.

    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 autant THROTTLED_KEYS de règles que le mode par défaut.

Basculer entre les modes

Pour changer de mode Contributor Insights

  1. Passez du mode touches limitées au mode touches accessibles 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 touches accessibles et limitées au mode touches limitées.

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

  3. Vérifiez le statut pendant la transition.

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

    Pendant le changement de mode, le ContributorInsightsStatus s'affichera sous la formeENABLING. Une fois terminé, il s'affichera comme ENABLED dans le nouveau mode.

Gestion des informations sur les contributeurs

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

  2. Répertoriez toutes les configurations de Contributor Insights dans votre compte.

    aws dynamodb list-contributor-insights

    Cela montre 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

Exemples de réponses

Voici des exemples de réponses illustrant les différences entre les modes :

Réponse en mode touches accessibles 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 touches 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 touches limitées comporte moins de règles (uniquement PKT et SKT), ce qui correspond à une surveillance plus ciblée.