Erste Schritte mit CloudWatch Contributor Insights für DynamoDB - Amazon DynamoDB

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Erste Schritte mit CloudWatch Contributor Insights für DynamoDB

In diesem Abschnitt wird beschrieben, wie Sie mit der Amazon-DynamoDB-Konsole oder der AWS Command Line Interface (AWS CLI) Amazon CloudWatch Contributor Insights in unterschiedlichen Modi verwenden, um Ihre Überwachungsanforderungen zu erfüllen.

In den folgenden Beispielen verwenden Sie die DynamoDB-Tabelle, die im Erste-Schritte-mit-DynamoDB-Tutorial definiert ist.

Auswählen eines Contributor-Insights-Modus

Bevor Sie Contributor Insights aktivieren, sollten Sie sich mit den beiden verfügbaren Modi vertraut machen. Sehen Sie sich den Vergleich der Modi an, um die Option auszuwählen, die Ihren spezifischen Anforderungen am besten entspricht.

Aspekt Modus für Schlüssel mit Zugriffen und Drosselungen Modus für gedrosselte Schlüssel
Monitore Alle Anforderungen (erfolgreich und gedrosselt) Nur gedrosselte Anforderungen
Diagramme Elemente mit den meisten Zugriffen + Elemente mit den meisten Drosselungen Nur Elemente mit den meisten Drosselungen
Am besten geeignet für Gezielte Analyse und Optimierung Überwachung der Drosselung
Anwendungsfall Sie benötigen einen vollständigen Einblick in die Zugriffsmuster. Sie führen kurzfristige Analysen oder Debugging durch. Ihr Hauptanliegen ist die Identifizierung und Lösung von Drosselungsproblemen. Sie möchten Contributor Insights kontinuierlich aktiviert lassen, um in Echtzeit Warnungen zu Drosselungen zu erhalten.

Verwenden von Contributor Insights (Konsole)

Die Konsole bietet eine intuitive Möglichkeit, Contributor Insights zu aktivieren und den für Ihre Überwachungsanforderungen geeigneten Modus auszuwählen.

So verwenden Sie Contributor Insights in der Konsole
  1. Melden Sie sich bei AWS-Managementkonsole an und öffnen Sie die DynamoDB-Konsole unter https://console.aws.amazon.com/dynamodb/.

  2. Klicken Sie im Navigationsbereich auf der linken Seite der Konsole auf Tables (Tabellen).

  3. Wählen Sie die Music Tabelle aus.

  4. Wählen Sie den Tab Überwachung.

  5. Wählen Sie CloudWatch Contributor Insights einschalten aus.

    Screenshot der Konsole mit der Registerkarte und Schaltfläche „Überwachen“.
  6. Aktivieren Sie im Dialogfeld Einstellungen für CloudWatch Contributor Insights verwalten die Option Einschalten sowohl für die Music-Basistabelle als auch für den globalen sekundären AlbumTitle-index-Index.

  7. Lassen Sie den Schalter Nur gedrosselter Schlüsselmodus für beide deaktiviert und wählen Sie dann Änderungen speichern aus.

    Konsolen-Screenshot mit den Optionen für die Statusliste von Contributor Insights.

    Dadurch wird der Standardmodus für Schlüssel mit Zugriffen und Drosselungen sowohl für die Tabelle als auch für den GSI aktiviert, was eine Überwachung sowohl der aufgerufenen als auch der gedrosselten Elemente ermöglicht. Wenn Sie den Schalter Nur gedrosselter Schlüsselmodus auf „Ein“ festlegen, würde der Modus für gedrosselte Schlüssel aktiviert.

    Wenn der Vorgang fehlschlägt, finden Sie mögliche Gründe unter DescribeContributorInsights FailureException in der Amazon-DynamoDB-API-Referenz.

  8. Die Diagramme für CloudWatch Contributor Insights werden jetzt auf der Registerkarte Überwachen für die Music-Tabelle angezeigt. Da Sie den Modus für Schlüssel mit Zugriffen und Drosselungen aktiviert haben, werden Ihnen sowohl Diagramme für aufgerufene als auch für gedrosselte Elemente angezeigt.

    Konsolen-Screenshot mit der Registerkarte „Contributor Insights“ mit mehreren Grafiken für die Musiktabelle.

Wechseln zwischen den Modi

