CloudWatch informations fournies par les contributeurs pour DynamoDB : comment cela fonctionne - 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.

CloudWatch informations fournies par les contributeurs pour DynamoDB : comment cela fonctionne

Amazon DynamoDB s'intègre CloudWatch à Contributor Insights pour fournir des informations sur les éléments les plus consultés et les plus limités dans un tableau ou un index secondaire global. DynamoDB vous fournit ces informations CloudWatch via les règles, les rapports et les graphiques des données des rapports de Contributor Insights.

Pour plus d'informations sur CloudWatch Contributor Insights, consultez la section Utilisation de Contributor Insights pour analyser les données à cardinalité élevée dans le guide de CloudWatch l'utilisateur Amazon.

Les sections suivantes décrivent les concepts fondamentaux et le comportement de CloudWatch Contributor Insights for DynamoDB.

CloudWatch informations des contributeurs sur les règles DynamoDB

Lorsque vous activez CloudWatch Contributor Insights pour DynamoDB sur une table ou un index secondaire global, DynamoDB crée les règles suivantes en votre nom :

  • Éléments les plus utilisés (clé de partition) – Identifie les clés de partition des éléments les plus utilisés dans votre table ou index secondaire global.

    CloudWatch format du nom de règle : DynamoDBContributorInsights-PKC-[resource_name]-[creationtimestamp]

  • Clés les plus limitées (clé de partition) – Identifie les clés de partition des éléments les plus limités dans votre table ou index secondaire global.

    CloudWatch format du nom de règle : DynamoDBContributorInsights-PKT-[resource_name]-[creationtimestamp]

Note

Lorsque vous activez Contributor Insights sur votre table DynamoDB, vous êtes toujours soumis aux limites des règles de Contributor Insights. Pour de plus amples informations, veuillez consulter les Service Quotas CloudWatch .

Si votre table ou index secondaire global a une clé de tri, DynamoDB crée également les règles suivantes propres aux clés de tri :

  • Clés les plus utilisées (clés de partition et de tri) – Identifie les clés de partition et de tri des éléments les plus consultés dans votre table ou index secondaire global.

    CloudWatch format du nom de règle : DynamoDBContributorInsights-SKC-[resource_name]-[creationtimestamp]

  • Clés les plus limitées (clés de partition et de tri) – Identifie les clés de partition et de tri des éléments les plus limités dans votre table ou index secondaire global.

    CloudWatch format du nom de règle : DynamoDBContributorInsights-SKT-[resource_name]-[creationtimestamp]

Note
  • Vous ne pouvez pas utiliser la CloudWatch console ni APIs modifier ou supprimer directement les règles créées par CloudWatch Contributor Insights pour DynamoDB. La désactivation de CloudWatch Contributor Insights pour DynamoDB sur une table ou un index secondaire global supprime automatiquement les règles créées pour cette table ou cet index secondaire global.

  • Lorsque vous utilisez l'GetInsightRuleReportopération avec des règles CloudWatch Contributor Insights créées par DynamoDB, MaxContributorValue uniquement Maximum et que vous renvoyez des statistiques utiles. Les autres statistiques de cette liste ne renvoient pas de valeurs intéressantes.

  • CloudWatch Contributor Insights for DynamoDB est limité à 25 contributeurs. Si vous demandez plus de 25 contributeurs, une erreur s'affichera.

Vous pouvez créer des CloudWatch alarmes à l'aide des CloudWatch règles Contributor Insights for DynamoDB. Cela vous permet d'être prévenu lorsqu'un élément dépasse ou atteint un seuil spécifique pour ConsumedThroughputUnits ou ThrottleCount. Pour plus d'informations, voir Configuration d'une alarme sur les données métriques de Contributor Insights.

Comprendre les informations des CloudWatch contributeurs pour les graphes DynamoDB

CloudWatch Contributor Insights for DynamoDB affiche deux types de graphiques à la fois sur DynamoDB et sur les consoles : les éléments les plus consultés CloudWatch et les éléments les plus limités.

Éléments les plus consultés

Utilisez ce graphique pour identifier les éléments les plus consultés dans la table ou l'index secondaire global. Le graphique affiche ConsumedThroughputUnits sur l'axe y et le temps sur l'axe x. Chacune des clés N principales est affichée avec sa couleur et une légende sous l'axe x.

