

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

# Risoluzione degli errori di gestione della capacità in Amazon Keyspaces
<a name="troubleshooting.serverless"></a>

Problemi con la capacità serverless? Ecco alcuni problemi comuni e come risolverli.

## Errori di capacità serverless
<a name="troubleshooting-serverless"></a>

Questa sezione descrive come riconoscere gli errori relativi alla gestione della capacità serverless e come risolverli. Ad esempio, è possibile che si verifichino eventi di capacità insufficiente quando l'applicazione supera la capacità di throughput assegnata. 

Poiché Apache Cassandra è un software basato su cluster progettato per funzionare su una flotta di nodi, non presenta eccezioni relative a funzionalità serverless come la capacità di trasmissione. La maggior parte dei driver comprende solo i codici di errore disponibili in Apache Cassandra, quindi Amazon Keyspaces utilizza lo stesso set di codici di errore per mantenere la compatibilità. 

Per mappare gli errori di Cassandra agli eventi di capacità sottostanti, puoi utilizzare Amazon CloudWatch per monitorare i parametri pertinenti di Amazon Keyspaces. Gli eventi di capacità insufficiente che provocano errori sul lato client possono essere classificati in questi tre gruppi in base alla risorsa che causa l'evento: 
+ **Tabella**: se si sceglie la modalità **Provisioned** capacity per una tabella e l'applicazione supera il throughput assegnato, è possibile che si verifichino errori di capacità insufficiente. Per ulteriori informazioni, consulta [Configura le modalità di read/write capacità in Amazon Keyspaces](ReadWriteCapacityMode.md).
+ **Partizione**: potrebbero verificarsi eventi di capacità insufficiente se il traffico verso una determinata partizione supera 3.000 o 1.000. RCUs WCUs Come best practice, consigliamo di distribuire il traffico in modo uniforme tra le partizioni. Per ulteriori informazioni, consulta [Migliori pratiche di modellazione dei dati: consigli per la progettazione di modelli di dati](data-modeling.md).
+ **Connessione**: la velocità effettiva potrebbe essere insufficiente se si supera la quota per il numero massimo di operazioni al secondo, per connessione. Per aumentare la velocità effettiva, è possibile aumentare il numero di connessioni predefinite durante la configurazione della connessione con il driver.

  Per informazioni su come configurare le connessioni per Amazon Keyspaces, consulta. [Come configurare le connessioni in Amazon Keyspaces](connections.md#connections.howtoconfigure) Per ulteriori informazioni sull'ottimizzazione delle connessioni sugli endpoint VPC, consulta. [Come configurare le connessioni tramite endpoint VPC in Amazon Keyspaces](connections.md#connections.VPCendpoints)

Per determinare quale risorsa sta causando l'evento di capacità insufficiente che restituisce l'errore lato client, puoi controllare la dashboard nella console Amazon Keyspaces. **Per impostazione predefinita, la console fornisce una visualizzazione aggregata delle metriche più comuni relative alla capacità e al traffico nella sezione Capacità **e CloudWatch metriche correlate della scheda Capacità relativa alla tabella**.** 

Per creare la tua dashboard con Amazon CloudWatch, controlla le seguenti metriche di Amazon Keyspaces. 
+ `PerConnectionRequestRateExceeded`— Richieste ad Amazon Keyspaces che superano la quota per la frequenza di richieste per connessione. Ogni connessione client ad Amazon Keyspaces può supportare fino a 3000 richieste CQL al secondo. È possibile eseguire più di 3000 richieste al secondo creando più connessioni.
+ `ReadThrottleEvents`— Richieste ad Amazon Keyspaces che superano la capacità di lettura di una tabella.
+ `StoragePartitionThroughputCapacityExceeded`— Richieste a una partizione di storage Amazon Keyspaces che superano la capacità di throughput della partizione. Le partizioni di storage Amazon Keyspaces possono supportare fino a 1000 WCU/WRU al secondo e 3000 RCU/RRU al secondo. Per mitigare queste eccezioni, ti consigliamo di rivedere il tuo modello di dati per distribuire il read/write traffico su più partizioni.
+ `WriteThrottleEvents`— Richieste ad Amazon Keyspaces che superano la capacità di scrittura di una tabella.

Per ulteriori informazioni CloudWatch, consulta[Monitoraggio di Amazon Keyspaces con Amazon CloudWatch](monitoring-cloudwatch.md). Per un elenco di tutte le CloudWatch metriche disponibili per Amazon Keyspaces, consulta. [Metriche e dimensioni di Amazon Keyspaces](metrics-dimensions.md) 

**Nota**  
[Per iniziare con una dashboard personalizzata che mostri tutte le metriche comunemente osservate per Amazon Keyspaces, puoi utilizzare un modello CloudWatch predefinito disponibile nell'AWS archivio degli GitHub esempi.](https://github.com/aws-samples/amazon-keyspaces-cloudwatch-cloudformation-templates)

**Topics**
+ [Errori lato client](#troubleshooting.serverless.clientside)
+ [Errori di timeout di scrittura durante l'importazione dei dati](#troubleshooting.serverless.writetimeout)
+ [Dimensioni dello spazio chiave o della tabella](#troubleshooting.serverless.storagesize)

### Ricevo errori di capacità `NoHostAvailable` insufficiente dal driver del mio client
<a name="troubleshooting.serverless.clientside"></a>

**Stai visualizzando le nostre eccezioni per una tabella`Read_Timeout`. `Write_Timeout`**

Il tentativo ripetuto di scrivere o leggere da una tabella Amazon Keyspaces con capacità insufficiente può causare errori lato client specifici del driver.

Utilizzalo CloudWatch per monitorare i parametri di throughput assegnati ed effettivi e gli eventi di capacità insufficiente per la tabella. Ad esempio, una richiesta di lettura che non ha una capacità di throughput sufficiente ha esito negativo con un'`Read_Timeout`eccezione e viene registrata nella metrica. `ReadThrottleEvents` Una richiesta di scrittura che non ha una capacità di throughput sufficiente ha esito negativo con un'`Write_Timeout`eccezione e viene registrata nella metrica. `WriteThrottleEvents` Per ulteriori informazioni su questi parametri, consulta [Metriche e dimensioni di Amazon Keyspaces](metrics-dimensions.md).

Per risolvere questi problemi, prendi in considerazione una delle seguenti opzioni.
+ Aumentate il *throughput assegnato* per la tabella, ovvero la quantità massima di capacità di throughput che un'applicazione può consumare. Per ulteriori informazioni, consulta [Unità di capacità in lettura e unità di capacità in scrittura](ReadWriteCapacityMode.Provisioned.md#ReadWriteCapacityMode.Provisioned.Units).
+ Consenti al servizio di gestire la capacità di throughput per tuo conto con la scalabilità automatica. Per ulteriori informazioni, consulta [Gestisci automaticamente la capacità di throughput con la scalabilità automatica di Amazon Keyspaces](autoscaling.md).
+ Scegli la modalità di capacità **su richiesta** per la tabella. Per ulteriori informazioni, consulta [Configura la modalità di capacità su richiesta](ReadWriteCapacityMode.OnDemand.md).

Se devi aumentare la quota di capacità predefinita per il tuo account, consulta[Quote per Amazon Keyspaces (per Apache Cassandra)](quotas.md).

**Stai riscontrando errori relativi al superamento della capacità di partizione.**

Quando viene visualizzato l'errore, la capacità `StoragePartitionThroughputCapacityExceeded` della partizione viene temporaneamente superata. Ciò potrebbe essere gestito automaticamente dalla capacità adattiva o dalla capacità su richiesta. Ti consigliamo di rivedere il tuo modello di dati per distribuire il read/write traffico su più partizioni per mitigare questi errori. Le partizioni di storage Amazon Keyspaces possono supportare fino a 1000 WCU/WRU al secondo e 3000 RCU/RRU al secondo. Per ulteriori informazioni su come migliorare il modello di dati per distribuire il read/write traffico su più partizioni, consulta. [Migliori pratiche di modellazione dei dati: consigli per la progettazione di modelli di dati](data-modeling.md)

`Write_Timeout`le eccezioni possono anche essere causate da una velocità elevata di operazioni di scrittura simultanee che includono dati statici e non statici nella stessa partizione logica. Se si prevede che il traffico esegua più operazioni di scrittura simultanee che includono dati statici e non statici all'interno della stessa partizione logica, si consiglia di scrivere i dati statici e non statici separatamente. La scrittura dei dati separatamente aiuta anche a ottimizzare i costi di throughput.

**Stai riscontrando errori relativi al superamento della frequenza di richiesta di connessione.**

Stai vedendo qualcosa a `PerConnectionRequestRateExceeded` causa di una delle seguenti cause.
+ Potresti non avere un numero sufficiente di connessioni configurate per sessione.
+ Potresti ricevere meno connessioni rispetto ai peer disponibili, perché le autorizzazioni degli endpoint VPC non sono configurate correttamente. Per ulteriori informazioni sulle policy degli endpoint VPC, consulta. [Utilizzo degli endpoint VPC dell'interfaccia per Amazon Keyspaces](vpc-endpoints.md#using-interface-vpc-endpoints)
+ Se utilizzi un driver 4.x, controlla se la convalida del nome host è abilitata. Il driver abilita la verifica del nome host TLS per impostazione predefinita. Questa configurazione fa sì che Amazon Keyspaces appaia come un cluster a nodo singolo per il driver. Ti consigliamo di disattivare la verifica del nome host.

Ti consigliamo di seguire queste best practice per assicurarti che le connessioni e il throughput siano ottimizzati:
+ **Configura l'ottimizzazione del throughput delle query CQL.**

  Amazon Keyspaces supporta fino a 3.000 query CQL per connessione TCP al secondo, ma non c'è limite al numero di connessioni che un driver può stabilire. 

  La maggior parte dei driver Cassandra open source stabilisce un pool di connessioni con Cassandra e bilancia il carico delle query su quel pool di connessioni. Amazon Keyspaces espone 9 indirizzi IP peer ai driver. Il comportamento predefinito della maggior parte dei driver consiste nello stabilire una singola connessione a ciascun indirizzo IP peer. Pertanto, la velocità massima di trasmissione delle query CQL di un driver che utilizza le impostazioni predefinite sarà di 27.000 query CQL al secondo. 

  Per aumentare questo numero, si consiglia di aumentare il numero di connessioni per indirizzo IP che il driver mantiene nel proprio pool di connessioni. Ad esempio, impostando il numero massimo di connessioni per indirizzo IP su 2, la velocità effettiva massima del driver raddoppierà fino a 54.000 query CQL al secondo. 
+ **Ottimizza le connessioni a nodo singolo.**

  Per impostazione predefinita, la maggior parte dei driver Cassandra open source stabilisce una o più connessioni a ogni indirizzo IP pubblicizzato nella `system.peers` tabella quando si stabilisce una sessione. Tuttavia, alcune configurazioni possono comportare la connessione di un driver a un singolo indirizzo IP di Amazon Keyspaces. Ciò può accadere se il driver sta tentando la convalida del nome host SSL dei nodi peer (ad esempio, i driver DataStax Java) o quando si connette tramite un endpoint VPC.

  Per ottenere la stessa disponibilità e le stesse prestazioni di un driver con connessioni a più indirizzi IP, ti consigliamo di fare quanto segue:
  + Aumentate il numero di connessioni per IP a 9 o più, a seconda della velocità effettiva del client desiderata.
  + Crea una politica di nuovi tentativi personalizzata che garantisca che i nuovi tentativi vengano eseguiti sullo stesso nodo. Per ulteriori informazioni, consultare la pagina 

    [Come configurare la politica di riprova per le connessioni in Amazon Keyspaces](connections.md#connections.retry-policies).
  + Se utilizzi endpoint VPC, concedi all'entità IAM utilizzata per la connessione ad Amazon Keyspaces le autorizzazioni di accesso per interrogare il tuo VPC per le informazioni sull'endpoint e sull'interfaccia di rete. Ciò migliora il bilanciamento del carico e aumenta il throughput. read/write Per ulteriori informazioni, consulta [Inserimento delle voci della `system.peers` tabella con informazioni sugli endpoint VPC dell'interfaccia](vpc-endpoints.md#system_peers). 

### Ricevo errori di timeout di scrittura durante l'importazione dei dati
<a name="troubleshooting.serverless.writetimeout"></a>

**Stai ricevendo un errore di timeout durante il caricamento dei dati utilizzando il comando. `cqlsh` `COPY`**

```
Failed to import 1 rows: WriteTimeout - Error from server: code=1100 [Coordinator node timed out waiting for replica nodes' responses]
 message="Operation timed out - received only 0 responses." info={'received_responses': 0, 'required_responses': 2, 'write_type': 'SIMPLE', 'consistency': 
 'LOCAL_QUORUM'}, will retry later, attempt 1 of 100
```

Amazon Keyspaces utilizza le `WriteTimeout` eccezioni `ReadTimeout` e per indicare quando una richiesta di scrittura non riesce a causa di una capacità di throughput insufficiente. Per aiutare a diagnosticare eccezioni di capacità insufficienti, Amazon Keyspaces pubblica le seguenti metriche su Amazon. CloudWatch
+ `WriteThrottleEvents`
+ `ReadThrottledEvents`
+ `StoragePartitionThroughputCapacityExceeded`

Per risolvere gli errori di capacità insufficiente durante il caricamento dei dati, riduci la velocità di scrittura per lavoratore o la velocità di acquisizione totale, quindi riprova a caricare le righe. Per ulteriori informazioni, consulta [Fase 4: Configurare `cqlsh COPY FROM` le impostazioni](bulk-upload-config.md). [Per un'opzione di caricamento dei dati più solida, prendi in considerazione l'utilizzo DSBulk, disponibile nel repository. GitHub ](https://github.com/datastax/dsbulk) Per step-by-step istruzioni, vedere[Tutorial: caricamento di dati in Amazon Keyspaces utilizzando DSBulk](dsbulk-upload.md).

### Non riesco a vedere le dimensioni effettive di archiviazione di un keyspace o di una tabella
<a name="troubleshooting.serverless.storagesize"></a>

**Non è possibile visualizzare la dimensione di archiviazione effettiva del keyspace o della tabella.**

Per ulteriori informazioni sulle dimensioni di archiviazione della tabella, consulta[Valutazione dei costi a livello di tabella](CostOptimization_TableLevelCostAnalysis.md). Puoi anche stimare le dimensioni dello spazio di archiviazione iniziando a calcolare la dimensione delle righe in una tabella. Istruzioni dettagliate per il calcolo della dimensione delle righe sono disponibili all'indirizzo[Stima della dimensione delle righe in Amazon Keyspaces](calculating-row-size.md).