Guida introduttiva a CloudWatch Contributor Insights for DynamoDB - Amazon DynamoDB

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Guida introduttiva a CloudWatch Contributor Insights for DynamoDB

Questa sezione descrive come abilitare e utilizzare Amazon CloudWatch Contributor Insights in diverse modalità per soddisfare le tue esigenze di monitoraggio utilizzando la console AWS Command Line Interface Amazon DynamoDB o ().AWS CLI

Nei seguenti esempi, viene utilizzata la tabella DynamoDB che viene definita nel tutorial Nozioni di base su DynamoDB.

Scelta della modalità di Contributor Insights

Prima di abilitare Contributor Insights, è necessario comprendere le due modalità disponibili. Esamina il confronto tra le modalità per selezionare l’opzione più adatta ai requisiti specifici.

Aspetto Modalità Chiavi con accessi e limitazione (della larghezza di banda della rete) Modalità Chiavi con limitazione (della larghezza di banda della rete)
Monitoraggi Tutte le richieste (eseguite con successo e limitate) Solo richieste con limitazione (della larghezza di banda della rete)
Grafici Elementi con maggiore accesso + Elementi con maggiore limitazione (della larghezza di banda della rete) Solo elementi con maggiore limitazione (della larghezza di banda della rete)
Ideale per Analisi e ottimizzazione mirate Monitoraggio della limitazione (della larghezza di banda della rete)
Da usare quando È necessaria una visibilità completa sui modelli di accesso. Si stanno eseguendo analisi o debug a breve termine. L’obiettivo principale è identificare e risolvere i problemi di limitazione (della larghezza di banda della rete) Si desidera mantenere Contributor Insights sempre attivo per avvisi sulla limitazione (della larghezza di banda della rete) in tempo reale.

Utilizzo di Contributor Insights (console)

La console offre un modo intuitivo per abilitare Contributor Insights e selezionare la modalità appropriata per le esigenze di monitoraggio.

Per utilizzare Contributor Insights nella console
  1. Accedi AWS Management Console e apri la console DynamoDB all'indirizzo. https://console.aws.amazon.com/dynamodb/

  2. Nel riquadro di navigazione sul lato sinistro della console scegli Tables (Tabelle).

  3. Seleziona la tabella Music.

  4. Selezionare la scheda Monitor (Monitora).

  5. Scegli Attiva CloudWatch Contributor Insights.

    Screenshot della console mostra il pulsante e la scheda di monitoraggio.
  6. Nella finestra di dialogo Gestisci le impostazioni di CloudWatch Contributor Insights, attiva l'opzione Attiva sia per la tabella di Music base che per l'indice secondario globale. AlbumTitle-index

  7. Lascia disattivata la Modalità solo chiavi limitate per entrambi, quindi seleziona Salva modifiche.

    Screenshot della console che mostra le opzioni dell’elenco di stato di Contributor Insights.

    Ciò abilita la modalità predefinita Chiavi con accessi e limitazione (della larghezza di banda della rete) sia per la tabella che per il GSI, che fornisce il monitoraggio sia degli elementi con accessi che di quelli sottoposti a limitazione (della larghezza di banda della rete). L’attivazione dell’opzione Modalità solo chiavi limitate abilita la modalità Chiavi con limitazione (della larghezza di banda della rete).

    Se l'operazione fallisce, consulta DescribeContributorInsights FailureExceptionl'Amazon DynamoDB API Reference per i possibili motivi.

  8. I grafici di CloudWatch Contributor Insights sono ora visibili nella scheda Monitor della tabella. Music Poiché è stata attivata la modalità Chiavi con accessi e limitazione (della larghezza di banda della rete), vengono visualizzati sia i grafici degli elementi con accessi che di quelli sottoposti a limitazione (della larghezza di banda della rete).

    Screenshot della console che mostra la scheda Contributor Insights con vari grafici della tabella Music.

Passaggio da una modalità all’altra

È possibile passare da una modalità all’altra in qualsiasi momento senza disabilitare Contributor Insights.

Come cambiare modalità di Contributor Insights
  1. Nella scheda Monitor della tabella, scegli Gestisci CloudWatch Contributor Insights.

  2. Nella finestra di dialogo Gestisci le impostazioni di Contributor Insights, per ogni tabella di base oppure: GSIs

    • Attiva o disattiva la Modalità solo chiavi limitate per abilitare la modalità Chiavi con limitazione (della larghezza di banda della rete) o torna alla modalità predefinita Chiavi con accessi e limitazione (della larghezza di banda della rete).

    • Attiva l'opzione Attiva per disabilitare CloudWatch Contributor Insight per una tabella o un GSI.

  3. Scegli Save changes (Salva modifiche).

    Una volta completata l’operazione, i grafici rifletteranno la nuova modalità.

CloudWatch Creazione di allarmi

