Nozioni di base su Contributor Insights di CloudWatch per DynamoDB

Per utilizzare Contributor Insights nella console

1. Accedi alla console Console di gestione AWS e apri la console DynamoDB all'indirizzo https://console.aws.amazon.com/elasticache/.

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 Contributor Insights di CloudWatch.

   

6. Nella finestra di dialogo delle impostazioni Gestire CloudWatch Contributor Insights, abilita l’opzione Attiva sia per la tabella di base Music che per l’indice secondario globale AlbumTitle-index.

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

   

   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 non riesce, consulta DescribeContributorInsights FailureException nella Documentazione di riferimento delle API di Amazon DynamoDB per le cause possibili.

8. I grafici di Contributor Insights di CloudWatch sono ora visibili nella scheda Monitoraggio 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).

   

Come cambiare modalità di Contributor Insights

1. Nella scheda Monitoraggio della tabella, seleziona Gestire CloudWatch Contributor Insights.

2. Nella finestra di dialogo delle impostazioni Gestisci Contributor Insights, per ogni tabella di base o GSI:

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

   • Disattiva l’opzione Attiva per disabilitare CloudWatch Contributor Insights per una tabella o un GSI.

3. Scegli Save changes (Salva modifiche).

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

Attieniti alla seguente procedura per creare un allarme CloudWatch e ricevere una notifica quando una chiave di partizione utilizza più di 50.000 ConsumedThroughputUnits o viene sottoposta a limitazione (della larghezza di banda della rete).

1. Accedi alla Console di gestione AWS e apri la console CloudWatch all'indirizzo 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 con accessi (solo modalità Chiavi con accessi e limitazione (della larghezza di banda della rete)): seleziona DynamoDBContributorInsights-PKC-Music

   • Per il monitoraggio degli elementi sottoposti a limitazione (della larghezza di banda della rete) (entrambe le modalità): seleziona DynamoDBContributorInsights-PKT-Music

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.

   

7. Nella colonna Operazioni scegli Crea allarme.

   

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

   

9. Consulta Utilizzo degli allarmi Amazon CloudWatch per i dettagli su come configurare la notifica per l'allarme.

Come utilizzare Contributor Insights con le impostazioni predefinite

1. Abilita Contributor Insights di CloudWatch per DynamoDB sulla tabella di base Music con la modalità Chiavi con accessi e limitazione (della larghezza di banda della rete). 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

Come abilitare Contributor Insights in modalità Chiavi con limitazione (della larghezza di banda della rete

1. Abilita Contributor Insights di CloudWatch per DynamoDB sulla tabella di base Music con la 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

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.

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

Come gestire le impostazioni di Contributor Insights

1. Disabilitare CloudWatch 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=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