Sie können jederzeit zwischen den Modi wechseln, ohne Contributor Insights zu deaktivieren.

So wechseln Sie zwischen Contributor-Insights-Modi
  1. Wählen Sie auf der Registerkarte Überwachen Ihrer Tabelle die Option CloudWatch Contributor Insights verwalten aus.

  2. Gehen Sie im Dialogfeld Einstellungen für Contributor Insights verwalten für die einzelnen Basistabellen oder GSIs wie folgt vor:

    • Schalten Sie Nur gedrosselter Schlüsselmodus ein oder aus, um den Modus für gedrosselte Schlüssel zu aktivieren oder zurück zum Modus für Schlüssel mit Zugriffen und Drosselungen zu wechseln.

    • Deaktivieren Sie Einschalten, um CloudWatch Contributor Insight für eine Tabelle oder einen GSI zu deaktivieren.

  3. Wählen Sie Änderungen speichern aus.

    Sobald der Vorgang abgeschlossen ist, spiegeln die Diagramme den neuen Modus wider.

Erstellen von CloudWatch-Alarmen

Führen Sie diese Schritte aus, um einen CloudWatch-Alarm zu erstellen und benachrichtigt zu werden, wenn ein Partitionsschlüssel mehr als 50 000 ConsumedThroughputUnits verbraucht oder gedrosselt wird.

  1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die CloudWatch-Konsole unter https://console.aws.amazon.com/cloudwatch/.

  2. Klicken Sie im Navigationsbereich links in der Konsole auf Contributor Insights.

  3. Wählen Sie je nach Modus und dem, was Sie überwachen möchten, die entsprechende Regel aus:

    • Überwachung von Objekten, auf die zugegriffen wurde (nur Modus für Schlüssel mit Zugriffen und Drosselungen): Wählen Sie DynamoDBContributorInsights-PKC-Music aus.

    • Für die Überwachung gedrosselter Elemente (beide Modi): Wählen Sie DynamoDBContributorInsights-PKT-Music aus.

  4. Wählen Sie die Dropdown-Liste Actions (Aktionen).

  5. Wählen Sie View in metrics (In Metriken anzeigen).

  6. Wählen Sie Max Contributor Value.

    Anmerkung

    Nur Max Contributor Value und Maximum geben nützliche Statistiken zurück. Die anderen Statistiken in dieser Liste geben keine sinnvollen Werte zurück.

    Konsolen-Screenshot mit Registerkarte und Schaltfläche Contributor Insights.
  7. Wählen Sie in der Spalte Actions (Aktionen)die Option Create Alarm (Alarm erstellen).

    Konsolen-Screenshot mit Statuslistenoptionen für Contributor Insights.
  8. Geben Sie einen geeigneten Schwellenwert ein und klicken Sie auf Weiter:

    • Elemente mit Zugriffen (PKC-Regeln): Geben Sie 50 000 für ConsumedThroughputUnits ein.

    • Gedrosselte Elemente (PKT-Regeln): Geben Sie 1 für ThrottleCount ein, um bei jeder Drosselung gewarnt zu werden.

    Konsolen-Screenshot mit Registerkarte und Schaltfläche Contributor Insights.
  9. Weitere Informationen zur Konfiguration der Benachrichtigung für den Alarm finden Sie unter Verwenden von Amazon CloudWatch-Alarmen.

Verwenden von Contributor Insights (AWS CLI)

Die AWS CLI bietet programmgesteuerten Zugriff auf Contributor Insights mit vollständiger Unterstützung für beide Modi. Sie können den Modus angeben, wenn Sie Contributor Insights aktivieren, oder später zwischen den Modi wechseln.

Grundlegende Operationen im Standardmodus

So verwenden Sie Contributor Insights mit Standardeinstellungen
  1. Aktivieren Sie CloudWatch Contributor Insights für DynamoDB in der Music-Basistabelle mit dem Modus für Schlüssel mit Zugriffen und Drosselungen. Da ACCESSED_AND_THROTTLED_KEYS der Standardmodus ist, können Sie den --contributor-insights-mode=ACCESSED_AND_THROTTLED_KEYS-Parameter weglassen.

    aws dynamodb update-contributor-insights \ --table-name Music \ --contributor-insights-action=ENABLE
  2. Aktivieren Sie Contributor Insights for DynamoDB auf dem AlbumTitle-index globalen sekundären Index.

    aws dynamodb update-contributor-insights \ --table-name Music \ --index-name AlbumTitle-index \ --contributor-insights-action=ENABLE
  3. Rufen Sie den Status und die Regeln für die Music-Tabelle und alle seine Indizes auf.

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

    Die Antwort enthält das ContributorInsightsMode-Feld mit ACCESSED_AND_THROTTLED_KEYS.

  4. Listen Sie den Status der Music-Tabelle und aller ihrer Indizes auf.

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