Segui questi passaggi per creare un CloudWatch allarme e ricevere una notifica quando una chiave di partizione consuma più di 50.000 unità ConsumedThroughputUnitso subisce una limitazione.

  1. Accedi e apri la console all'indirizzo AWS Management Console CloudWatch https://console.aws.amazon.com/cloudwatch/

  2. Nel riquadro di navigazione sul lato sinistro della console scegli Contributor Insights.

  3. Seleziona la regola appropriata in base alla modalità e a ciò che desideri monitorare:

    • Per il monitoraggio degli elementi a cui si accede (solo modalità con accesso e tasti limitati): scegli Dynamo Insights-PKC-Music DBContributor

    • Per il monitoraggio degli elementi limitati (entrambe le modalità): scegli Dynamo Insights-PKT-Music DBContributor

  4. Seleziona il menu a tendina Operazioni.

  5. Scegli Visualizza nei parametri.

  6. Scegli Valore massimo Contributor.

    Nota

    Solo Max Contributor Value e Maximum restituiscono statistiche utili. Le altre statistiche dell'elenco non restituiscono valori significativi.

    Screenshot della console che mostra la scheda e il pulsante Contributor Insights.
  7. Nella colonna Operazioni scegli Crea allarme.

    Screenshot della console che mostra le opzioni dell’elenco di stato di Contributor Insights.
  8. Immetti un valore di soglia appropriato e seleziona Successivo:

    • Per gli elementi con accessi (regole PKC): immetti 50000 per ConsumedThroughputUnits

    • Per gli elementi sottoposti a limitazione (della larghezza di banda della rete) (regole PKT): immetti 1 per ThrottleCount per ricevere un avviso in caso di limitazione

    Screenshot della console che mostra la scheda e il pulsante Contributor Insights.
  9. Vedi Uso degli CloudWatch allarmi Amazon per dettagli su come configurare la notifica per l'allarme.

Utilizzo di Contributor Insights (AWS CLI)

AWS CLI Fornisce l'accesso programmatico a Contributor Insights con supporto completo per entrambe le modalità. È possibile specificare la modalità quando si abilita Contributor Insights o cambiare modalità in un secondo momento.

Operazioni di base con la modalità predefinita

Come utilizzare Contributor Insights con le impostazioni predefinite
  1. Abilita CloudWatch Contributor Insights for DynamoDB nella tabella di base con Music la modalità di accesso e tasti limitati. Poiché ACCESSED_AND_THROTTLED_KEYS è la modalità predefinita, è possibile omettere il parametro --contributor-insights-mode=ACCESSED_AND_THROTTLED_KEYS.

    aws dynamodb update-contributor-insights \ --table-name Music \ --contributor-insights-action=ENABLE
  2. Abilitare Contributor Insights per DynamoDB sull'indice secondario globale AlbumTitle-index.

    aws dynamodb update-contributor-insights \ --table-name Music \ --index-name AlbumTitle-index \ --contributor-insights-action=ENABLE
  3. Ottenere lo stato e le regole per la tabella Music e tutti i relativi indici.

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

    La risposta includerà il campo ContributorInsightsMode che mostra ACCESSED_AND_THROTTLED_KEYS.

  4. Ottieni lo stato per la tabella Music e tutti i relativi indici.

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

Abilitazione della modalità Chiavi con limitazione (della larghezza di banda della rete)

Come abilitare Contributor Insights in modalità Chiavi con limitazione (della larghezza di banda della rete
  1. Abilita CloudWatch Contributor Insights for DynamoDB nella tabella di base con Music la modalità tasti limitati.

    aws dynamodb update-contributor-insights \ --table-name Music \ --contributor-insights-action=ENABLE \ --contributor-insights-mode=THROTTLED_KEYS
  2. Abilita Contributor Insights nella modalità Chiavi con limitazione (della larghezza di banda della rete per l’indice secondario globale AlbumTitle-index.

    aws dynamodb update-contributor-insights \ --table-name Music \ --index-name AlbumTitle-index \ --contributor-insights-action=ENABLE \ --contributor-insights-mode=THROTTLED_KEYS
  3. Verifica la modalità descrivendo la configurazione di Contributor Insights.

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

    La risposta mostrerà ContributorInsightsMode come THROTTLED_KEYS e un numero minore di regole rispetto alla modalità predefinita.

Passaggio da una modalità all’altra

Come cambiare modalità di Contributor Insights
  1. Passa dalla modalità Chiavi con limitazione (della larghezza di banda della rete alla modalità Chiavi con accessi e limitazione (della larghezza di banda della rete).

    aws dynamodb update-contributor-insights \ --table-name Music \ --contributor-insights-action=ENABLE \ --contributor-insights-mode=ACCESSED_AND_THROTTLED_KEYS
  2. Passa dalla modalità Chiavi con accessi e limitazione (della larghezza di banda della rete) alla modalità Chiavi con limitazione (della larghezza di banda della rete).

    aws dynamodb update-contributor-insights \ --table-name Music \ --contributor-insights-action=ENABLE \ --contributor-insights-mode=THROTTLED_KEYS
  3. Controlla lo stato durante la transizione.

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

    Durante il cambio di modalità, ContributorInsightsStatus verrà visualizzato come ENABLING. Una volta completata l’operazione, verrà visualizzato come ENABLED nella nuova modalità.

Gestione di Contributor Insights

Come gestire le impostazioni di Contributor Insights
  1. Disattiva CloudWatch Contributor Insights for DynamoDB sull'AlbumTitle-indexindice secondario globale.

    aws dynamodb update-contributor-insights \ --table-name Music --index-name AlbumTitle-index \ --contributor-insights-action=DISABLE
  2. Elenca tutte le configurazioni di Contributor Insights nell’account.

    aws dynamodb list-contributor-insights

    Questo mostra tutte le tabelle e gli indici con Contributor Insights abilitato, insieme alle relative modalità.

  3. Ottieni informazioni dettagliate su una configurazione specifica.

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

Risposte di esempio

Ecco alcuni esempi di risposte che mostrano le differenze tra le modalità:

Risposta in modalità Chiavi con accessi e limitazione (della larghezza di banda della rete)

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

Risposta in modalità Chiavi con limitazione (della larghezza di banda della rete)

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

Si noti che la modalità Chiavi con limitazione (della larghezza di banda della rete) ha un numero minore di regole (solo PKT e SKT), il che corrisponde a un monitoraggio più mirato.