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](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/GettingStartedDynamoDB.html).
**Topics**
+ [Scelta della modalità di Contributor Insights](#contributorinsights_tutorial.modes)
+ [Utilizzo di Contributor Insights (console)](#usecontributorinsights_console)
+ [Utilizzo di Contributor Insights (AWS CLI)](#usecontributorinsights_cli)
## 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 \$1 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 Console di gestione AWS e apri la console DynamoDB all'indirizzo. [https://console.aws.amazon.com/dynamodb/](https://console.aws.amazon.com/dynamodb/)
1. Nel riquadro di navigazione sul lato sinistro della console scegli **Tables (Tabelle)**.
1. Seleziona la tabella `Music`.
1. Selezionare la scheda **Monitor (Monitora)**.
1. Scegli **Attiva CloudWatch Contributor Insights**.
![\[Screenshot della console mostra il pulsante e la scheda di monitoraggio.\]](http://docs.aws.amazon.com/it_it/amazondynamodb/latest/developerguide/images/CI_ChooseAndManageNew.PNG)
1. 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`
1. 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.\]](http://docs.aws.amazon.com/it_it/amazondynamodb/latest/developerguide/images/CI_Enable.png)
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 FailureException](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DescribeContributorInsights.html#DDB-DescribeContributorInsights-response-FailureException)l'*Amazon DynamoDB API* Reference per i possibili motivi.
1. 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.\]](http://docs.aws.amazon.com/it_it/amazondynamodb/latest/developerguide/images/CI_Graphs.png)
### 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**.
1. 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.
1. 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à [ConsumedThroughputUnits](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/contributorinsights_HowItWorks.html#contributorinsights_HowItWorks.Graphs.most-accessed)o subisce una limitazione.
1. Accedi e apri la console all'indirizzo Console di gestione AWS CloudWatch [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)
1. Nel riquadro di navigazione sul lato sinistro della console scegli **Contributor Insights**.
1. 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**
1. Seleziona il menu a tendina **Operazioni**.
1. Scegli **Visualizza nei parametri**.
1. 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.\]](http://docs.aws.amazon.com/it_it/amazondynamodb/latest/developerguide/images/CI_AlarmsViewinMetrics.png)
1. Nella colonna **Operazioni** scegli **Crea allarme**.
![\[Screenshot della console che mostra le opzioni dell’elenco di stato di Contributor Insights.\]](http://docs.aws.amazon.com/it_it/amazondynamodb/latest/developerguide/images/CI_AlarmsSetAlarm.png)
1. 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.\]](http://docs.aws.amazon.com/it_it/amazondynamodb/latest/developerguide/images/CI_AlarmsSetAlarmThreashold.png)
1. Vedi [Uso degli CloudWatch allarmi Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) 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
```
1. 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
```
1. 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`.
1. 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
```
1. 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
```
1. 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
```
1. 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
```
1. 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-index`indice secondario globale.
```
aws dynamodb update-contributor-insights \
--table-name Music --index-name AlbumTitle-index \
--contributor-insights-action=DISABLE
```
1. 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à.
1. 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.