DynamoDB mesure la fréquence d'accès des clés en utilisant ConsumedThroughputUnits, qui mesure le trafic de lecture et d'écriture. ConsumedThroughputUnits est défini comme ce qui suit :

  • Approvisionné – (3 x unités de capacité d'écriture consommées) + unités de capacité de lecture consommées

  • À la demande – (3 x unités de demande d'écriture) + unités de demande d'écriture

Sur la console DynamoDB, chaque point de données du graphique représente la valeur ConsumedThroughputUnits maximum sur une période d'une minute. Par exemple, une valeur de graphique de 180 000 ConsumedThroughputUnits indique que l'élément a été consulté en continu au débit maximum par élément de 1 000 unités de demande d'écriture ou de 3 000 unités de demande de lecture pendant 60 secondes au cours de cette période d'une minute (3 000 x 60 secondes). En d'autres termes, les valeurs du graphique représentent la minute de trafic maximal pendant chaque période d'une minute. Vous pouvez modifier la granularité temporelle de la ConsumedThroughputUnits métrique (par exemple, pour afficher les métriques de 5 minutes au lieu d'une minute) sur la CloudWatch console.

Si vous voyez plusieurs lignes étroitement regroupées en cluster sans aberrations évidentes, cela indique que votre charge de travail est relativement équilibrée pour les éléments au cours de la période donnée. Si vous voyez des points isolés dans le graphique plutôt que des lignes reliées, cela indique qu'un élément a été consulté fréquemment uniquement pendant une courte période.

Si votre table ou votre index secondaire global comporte une clé de tri, DynamoDB crée deux graphiques : un pour les clés de partition les plus consultées et un autre pour la partition la plus consultée + les paires de clés de tri. Vous pouvez voir le trafic au niveau de la clé de partition dans le graphique clé de partition seulement. Vous pouvez voir le trafic au niveau de l'élément dans les graphiques clés de partition + tri.

Éléments les plus limités

Utilisez ce graphique pour identifier les éléments les plus limités dans la table ou l'index secondaire global. Le graphique affiche ThrottleCount sur l'axe y et le temps sur l'axe x. Chacune des N touches supérieures est affichée dans sa propre couleur, avec une légende affichée sous l'axe X.

DynamoDB mesure la fréquence de limitation à l'aide de ThrottleCount, c'est-à-dire le nombre d'erreurs ProvisionedThroughputExceededException, ThrottlingException et RequestLimitExceeded.

La limitation des écritures résultant d'une capacité d'écriture insuffisante pour un index secondaire global n'est pas mesurée. Vous pouvez utiliser le graphique Éléments les plus utilisés de l'index secondaire global pour identifier les modèles d'accès non équilibrés susceptibles de provoquer une limitation d'écriture. Pour plus d'informations, consultez la section Considérations relatives au débit provisionné pour les index secondaires globaux.

Sur la console DynamoDB, chaque point du graphique représente le nombre d'événements de limitation sur une période d'une minute.

Si vous ne voyez pas de données dans ce graphique, cela indique que vos demandes ne sont pas limitées. Si vous voyez des points isolés dans le graphique plutôt que des lignes reliées, cela indique qu'un élément a été fréquemment limité pendant une courte période.

Si votre table ou votre index secondaire global comporte une clé de tri, DynamoDB crée deux graphiques : un pour les clés de partition les plus limitées et un autre pour la partition la plus limitée + les paires de clés de tri. Vous pouvez voir le nombre de limitations au niveau du graphique avec la clé de partition seulement, et le nombre de limitations au niveau de l'élément dans les graphiques partition + clé de tri.

Exemples de rapports

Voici un exemple des rapports générés pour une table avec une clé de partition et une clé de tri.

4 rapports différents de Contributor Insights montrant les éléments les plus consultés et les éléments les plus limités.

Interactions avec d'autres fonctions DynamoDB

Les sections suivantes décrivent le comportement et l'interaction de CloudWatch Contributor Insights for DynamoDB avec plusieurs autres fonctionnalités de DynamoDB.

Tables globales

CloudWatch Contributor Insights for DynamoDB surveille les répliques de tables globales en tant que tables distinctes. Les graphiques Contributor Insights d'une réplique dans une AWS région peuvent ne pas présenter les mêmes modèles que ceux d'une autre région. En effet, les données d'écriture sont répliquées sur tous les réplicas dans une table globale, mais chaque réplica peut servir le trafic en lecture limité à la région.

DynamoDB Accelerator (DAX)

CloudWatch Contributor Insights for DynamoDB n'affiche pas DAX les réponses du cache. Il affiche uniquement les réponses à l'accès à une table ou à un index secondaire global.

Note

CCIDynamoDB ne prend pas en charge les requêtes PartiQL.

Chiffrement au repos

CloudWatch Contributor Insights for DynamoDB n'a aucune incidence sur le fonctionnement du chiffrement dans DynamoDB. Les données de clé primaire publiées dans CloudWatch sont cryptées avec le Clé détenue par AWS. Cependant, DynamoDB prend également en charge la clé et une clé gérée Clé gérée par AWS par le client.

CloudWatch Les graphiques Contributor Insights for DynamoDB affichent la clé de partition et la clé de tri (le cas échéant) des éléments fréquemment consultés et des éléments fréquemment limités en texte brut. Si vous avez besoin de AWS Key Management Service (KMS) pour chiffrer la clé de partition de cette table et trier les données clés à l'aide d'une Clé gérée par AWS clé gérée par le client, vous ne devez pas activer CloudWatch Contributor Insights for DynamoDB pour cette table.

Si vous souhaitez que les données de votre clé primaire soient chiffrées à l'aide de la clé Clé gérée par AWS ou d'une clé gérée par le client, vous ne devez pas activer CloudWatch Contributor Insights for DynamoDB pour cette table.

Contrôle précis des accès

CloudWatch Contributor Insights for DynamoDB ne fonctionne pas différemment pour les tables dotées d'un contrôle d'accès précis (). FGAC En d'autres termes, tout utilisateur disposant des CloudWatch autorisations appropriées peut afficher les clés primaires FGAC protégées dans les graphiques de CloudWatch Contributor Insights.

Si la clé primaire de la table contient des données FGAC protégées sur lesquelles vous ne souhaitez pas publier CloudWatch, vous ne devez pas activer CloudWatch Contributor Insights for DynamoDB pour cette table.

Contrôle d’accès

Vous contrôlez l'accès à CloudWatch Contributor Insights for DynamoDB à AWS Identity and Access Management l'aide de IAM () en limitant les autorisations du plan de contrôle DynamoDB et les autorisations du plan de données. CloudWatch Pour plus d'informations, voir Utilisation IAM avec CloudWatch Contributor Insights pour DynamoDB.

CloudWatch informations sur les contributeurs pour la facturation DynamoDB

Les frais associés à CloudWatch Contributor Insights for DynamoDB figurent dans CloudWatchla section de votre facture mensuelle. Ces frais sont calculés en fonction du nombre d'événements de DynamoDB traités. Pour les tables et les index secondaires globaux sur lesquels CloudWatch Contributor Insights for DynamoDB est activé, chaque élément écrit ou lu via une opération de plan de données représente un événement.

Si une table ou un index secondaire global inclut une clé de tri, chaque élément lu ou écrit représente deux événements. Ceci s'explique par le fait que DynamoDB identifie les principaux contributeurs de séries chronologiques distinctes : une pour les clés de partitions uniquement, et une pour les paires de clés de partition et de tri.

Par exemple, supposons que votre application effectue les opérations DynamoDB suivantes : GetItem, PutItem et BatchWriteItem qui insère 5 éléments.

  • Si votre table ou votre index secondaire global n'a qu'une clé de partition, cela se traduit par 7 événements (1 pour l'opération GetItem, 1 pour PutItem et 5 pour BatchWriteItem).

  • Si votre table ou votre index secondaire global a une clé de partition et une clé de tri, cela se traduit par 14 événements (2 pour l'opération GetItem, 2 pour PutItem et 10 pour BatchWriteItem).

  • Une opération Query génère toujours 1 événement, quel que soit le nombre d'éléments retournés.

Contrairement aux autres fonctionnalités de DynamoDB CloudWatch , la facturation de Contributor Insights for DynamoDB ne varie pas en fonction des éléments suivants :

  • Le mode de capacité (allouée par rapport à la demande)

  • Selon que vous exécutiez des requêtes en lecture ou en écriture

  • La taille (Ko) des éléments lus ou écrits