Guida introduttiva a CloudWatch Contributor Insights for DynamoDB - Amazon DynamoDB
Scelta di una modalità Contributor InsightsUtilizzo di Contributor Insights (console)Utilizzo di Contributor Insights (AWS CLI)

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 di una modalità 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 tuoi requisiti specifici.

Aspetto Modalità tasti accessibili e limitati modalità tasti limitati
Monitor Tutte le richieste (riuscite e limitate) Solo richieste limitate
Grafici Elementi più consultati + Articoli più limitati Solo gli articoli più limitati
Ideale per Analisi e ottimizzazione mirate Monitoraggio della limitazione
Usa quando È necessaria una visibilità completa sui modelli di accesso. Stai eseguendo analisi o debug a breve termine. La tua preoccupazione principale è identificare e risolvere i problemi di limitazione. Desiderate mantenere Contributor Insights sempre attivo per ricevere avvisi di limitazione 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 tasti limitati per entrambi, quindi scegli Salva modifiche.

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

    Ciò abilita la modalità predefinita con accesso limitato e tasti limitati sia per la tabella che per il GSI, che fornisce il monitoraggio sia degli elementi a cui si accede che di quelli limitati. Se si imposta la modalità Solo tasti limitati sulla posizione ON, si abilita la modalità con tasti limitati.

    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 abilitata la modalità con accesso limitato e con tasti limitati, vengono visualizzati sia i grafici degli elementi con accesso limitato che quelli con accesso limitato.

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

Passaggio da una modalità all'altra

Puoi passare da una modalità all'altra in qualsiasi momento senza disabilitare Contributor Insights.

Per cambiare modalità 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 tasti limitati per abilitare la modalità tasti limitati o torna alla modalità predefinita con tasti limitati e con accesso limitato.

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

  3. Scegli Save changes (Salva modifiche).

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

Creazione di allarmi CloudWatch

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. Scegli la regola appropriata in base alla tua 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. Inserisci un valore di soglia appropriato e scegli Avanti:

    • Per gli articoli a cui si accede (regole PKC): immettere 50000 per ConsumedThroughputUnits

    • Per gli articoli limitati (regole PKT): inserisci 1 per ricevere un avviso in caso ThrottleCount 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 modalità predefinita

Per 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 ContributorInsightsMode campo visualizzatoACCESSED_AND_THROTTLED_KEYS.

  4. Elenca lo stato della Music tabella e tutti i suoi indici.

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

Attivazione della modalità tasti limitati

Per abilitare Contributor Insights in modalità tasti limitati

  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 in modalità tasti limitati 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à un numero ContributorInsightsMode di THROTTLED_KEYS regole pari o inferiore rispetto alla modalità predefinita.

Passaggio da una modalità all'altra

Per cambiare modalità Contributor Insights

  1. Passa dalla modalità tasti limitati alla modalità tasti con accesso limitato e con tasti limitati.

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

  2. Passa dalla modalità tasti con accesso limitato alla modalità tasti limitati.

    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 comeENABLING. Una volta completata, verrà visualizzata come ENABLED nella nuova modalità.

Gestione di Contributor Insights

Per 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 presenti nel tuo 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à tasti accessibili e limitati

{
    "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à tasti limitati

{
    "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à tasti limitati ha meno regole (solo PKT e SKT), il che corrisponde a un monitoraggio più mirato.