Aktivieren des Modus für gedrosselte Schlüssel

So aktivieren Sie Contributor Insights im Modus für gedrosselte Schlüssel
  1. Aktivieren Sie CloudWatch Contributor Insights für DynamoDB in der Music-Basistabelle mit dem Modus für gedrosselte Schlüssel.

    aws dynamodb update-contributor-insights \ --table-name Music \ --contributor-insights-action=ENABLE \ --contributor-insights-mode=THROTTLED_KEYS
  2. Aktivieren Sie Contributor Insights im Modus für gedrosselte Schlüssel für den globalen sekundären AlbumTitle-index-Index.

    aws dynamodb update-contributor-insights \ --table-name Music \ --index-name AlbumTitle-index \ --contributor-insights-action=ENABLE \ --contributor-insights-mode=THROTTLED_KEYS
  3. Überprüfen Sie den Modus, indem Sie die Contributor-Insights-Konfiguration beschreiben.

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

    In der Antwort werden ContributorInsightsMode als THROTTLED_KEYS und weniger Regeln als im Standardmodus angezeigt.

Wechseln zwischen den Modi

So wechseln Sie zwischen Contributor-Insights-Modi
  1. Wechseln Sie vom Modus für gedrosselte Schlüssel in den Modus für Schlüssel mit Zugriffen und Drosselungen.

    aws dynamodb update-contributor-insights \ --table-name Music \ --contributor-insights-action=ENABLE \ --contributor-insights-mode=ACCESSED_AND_THROTTLED_KEYS
  2. Wechseln Sie vom Modus für Schlüssel mit Zugriffen und Drosselungen in den Modus für gedrosselte Schlüssel.

    aws dynamodb update-contributor-insights \ --table-name Music \ --contributor-insights-action=ENABLE \ --contributor-insights-mode=THROTTLED_KEYS
  3. Überprüfen Sie den Status während des Übergangs.

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

    Während des Moduswechsels wird ContributorInsightsStatus als ENABLING angezeigt. Sobald der Vorgang abgeschlossen ist, wird dies als ENABLED mit dem neuen Modus angezeigt.

Verwalten von Contributor Insights

So verwalten Sie Contributor-Insights-Einstellungen
  1. Deaktivieren Sie CloudWatch Contributor Insights for DynamoDB auf dem AlbumTitle-index globalen sekundären Index.

    aws dynamodb update-contributor-insights \ --table-name Music --index-name AlbumTitle-index \ --contributor-insights-action=DISABLE
  2. Listen Sie alle Contributor-Insights-Konfigurationen in Ihrem Konto auf.

    aws dynamodb list-contributor-insights

    Hiermit werden alle Tabellen und Indizes, für die Contributor Insights aktiviert ist, zusammen mit ihren Modi angezeigt.

  3. Rufen Sie detaillierte Informationen zu einer bestimmten Konfiguration ab.

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

Beispielantworten

Hier finden Sie Beispielantworten, die die Unterschiede zwischen den Modi zeigen:

Reaktion im Modus für Schlüssel mit Zugriffen und Drosselungen

{ "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" }

Reaktion im Modus für gedrosselte Schlüssel

{ "TableName": "Music", "ContributorInsightsRuleList": [ "DynamoDBContributorInsights-PKT-Music-1234567890123", "DynamoDBContributorInsights-SKT-Music-1234567890123" ], "ContributorInsightsStatus": "ENABLED", "ContributorInsightsMode": "THROTTLED_KEYS", "LastUpdateDateTime": "2024-01-15T10:35:00.000Z" }

Beachten Sie, dass der Modus für gedrosselte Schlüssel weniger Regeln aufweist (nur PKT und SKT), was einer gezielteren Überwachung entspricht.