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à.
# Utilizzo di Amazon DocumentDB serverless
Amazon DocumentDB serverless è una configurazione on-demand con scalabilità automatica che automatizza i processi di regolazione dinamica della capacità del database Amazon DocumentDB in base alla domanda dell'applicazione. Ti vengono addebitati solo i costi delle risorse utilizzate dai cluster. Pertanto, DocumentDB serverless può aiutarvi a rispettare il budget ed evitare di pagare per risorse informatiche che non utilizzate.
Questo tipo di automazione è particolarmente utile per ambienti con carichi di lavoro altamente variabili e imprevedibili, come database multitenant, database distribuiti e sistemi di sviluppo e test.
**Topics**
+ [Casi d'uso Serverless](#docdb-serverless-use-cases)
+ [Vantaggi di Amazon DocumentDB serverless](#docdb-serverless-advantages)
+ [Come funziona la tecnologia serverless](docdb-serverless-how-it-works.md)
+ [Requisiti e limitazioni senza server](docdb-serverless-limitations.md)
+ [Creazione di un cluster che utilizza sistemi serverless](docdb-serverless-create-cluster.md)
+ [Migrazione verso una soluzione serverless](docdb-serverless-migrating.md)
+ [Gestione senza server](docdb-serverless-managing.md)
+ [Limiti delle istanze serverless](docdb-serverless-instance-limits.md)
+ [Configurazione di scalabilità senza server](docdb-serverless-scaling-config.md)
+ [Monitoraggio senza server](docdb-serverless-monitoring.md)
## Casi d'uso senza server DocumentDB
Sia i cluster con provisioning di Amazon DocumentDB che DocumentDB serverless supportano molti tipi di carichi di lavoro di database, dagli ambienti di sviluppo e test alle applicazioni aziendali più impegnative e critiche che richiedono scalabilità e disponibilità elevate. Ma DocumentDB serverless aggiunge un'altra dimensione ai carichi di lavoro dei clienti, vale a dire la capacità di supportare siti Web e applicazioni con carichi di lavoro imprevedibili.
DocumentDB serverless è particolarmente utile per i seguenti casi d'uso:
+ **Carichi di lavoro variabili: si eseguono carichi** di lavoro con aumenti di attività improvvisi e imprevedibili. Un esempio può essere quello di un sito che offre informazioni sulla viabilità, che riscontra un forte aumento dell'attività quando inizia a piovere. Un altro è un sito di e-commerce che aumenta il proprio traffico durante un'offerta o una vendita promozionale. Con DocumentDB serverless, il database ridimensiona automaticamente la capacità per soddisfare le esigenze del carico di picco dell'applicazione e si ridimensiona nuovamente al termine dell'ondata di attività. Con DocumentDB serverless, non è più necessario effettuare il provisioning per la capacità di picco o media. È possibile specificare un limite massimo di capacità per gestire la peggiore situazione possibile, che viene raggiunto solo in caso di necessità.
+ La granularità della scalabilità in DocumentDB serverless consente di adattare perfettamente la capacità alle esigenze del database. Per un cluster predisposto, la scalabilità richiede l'aggiunta di un'istanza completamente nuova. DocumentDB serverless può aggiungere mezza DCU quando è necessaria solo un po' più di capacità. Può aggiungere 0,5, 1, 1,5, 2 o la metà aggiuntiva, in DCUs base alla capacità aggiuntiva necessaria per gestire un aumento del carico di lavoro. Inoltre, può rimuovere 0,5, 1, 1,5, 2 o la metà aggiuntiva DCUs quando il carico di lavoro diminuisce e tale capacità non è più necessaria.
+ **Applicazioni multi-tenant**: con DocumentDB serverless, non è necessario gestire individualmente la capacità del database per ogni applicazione del parco. DocumentDB serverless gestisce la capacità del database individuale per te.
+ È possibile creare un cluster per ciascun tenant. In questo modo, è possibile utilizzare funzionalità come la clonazione e il ripristino delle istantanee per migliorare l'elevata disponibilità e il disaster recovery in base alle esigenze di ciascun tenant.
+ Ogni tenant potrebbe avere periodi di attività e inattività specifici, che variano a seconda dell'ora, del periodo dell'anno, degli eventi promozionali e così via. Ogni cluster è dotato di un'ampia gamma di capacità. In questo modo, i cluster con attività ridotta comportano costi di istanza minimi. Tutti i cluster sono in grado di scalare rapidamente per gestire periodi di attività elevata.
+ **Nuove applicazioni**: stai implementando una nuova applicazione e non sei sicuro della dimensione dell'istanza di cui hai bisogno. Utilizzando DocumentDB serverless, è possibile configurare un cluster con una o più istanze e scalare automaticamente il database in base ai requisiti di capacità dell'applicazione.
+ **Applicazioni a uso misto**: supponiamo di disporre di un'applicazione di elaborazione delle transazioni online (OLTP), ma che si verifichino periodicamente picchi nel traffico delle query. Specificando i livelli di promozione per le istanze serverless di DocumentDB in un cluster, è possibile configurare il cluster in modo che le istanze Reader possano scalare indipendentemente dall'istanza writer per gestire il carico aggiuntivo. Quando il picco di utilizzo diminuisce, le istanze Reader vengono ridimensionate per adattarsi alla capacità dell'istanza Writer.
+ **Pianificazione della capacità**: supponiamo che in genere si modifichi la capacità del database o si verifichi la capacità ottimale del database per il carico di lavoro, modificando le classi di istanze di tutte le istanze di un cluster. Con DocumentDB serverless, puoi evitare questo sovraccarico amministrativo. È possibile determinare la capacità minima e massima appropriata eseguendo il carico di lavoro e verificando l'effettiva scalabilità delle istanze.
+ È possibile modificare le istanze esistenti da provisioned a DocumentDB serverless o da DocumentDB serverless a provisioned. In questi casi non è necessario creare un nuovo cluster o una nuova istanza.
+ **Sviluppo e test**: oltre a eseguire le applicazioni più complesse, puoi anche utilizzare DocumentDB serverless per ambienti di sviluppo e test. Con DocumentDB serverless, è possibile creare istanze con una capacità minima bassa invece di utilizzare classi di istanze db.t\$1 dustable. È possibile impostare la capacità massima a un livello sufficientemente elevato da consentire a tali istanze di eseguire carichi di lavoro sostanziali senza esaurire la memoria. Quando il database non è in uso, tutte le istanze vengono ridimensionate per evitare costi inutili.
### Utilizzo di Amazon DocumentDB serverless per carichi di lavoro con provisioning esistenti
Supponiamo di avere già un'applicazione DocumentDB in esecuzione su un cluster predisposto. È possibile verificare il funzionamento dell'applicazione con DocumentDB serverless aggiungendo una o più istanze serverless di DocumentDB al cluster esistente come istanze di lettura. È possibile verificare la frequenza con cui le istanze Reader vengono ridimensionate verso l'alto e verso il basso. È possibile utilizzare il meccanismo di failover di DocumentDB per promuovere un'istanza serverless di DocumentDB a farne l'autore e verificare come gestisce il carico di lavoro. read/write Questo passaggio viene eseguito con tempi di inattività minimi e senza modificare l'endpoint utilizzato dalle applicazioni client. Per i dettagli sulla procedura per convertire i cluster esistenti in DocumentDB serverless, vedere. [Migrazione a Amazon DocumentDB serverless](docdb-serverless-migrating.md)
## Vantaggi di Amazon DocumentDB serverless
DocumentDB serverless è destinato a carichi di lavoro variabili o «spinosi». A causa dei carichi di lavoro non prevedibili, potresti avere difficoltà a pianificare le modifiche della capacità del database. Potreste inoltre avere problemi ad apportare modifiche alla capacità con sufficiente rapidità utilizzando meccanismi familiari come l'aggiunta di istanze o la modifica delle classi di istanze. DocumentDB serverless offre i seguenti vantaggi per questi casi d'uso:
+ **Gestione della capacità più semplice di quella fornita: DocumentDB** serverless riduce lo sforzo di pianificazione delle dimensioni delle istanze e di ridimensionamento delle istanze al variare del carico di lavoro. Riduce inoltre lo sforzo necessario per mantenere una capacità costante per tutte le istanze di un cluster.
+ **Scalabilità più rapida e semplice durante i periodi di elevata attività**: DocumentDB serverless ridimensiona la capacità di calcolo e di memoria in base alle esigenze, senza interrompere le transazioni con i clienti o il carico di lavoro complessivo. La possibilità di utilizzare istanze Reader con DocumentDB serverless consente di sfruttare la scalabilità orizzontale oltre a quella verticale. La possibilità di utilizzare i cluster globali di DocumentDB significa che è possibile distribuire il carico di lavoro di lettura senza server DocumentDB su più server. Regioni AWS Questa funzionalità offre una praticità maggiore rispetto ai meccanismi di dimensionamento dei cluster con provisioning.
+ **Conveniente nei periodi di bassa attività**: DocumentDB serverless consente di evitare l'overprovisioning delle istanze. DocumentDB serverless aggiunge risorse in incrementi granulari quando le istanze aumentano. Paghi solo per le risorse di database che utilizzi. L'utilizzo delle risorse serverless di DocumentDB viene misurato su base al secondo. In questo modo, quando un'istanza si ridimensiona, l'utilizzo ridotto delle risorse viene registrato immediatamente.
+ **Parità di funzionalità con provisioned**: è possibile utilizzare tutte le funzionalità di DocumentDB con DocumentDB serverless. Ad esempio, con DocumentDB serverless è possibile utilizzare le istanze di lettura, l'autenticazione del database AWS Identity and Access Management (IAM) e Performance Insights.
In particolare, con DocumentDB serverless è possibile sfruttare le seguenti funzionalità dei cluster con provisioning:
+ **Istanze Reader**: DocumentDB serverless può sfruttare le istanze Reader per scalare orizzontalmente. Quando un cluster contiene una o più istanze di lettura, il cluster può eseguire immediatamente il failover in caso di problemi con l'istanza writer.
+ **Cluster Multi-AZ**: è possibile distribuire le istanze serverless DocumentDB di un cluster su più zone di disponibilità (). AZs La configurazione di un cluster Multi-AZ contribuisce a garantire la continuità aziendale anche nel raro caso che si verifichino problemi che coinvolgono l'intera AZ.
+ **Cluster globali**: è possibile utilizzare DocumentDB serverless in combinazione con i cluster globali DocumentDB per creare copie di sola lettura aggiuntive del cluster in altre per scopi di disaster recovery. Regioni AWS
# Come funziona Amazon DocumentDB serverless
**Topics**
+ [Panoramica di](#docdb-serverlerss-overviewn)
+ [Configurazioni per i cluster Amazon DocumentDB](#docdb-serverlerss-configuration)
+ [Capacità di scalabilità senza server di Amazon DocumentDB](#docdb-serverless-scaling-capacity)
+ [Scalabilità senza server di Amazon DocumentDB](#docdb-serverless-scaling)
+ [Stato di inattività (0,5) DCUs](#docdb-serverlerss-idle-state)
## Panoramica di
Amazon DocumentDB serverless è adatto per i carichi di lavoro più impegnativi e altamente variabili. Ad esempio, l'uso del database potrebbe essere pesante per un breve periodo di tempo, seguito da lunghi periodi di attività leggera o nessuna attività. Alcuni esempi sono siti web per la vendita al dettaglio, i giochi o sportivi con eventi promozionali periodici e database in grado di generare report quando necessario. Altri sono ambienti di sviluppo e test e nuove applicazioni in cui l'utilizzo potrebbe aumentare rapidamente. In casi come questi e molti altri, non sempre è possibile configurare correttamente la capacità in anticipo con il modello fornito. Ciò può anche comportare costi più elevati se si esegue il provisioning eccessivo e si dispone di capacità che poi non viene utilizzata.
Al contrario, i cluster con provisioning di DocumentDB sono adatti per carichi di lavoro stabili. Con i cluster con provisioning, si sceglie una classe di istanza con una quantità predefinita di memoria, potenza della CPU, larghezza di banda e così via. I/O Se il carico di lavoro cambia, modifichi manualmente la classe di istanza dello scrittore e dei lettori. Il modello soggetto a provisioning funziona bene quando è possibile regolare la capacità in anticipo rispetto ai modelli di consumo previsti ed è accettabile soffrire di brevi interruzioni mentre si modifica la classe di istanza dello scrittore e dei lettori all'interno del cluster.
DocumentDB serverless è progettato da zero per supportare cluster serverless che sono immediatamente scalabili. DocumentDB serverless è progettato per fornire lo stesso grado di sicurezza e isolamento degli autori e dei lettori predisposti. Questi aspetti sono cruciali negli ambienti cloud serverless multitenant. Il meccanismo di dimensionamento dinamico impone un overhead molto ridotto in modo da poter rispondere rapidamente alle modifiche del carico di lavoro del database. È anche abbastanza potente da soddisfare i considerevoli aumenti della domanda di elaborazione.
Utilizzando DocumentDB serverless, è possibile creare un cluster DocumentDB senza essere vincolati a una capacità di database specifica per ogni scrittore e lettore. Puoi specificare l'intervallo minimo e massimo per la capacità. DocumentDB ridimensiona ogni writer o lettore serverless DocumentDB nel cluster entro tale intervallo di capacità. Utilizzando un cluster Multi-AZ in cui ogni scrittore o lettore può dimensionarsi dinamicamente puoi sfruttare la scalabilità dinamica e l'elevata disponibilità.
DocumentDB serverless ridimensiona automaticamente le risorse del database in base alle specifiche di capacità minima e massima. La scalabilità è rapida perché la maggior parte delle operazioni legate agli eventi di dimensionamento mantiene lo scrittore o il lettore sullo stesso host. Nei rari casi in cui un writer o lettore serverless DocumentDB viene spostato da un host all'altro, DocumentDB serverless gestisce automaticamente le connessioni. Non è necessario modificare il codice dell'applicazione client del database o le stringhe di connessione al database.
Con DocumentDB serverless, come con i cluster con provisioning, la capacità di archiviazione e la capacità di elaborazione sono separate. Quando ci riferiamo alla capacità e alla scalabilità senza server di DocumentDB, è sempre la capacità di elaborazione ad aumentare o diminuire. Pertanto, il cluster può contenere molti terabyte di dati anche quando la CPU e la capacità di memoria si dimensionano verso il basso.
Anziché effettuare il provisioning e gestire i server di database, puoi indicare la capacità del database. La capacità effettiva di ogni writer o lettore serverless DocumentDB varia nel tempo, a seconda del carico di lavoro. Per i dettagli su questi meccanismi, consulta [Scalabilità senza server di Amazon DocumentDB](#docdb-serverless-scaling).
## Configurazioni per i cluster Amazon DocumentDB
Per ciascuno dei tuoi cluster Amazon DocumentDB, puoi scegliere qualsiasi combinazione di capacità serverless di DocumentDB, capacità fornita o entrambe.
È possibile configurare un cluster che contenga sia la capacità serverless di DocumentDB che quella fornita, denominato cluster a configurazione mista. Ad esempio, supponiamo di aver bisogno di una read/write capacità maggiore di quella disponibile per un writer serverless DocumentDB. In questo caso puoi configurare il cluster con uno scrittore con provisioning di dimensioni molto ampie. Quindi puoi ancora usare DocumentDB serverless per i lettori. Oppure supponi che il carico di lavoro in scrittura per il cluster vari ma che il carico di lavoro in lettura sia costante. In questo caso, è possibile configurare il cluster con un writer serverless DocumentDB e uno o più lettori predisposti.
È anche possibile configurare un cluster in cui tutta la capacità è gestita da DocumentDB serverless. A tale scopo, è possibile creare un nuovo cluster e utilizzare DocumentDB serverless sin dall'inizio. In alternativa, è possibile sostituire tutta la capacità fornita in un cluster esistente con DocumentDB serverless. Per le procedure per creare un nuovo cluster con DocumentDB serverless o per passare un cluster esistente a DocumentDB serverless, vedere e. [Creazione di un cluster che utilizza Amazon DocumentDB serverless](docdb-serverless-create-cluster.md) [Migrazione a Amazon DocumentDB serverless](docdb-serverless-migrating.md)
Se non si utilizza affatto DocumentDB serverless in un cluster, viene eseguito il provisioning di tutti gli autori e i lettori del cluster. Questo è il tipo di cluster più comune che la maggior parte degli utenti conosce. La capacità fornita è costante. Le tariffe sono relativamente semplici da prevedere. Tuttavia, è necessario prevedere in anticipo quanta capacità è necessaria. In alcuni casi le previsioni potrebbero essere imprecise o le esigenze di capacità potrebbero cambiare. In questi casi, il provisioning del cluster può essere insufficiente (più lento di quanto richiesto) o eccessivo (più costoso del previsto).
## Capacità di scalabilità senza server di Amazon DocumentDB
L'unità di misura per Amazon DocumentDB serverless è la DocumentDB Capacity Unit (DCU). La capacità di scalabilità serverless di DocumentDB non è legata alle classi di istanze utilizzate per i cluster con provisioning.
Ogni DCU è una combinazione di circa 2 gibibyte (GiB) di memoria, CPU corrispondente e rete. Puoi specificare l'intervallo di capacità del database utilizzando questa unità di misura. I parametri `ServerlessDatabaseCapacity` e `DCUUtilization` CloudWatch consentono di determinare la capacità effettivamente utilizzata dal database e se tale capacità rientra nell'intervallo specificato.
In qualsiasi momento, ogni writer o lettore serverless DocumentDB ha una capacità. La capacità è un numero a virgola mobile che rappresenta. DCUs La capacità aumenta o diminuisce ogni volta che lo scrittore o il lettore si dimensionano. Questo valore viene misurato ogni secondo. Per ogni cluster in cui intendi utilizzare DocumentDB serverless, definisci un intervallo di capacità: i valori di capacità minima e massima tra cui ogni writer o lettore serverless di DocumentDB può scalare. L'intervallo di capacità è lo stesso per ogni writer o lettore serverless DocumentDB in un cluster. Ogni writer o lettore serverless di DocumentDB ha una propria capacità, che rientra in questo intervallo.
DocumentDB serverless è supportato solo in DocumentDB 5.0.0 (non supportato nella versione 8.0) con un intervallo di capacità compreso tra 0,5 e 256. DCUs
La capacità serverless di DocumentDB minima che è possibile definire è 0,5. DCUs È possibile specificare un numero più alto se è inferiore o uguale al valore di capacità massima supportata. L'impostazione della capacità minima su un numero ridotto consente ai cluster con carichi leggeri di consumare risorse di elaborazione minime. Allo stesso tempo, rimangono pronti ad accettare immediatamente le connessioni e a dimensionarsi quando diventano impegnati.
Si consiglia di impostare il valore minimo su un valore che consenta a ogni scrittore o lettore di conservare il set di lavoro dell'applicazione nel pool di buffer. In questo modo, il contenuto del buffer pool non viene scartato durante i periodi di inattività. Per tutte le considerazioni relative alla scelta dell'intervallo di capacità di scalabilità, vedere. [Scelta dell'intervallo di capacità di scalabilità per un cluster serverless DocumentDB](docdb-serverless-scaling-config.md#docdb-serverless-scaling-capacity-choosing)
A seconda di come si configurano le istanze di lettura in un’implementazione Multi-AZ, le loro capacità possono essere collegate alla capacità dell’istanza di scrittura o rimanere indipendenti. Per i dettagli su come eseguire queste operazioni, consulta [Visualizzazione e modifica del livello di promozione dei lettori serverless](docdb-serverless-managing.md#docdb-serverless-promo-tier).
Il monitoraggio di DocumentDB serverless implica la misurazione dei valori di capacità dello scrittore e dei lettori nel cluster nel tempo. Se il database non viene si dimensiona verso il basso fino alla capacità minima, puoi intraprendere azioni come la regolazione del minimo e l'ottimizzazione dell'applicazione database. Se il database raggiunge costantemente la sua capacità massima, puoi intraprendere operazioni come l'aumento di tale vincolo. Puoi inoltre ottimizzare l'applicazione di database e distribuire il carico di query su più lettori.
I costi per la capacità serverless di DocumentDB sono misurati in termini di ore DCU-ora. [Per informazioni su come vengono calcolate le tariffe serverless di DocumentDB, consulta i prezzi di Amazon DocumentDB.](https://aws.amazon.com//documentdb/pricing) Supponiamo che il numero totale di istanze di scrittura e di lettura nel cluster sia n. In tal caso, il cluster consuma almeno circa n x DCUs quando non è in esecuzione alcuna operazione di database. Amazon DocumentDB stesso potrebbe eseguire operazioni di monitoraggio o manutenzione che causano una piccola quantità di carico. Quel cluster non consuma più di n x al massimo DCUs quando il database è in esecuzione a piena capacità.
Per ulteriori dettagli sulla scelta dei valori DCU minimi e massimi appropriati, vedere. [Scelta dell'intervallo di capacità di scalabilità per un cluster serverless DocumentDB](docdb-serverless-scaling-config.md#docdb-serverless-scaling-capacity-choosing) I valori DCU minimo e massimo specificati influiscono anche su alcuni limiti delle istanze di Amazon DocumentDB. Per dettagli sull'interazione tra l'intervallo di capacità e i limiti delle istanze, consulta. [Limiti delle istanze serverless di Amazon DocumentDB](docdb-serverless-instance-limits.md)
## Scalabilità senza server di Amazon DocumentDB
Per ogni writer o lettore serverless di DocumentDB, Amazon DocumentDB monitora continuamente l'utilizzo di risorse come CPU, memoria e rete. Queste misurazioni sono chiamate collettivamente carico. Il carico include le operazioni di database eseguite dall'applicazione. Include anche l'elaborazione in background per il server di database e le attività amministrative di Amazon DocumentDB. Quando la capacità è limitata da uno di questi fattori, DocumentDB serverless è scalabile verso l'alto. DocumentDB serverless è inoltre scalabile verso l'alto quando rileva problemi di prestazioni che può risolvere in questo modo. È possibile monitorare l'utilizzo delle risorse e il modo in cui influisce sulla scalabilità serverless di DocumentDB utilizzando le procedure incluse in. [Monitoraggio di Amazon DocumentDB senza server](docdb-serverless-monitoring.md)
Il carico può variare tra lo scrittore e i lettori del cluster. Il writer gestisce le operazioni di scrittura ed esegue tutte le modifiche ai dati sul volume del cluster. I lettori possono elaborare richieste di sola lettura.
Il ridimensionamento è l'operazione che aumenta o diminuisce la capacità serverless di DocumentDB per il database. Con DocumentDB serverless, ogni scrittore e lettore ha il proprio valore di capacità attuale, misurato in. DCUs DocumentDB serverless ridimensiona un writer o un lettore fino a una capacità superiore quando la sua capacità attuale è troppo bassa per gestire il carico. Ridimensiona lo scrittore o il lettore a una capacità inferiore quando la sua capacità corrente è superiore a quella necessaria.
DocumentDB serverless può aumentare la capacità in modo incrementale. Quando la richiesta di carico di lavoro inizia a raggiungere l'attuale capacità di database di uno scrittore o di un lettore, DocumentDB serverless aumenta il numero DCUs di file per tale scrittore o lettore. DocumentDB serverless ridimensiona la capacità negli incrementi richiesti per fornire le migliori prestazioni per le risorse consumate. La scalabilità avviene con incrementi fino a 0,5. DCUs Maggiore è la capacità attuale, maggiore è l'incremento nel dimensionamento e quindi più velocemente può essere garantito il dimensionamento.
Poiché il ridimensionamento serverless di DocumentDB è così frequente, granulare e senza interruzioni, non causa eventi discreti in. Console di gestione AWS Puoi invece misurare i CloudWatch parametri di Amazon come `serverlessDatabaseCapacity` e `DCUUtilization` tenere traccia dei loro valori minimi, massimi e medi nel tempo. Per ulteriori informazioni sul monitoraggio di DocumentDB senza server, vedere. [Monitoraggio di Amazon DocumentDB senza server](docdb-serverless-monitoring.md)
La scalabilità verso l'alto o verso il basso può essere causata da quanto segue:
+ Utilizzo della memoria
+ Utilizzo CPU
+ Utilizzo rete
+ Utilizzo dell'archiviazione
È possibile monitorare queste cause di scalabilità up/down sulle istanze serverless di DocumentDB. Per ulteriori informazioni, consulta [Monitoraggio di Amazon DocumentDB senza server](docdb-serverless-monitoring.md).
Puoi scegliere di creare un dimensionamento del lettore in modo contemporaneo allo scrittore associato o indipendentemente da questo. Tale obiettivo si raggiunge specificando il livello di promozione per quel lettore.
+ I lettori serverless di DocumentDB, nei livelli di promozione 0 e 1, scalano contemporaneamente a quelli di chi scrive. Questo comportamento di dimensionamento rende i lettori con livelli prioritari 0 e 1 ideali per la disponibilità. Questo perché sono sempre dimensionati alla capacità giusta per assumere il carico di lavoro dallo scrittore in caso di failover.
+ I lettori nei livelli di promozione da 2 a 15 si dimensionano indipendentemente dallo scrittore. Ogni lettore rimane entro i valori DCU minimi e massimi specificati per il cluster. Quando un lettore si dimensiona indipendentemente dallo scrittore del database associato, può diventare inattivo e dimensionarsi verso il basso mentre lo scrittore continua a elaborare un volume elevato di transazioni. Se nessun altro lettore è disponibile in livelli di promozione inferiori rimane ancora disponibile come target di failover. Tuttavia, se viene promosso al ruolo di scrittore, potrebbe essere necessario un dimensionamento verso l'alto per gestire l'intero carico di lavoro dello scrittore.
Per informazioni dettagliate sulla visualizzazione e la modifica dei livelli di promozione delle istanze serverless, consulta. [Visualizzazione e modifica del livello di promozione dei lettori serverless](docdb-serverless-managing.md#docdb-serverless-promo-tier)
La scalabilità serverless di DocumentDB può avvenire mentre le connessioni al database sono aperte, mentre le transazioni sono in corso, ecc. DocumentDB serverless non aspetta che arrivi un punto di silenzio per iniziare la scalabilità. Il dimensionamento non interrompe le operazioni del database in corso.
Se il carico di lavoro richiede una capacità di lettura superiore a quella disponibile con un singolo writer e un singolo lettore, puoi aggiungere più lettori serverless DocumentDB al cluster. Ogni lettore serverless DocumentDB può essere scalato entro l'intervallo di valori di capacità minima e massima specificati per il cluster. Puoi utilizzare l'endpoint di lettura del cluster per gestire le sessioni di sola lettura attraverso i lettori e ridurre il carico sullo scrittore.
Il fatto che DocumentDB serverless esegua la scalabilità e la velocità con cui avviene il ridimensionamento una volta avviato, dipende anche dalle impostazioni DCU minime e massime per il cluster. Inoltre, dipendono dal fatto che un lettore sia configurato per dimensionarsi contemporaneamente allo scrittore o indipendentemente da esso. Per i dettagli sulla configurazione di scalabilità, vedere. [Configurazione di scalabilità senza server di Amazon DocumentDB](docdb-serverless-scaling-config.md)
## Stato di inattività (0,5) DCUs
Quando gli scrittori o i lettori serverless di Amazon DocumentDB sono inattivi, le istanze serverless di DocumentDB supportano la scalabilità fino a uno stato di inattività di 0,5 se quello del cluster è configurato su DCUs 0,5. MinCapacity
Nello stato di inattività, le istanze serverless di DocumentDB non dispongono di una capacità di elaborazione della CPU sufficiente per supportare la maggior parte dei carichi di lavoro di produzione, ma sono pronte a scalare rapidamente per supportare un nuovo carico di lavoro. In uno stato non inattivo, le istanze serverless di DocumentDB richiedono in genere almeno 1,0 - 2,5. DCUs Pertanto, quando le istanze serverless di DocumentDB passano da uno stato inattivo a uno non inattivo, aumenteranno direttamente fino a 1,0 - 2,5 DCUs (o al valore di se è inferiore). MaxCapacity
Per supportare la scalabilità fino a 0,5 DCUs quando sono inattive, i limiti delle istanze sono limitati se la configurazione MinCapacity è inferiore o uguale a 1,0. DCUs Per ulteriori informazioni su come i limiti sono influenzati dalla MinCapacity configurazione, consulta. [Limiti delle istanze serverless di Amazon DocumentDB](docdb-serverless-instance-limits.md)
# Requisiti e limitazioni per DocumentDB serverless
## Requisiti delle funzionalità
### Disponibilità nelle regioni
Il tipo di istanza serverless di Amazon DocumentDB è disponibile nelle seguenti regioni:
Il AWS CLI comando seguente può essere usato per verificare le esatte opzioni di istanza serverless di DocumentDB offerte in una particolare regione:
```
aws docdb describe-orderable-db-instance-options \
--region my_region \
--db-instance-class db.serverless \
--engine docdb
```
### Disponibilità della versione del motore
DocumentDB serverless è supportato solo dalla versione del motore di Amazon DocumentDB 5.0.0. Non è disponibile nelle versioni del motore 3.6, 4.0 o 8.0.
**Nota**
DocumentDB serverless è supportato solo nelle versioni patch più recenti della 5.0.0. Assicurati che il tuo cluster sia aggiornato a una versione recente delle patch del motore. Per ulteriori informazioni sulla manutenzione dei cluster Amazon DocumentDB, consulta [Manutenzione di Amazon DocumentDB](db-instance-maintain.md)
### Configurazione del cluster
Prima di aggiungere qualsiasi istanza serverless di Amazon DocumentDB a un cluster Amazon DocumentDB, il cluster deve disporre anche del set di parametri. `ServerlessV2ScalingConfiguration` Questo definisce l'intervallo di capacità delle istanze serverless di DocumentDB nel cluster. Per ulteriori informazioni sulla configurazione di scalabilità, vedere. [Configurazione di scalabilità senza server di Amazon DocumentDB](docdb-serverless-scaling-config.md)
### Impostazioni minime dell'intervallo di capacità di scalabilità per alcune funzionalità di Amazon DocumentDB
Alcune funzionalità di Amazon DocumentDB funzionano con DocumentDB serverless, ma potrebbero causare problemi se l'intervallo di capacità è inferiore a quello necessario per i requisiti di memoria per tali funzionalità con un carico di lavoro specifico. In tal caso, il database potrebbe non funzionare come al solito o potrebbe riscontrare errori. out-of-memory
Le seguenti funzionalità richiedono la configurazione di un `MinCapacity` and/or `MaxCapacity` valore superiore per un funzionamento ottimale:
+ Approfondimenti sulle prestazioni
+ Cluster globali (si applica solo ai cluster Regione AWS primari)
+ Creazione di istanze senza server su un cluster con un grande volume di dati
Ciò include la creazione di istanze serverless come parte di un ripristino del cluster.
Per consigli sull'impostazione dell'intervallo di capacità appropriato (se si utilizza questa funzionalità), vedere[Scelta dell'intervallo di capacità di scalabilità per un cluster serverless DocumentDB](docdb-serverless-scaling-config.md#docdb-serverless-scaling-capacity-choosing). Per informazioni sulla risoluzione dei problemi nel caso in cui il database riscontri out-of-memory errori dovuti a un intervallo di capacità non configurato correttamente, vedere. [Evitare gli errori out-of-memory](docdb-serverless-scaling-config.md#docdb-serverless-scaling-mem-errors)
# Creazione di un cluster che utilizza Amazon DocumentDB serverless
## Creazione di un cluster serverless Amazon DocumentDB
Con Amazon DocumentDB serverless, i cluster sono intercambiabili con i cluster forniti. È possibile disporre di cluster in cui alcune istanze utilizzano la modalità serverless e altre vengono fornite.
Verificate che la regione e la versione del motore desiderate supportino DocumentDB serverless. Per informazioni, consulta [Requisiti e limitazioni per DocumentDB serverless](docdb-serverless-limitations.md).
Per creare un cluster Amazon DocumentDB in cui aggiungere istanze serverless, segui la stessa procedura descritta in. [Creazione di un cluster Amazon DocumentDB](db-cluster-create.md) L'unica differenza è che deve essere fornito anche l'`ServerlessV2ScalingConfiguration`argomento.
L'`ServerlessV2ScalingConfiguration`argomento specifica l'intervallo di capacità di scalabilità delle istanze serverless di DocumentDB. È costituito dai valori minimo e massimo dell'unità di capacità DocumentDB (DCU) che si applicano a tutte le istanze serverless di DocumentDB nel cluster:
+ Il `MinCapacity` valore specifica la capacità di scalabilità minima.
+ Il `MaxCapacity` valore specifica la capacità di scalabilità massima.
Per ulteriori informazioni sul dimensionamento, consultare [Configurazione di scalabilità senza server di Amazon DocumentDB](docdb-serverless-scaling-config.md).
------
#### [ Using the Console di gestione AWS ]
Il seguente esempio Console di gestione AWS di configurazione mostra come creare un cluster serverless DocumentDB.
1. Accedi [Console di gestione AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1)e apri la console Amazon DocumentDB.
1. Nel pannello di navigazione scegliere **Cluster**.
**Suggerimento**
Se il riquadro di navigazione non viene visualizzato sul lato sinistro della schermata, scegliere l'icona del menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-menu-icon.png)) nell'angolo in alto a sinistra della pagina.
Viene visualizzata la tabella **Clusters**.
1. Scegli **Create** (Crea).
Viene visualizzata la pagina **Crea cluster Amazon DocumentDB**.
1. Nella pagina Crea cluster Amazon DocumentDB, nella sezione **Tipo di cluster**, scegli Cluster **basato su istanze** (questa è l'opzione predefinita).
1. Nella sezione Configurazione del **cluster**:
1. Per l'**identificatore del cluster**, inserisci un nome univoco, ad esempio**myserverlesscluster**. Tieni presente che la console cambierà tutti i nomi dei cluster in lettere minuscole indipendentemente da come vengono immessi.
1. Per la **versione Engine**, scegli **5.0.0** (questa è l'opzione predefinita).
1. Nella sezione **Configurazione dello storage del cluster**, scegli **Amazon DocumentDB Standard** (questa è l'opzione predefinita).
**Nota**
L'altra opzione in questa categoria è **Amazon DocumentDB** I/O Optimized. Per ulteriori informazioni su entrambe le opzioni, consulta [Configurazioni di storage in cluster Amazon DocumentDB](db-cluster-storage-configs.md)
1. Nella sezione **Configurazione dell'istanza**:
1. Per **Classe di istanza database** scegli **Serverless**.
1. Per **Numero di istanze di replica regolari**, scegli **3** (questa è l'opzione predefinita).
1. **Nella sezione **Intervallo di capacità**, lascia i valori predefiniti per **Minimo DCUs e Massimo**. DCUs** Per informazioni sull'impostazione di questi parametri, vedere[Limiti delle istanze serverless di Amazon DocumentDB](docdb-serverless-instance-limits.md).
![\[Modulo di configurazione per un cluster di database senza server con campi per esempio classe, istanze di replica e intervallo di capacità.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/instance-config-serverless.png)
1. Nella sezione **Connettività**, lascia l'impostazione predefinita di **Non connetterti a una risorsa di calcolo EC2**.
1. Nella sezione **Autenticazione**, inserisci un nome utente per l'utente principale, quindi scegli Gestione **automatica**. Inserisci una password, quindi confermala.
Se invece hai scelto **Gestito in Gestione dei segreti AWS**, consulta [Gestione delle password con Amazon DocumentDB e Gestione dei segreti AWS](docdb-secrets-manager.md) per ulteriori informazioni.
1. Lascia tutte le altre opzioni come predefinite e scegli **Crea cluster**.
------
#### [ Using the AWS CLI ]
Nell'esempio seguente, sostituisci ognuna *user input placeholder* con le tue informazioni o parametri di configurazione.
Per creare un cluster compatibile con le istanze serverless di DocumentDB utilizzando il, vedere. AWS CLI[Creazione di un cluster utilizzando il AWS CLI](db-cluster-create.md#db-cluster-create-cli)
Includi i seguenti parametri aggiuntivi nel comando: `create-db-cluster`
```
--serverless-v2-scaling-configuration
MinCapacity=minimum_capacity,MaxCapacity=maximum_capacity
```
Esempio:
```
aws docdb create-db-cluster \
--db-cluster-identifier sample-cluster \
--engine docdb \
--engine-version 5.0.0 \
--serverless-v2-scaling-configuration MinCapacity=0.5,MaxCapacity=16 \
--master-username user-name \
--master-user-password password
```
------
## Aggiungere un'istanza serverless di Amazon DocumentDB
Per aggiungere un'istanza serverless di DocumentDB, segui la stessa procedura descritta in[Aggiungere un'istanza Amazon DocumentDB a un cluster](db-instance-add.md), assicurandoti di specificare db.serverless come classe dell'istanza.
### Aggiungere un'istanza serverless utilizzando. Console di gestione AWS
**Per aggiungere un'istanza serverless di DocumentDB utilizzando la console, consultate [Aggiungere un'istanza Amazon DocumentDB a un cluster](db-instance-add.md) e scegliete la scheda Utilizzo della scheda. Console di gestione AWS**
### Aggiungere un'istanza serverless utilizzando il AWS CLI
**Per aggiungere un'istanza serverless di DocumentDB utilizzando AWS CLI, consultate [Aggiungere un'istanza Amazon DocumentDB a un cluster](db-instance-add.md) e scegliete la scheda Utilizzo della scheda. AWS CLI**
Usa il seguente argomento CLI della classe di istanza:
```
--db-instance-class db.serverless
```
Esempio:
```
aws docdb create-db-instance \
--db-cluster-identifier sample-cluster \
--db-instance-identifier sample-instance \
--db-instance-class db.serverless \
--engine docdb
```
# Migrazione a Amazon DocumentDB serverless
**Topics**
+ [Migrazione dei cluster DocumentDB esistenti verso i cluster serverless](#w2aac41c19b5)
+ [Migrazione da MongoDB a DocumentDB serverless](#w2aac41c19b7)
## Migrazione dei cluster DocumentDB esistenti verso i cluster serverless
### Aggiornamento della versione del motore di un cluster
Se il cluster a cui è stato assegnato il provisioning utilizza una versione precedente del motore che non supporta DocumentDB serverless, è necessario prima aggiornare il cluster a una versione del motore supportata. Per ulteriori informazioni, consulta [Aggiornamento immediato della versione principale di Amazon DocumentDB](docdb-mvu.md).
### Migrazione di un cluster fornito a DocumentDB serverless
Per passare da un cluster a cui è stato assegnato il provisioning all'utilizzo di DocumentDB serverless, segui questi passaggi:
1. Verifica se la versione del motore del cluster fornito deve essere aggiornata per essere utilizzata con DocumentDB serverless. Per informazioni, consulta [Requisiti e limitazioni per DocumentDB serverless](docdb-serverless-limitations.md).
**Nota**
Se il cluster fornito esegue una versione del motore che non è disponibile per DocumentDB serverless, aggiorna la versione del motore del cluster. Per informazioni, consulta [Aggiornamento immediato della versione principale di Amazon DocumentDB](docdb-mvu.md).
1. Definire la configurazione di dimensionamento per il cluster. Per i dettagli sulla scelta della configurazione di scalabilità, vedere. [Scelta dell'intervallo di capacità di scalabilità per un cluster serverless DocumentDB](docdb-serverless-scaling-config.md#docdb-serverless-scaling-capacity-choosing) Per modificare la configurazione di scalabilità per un cluster, vedere. [Visualizzazione e modifica della configurazione dell'intervallo di capacità di scalabilità di un cluster](docdb-serverless-managing.md#docdb-serverless-range-config)
1. Configura qualsiasi altra proprietà del cluster per tenere conto dei requisiti e delle limitazioni serverless di DocumentDB. [Requisiti e limitazioni per DocumentDB serverless](docdb-serverless-limitations.md)
1. Aggiungi una o più istanze serverless di DocumentDB al cluster. Segui la procedura riportata in [Aggiungere un'istanza serverless di Amazon DocumentDB](docdb-serverless-create-cluster.md#docdb-serverless-adding-instance).
**Nota**
In alcuni casi, è possibile che nel cluster siano già presenti una o più istanze Reader predisposte. In tal caso, puoi scegliere di convertire uno dei lettori in un'istanza serverless di DocumentDB invece di creare una nuova istanza. A tale scopo, segui la procedura in [Modifica della classe di un'istanza](db-instance-classes.md#db-instance-class-changing).
1. (Facoltativo) Eseguite un'operazione di failover per rendere un'istanza DocumentDB serverless il cluster writer. Per informazioni, consulta [Failover di Amazon DocumentDB](failover.md).
1. (Facoltativo) Converti tutte le istanze Amazon DocumentDB con provisioning rimanenti in istanze serverless DocumentDB [Modifica della classe di un'istanza](db-instance-classes.md#db-instance-class-changing) (vedi) o rimuovile dal cluster (vedi). [Eliminazione di un'istanza Amazon DocumentDB](db-instance-delete.md)
------
#### [ Using the Console di gestione AWS ]
Il seguente esempio di Console di gestione AWS configurazione mostra il processo di migrazione utilizzando un cluster con provisioning di Amazon DocumentDB che esegue Amazon DocumentDB 5.0.0, che non richiede l'aggiornamento della versione del motore per iniziare a utilizzare DocumentDB serverless. Il cluster è denominato e inizia con tre istanze assegnate denominate`sample`, e. `sample` `sample2` `sample3` In questo esempio, queste tre istanze verranno sostituite da tre istanze serverless.
1. Accedi [Console di gestione AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1)e apri la console Amazon DocumentDB.
1. Nel pannello di navigazione scegliere **Cluster**.
**Suggerimento**
Se il riquadro di navigazione non viene visualizzato sul lato sinistro della schermata, scegliere l'icona del menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-menu-icon.png)) nell'angolo in alto a sinistra della pagina.
Viene visualizzata la tabella **Clusters**.
1. Nella tabella **Cluster**, seleziona la casella di controllo del cluster a cui desideri aggiungere un'istanza serverless.
1. Scegli **Actions (Operazioni)**, quindi **Add instance (Aggiungi istanza)**.
1. Nella finestra di dialogo **Aggiungi istanze**, seleziona **Serverless** nella sezione **Classe di istanza DB per ogni nuova istanza** serverless che desideri creare.
1. Per **le impostazioni della capacità serverless**, imposta la configurazione di scalabilità in base alla descrizione della capacità nella finestra di dialogo.
1. (Facoltativo) Per aggiungere un'altra istanza, scegli **Aggiungi** istanza. Continuate ad aggiungere istanze fino a raggiungere il numero desiderato di nuove istanze.
In questo esempio, vengono create tre nuove istanze serverless.
1. Scegli **Create** (Crea).
La creazione dell'istanza richiede diversi minuti. È possibile utilizzare la console o il AWS CLI per visualizzare lo stato dell'istanza. Per ulteriori informazioni, consulta [Monitoraggio dello stato di un cluster Amazon DocumentDB](https://docs.aws.amazon.com//documentdb/latest/developerguide/monitoring_docdb-cluster_status.html).
1. Tornando alla tabella **Cluster**, seleziona le caselle di controllo di tutte e tre le istanze fornite originariamente.
1. Scegli **Azioni**, quindi **Elimina**.
Durante l'eliminazione, viene eseguito automaticamente un failover per promuovere una delle istanze rimanenti al ruolo di writer. Dopo alcuni minuti, il processo di eliminazione è completato. **Il cluster esistente contiene ora tre istanze serverless di DocumentDB (come definito nella colonna Size).**
------
#### [ Using the AWS CLI ]
Il seguente esempio di AWS CLI configurazione mostra il processo di migrazione utilizzando un cluster con provisioning di Amazon DocumentDB che esegue Amazon DocumentDB 5.0.0, che non richiede l'aggiornamento della versione del motore per iniziare a utilizzare DocumentDB serverless. Il cluster è denominato e inizia con tre istanze assegnate denominate`sample`, e. `sample` `sample2` `sample3` In questo esempio, queste tre istanze verranno sostituite da tre istanze serverless. Il cluster è denominato `sample-cluster` e inizia con due istanze assegnate denominate `sample-provisioned-instance-1` and`sample-provisioned-instance-2`, un'istanza writer e un'istanza reader.
Nell'esempio seguente, sostituite ognuna *user input placeholder* con informazioni o parametri di configurazione personalizzati.
Utilizzate l'`aws docdb describe-db-clusters`operazione per determinare lo stato di un cluster. Il codice seguente trova lo stato del cluster `sample-cluster` e restituisce i risultati in una tabella:
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].DBClusterMembers' \
--output table
```
```
--------------------------------------------------------------------------------------------------------
| DescribeDBClusters |
+--------------------------------+---------------------------------+------------------+----------------+
| DBClusterParameterGroupStatus | DBInstanceIdentifier | IsClusterWriter | PromotionTier |
+--------------------------------+---------------------------------+------------------+----------------+
| in-sync | sample-provisioned-instance-2 | False | 1 |
| in-sync | sample-provisioned-instance-1 | True | 1 |
+--------------------------------+---------------------------------+------------------+----------------+
```
Aggiungi la configurazione di scalabilità per il cluster:
```
aws docdb modify-db-cluster \
--db-cluster-identifier sample-cluster \
--serverless-v2-scaling-configuration MinCapacity=0.5,MaxCapacity=16
```
Aggiungi le istanze serverless. In questo esempio, vengono aggiunte nuove istanze serverless `sample-serverless-instance-1` denominate e aggiunte: `sample-serverless-instance-2`
```
aws docdb create-db-instance \
--db-cluster-identifier sample-cluster \
--db-instance-identifier sample-serverless-instance-1 \
--db-instance-class db.serverless \
--engine docdb
aws docdb create-db-instance \
--db-cluster-identifier sample-cluster \
--db-instance-identifier sample-serverless-instance-2 \
--db-instance-class db.serverless \
--engine docdb
```
Inserisci quanto segue per attendere che le istanze serverless siano disponibili prima di procedere:
```
aws docdb wait db-instance-available \
--db-instance-identifier sample-serverless-instance-1
aws docdb wait db-instance-available \
--db-instance-identifier sample-serverless-instance-2
```
Esegui un failover per rendere la nuova `sample-serverless-instance-1` istanza lo scrittore del cluster:
```
aws docdb failover-db-cluster \
--db-cluster-identifier sample-cluster \
--target-db-instance-identifier sample-serverless-instance-1
```
Il completamento del failover richiede alcuni secondi, dopodiché sample-serverless-instance -1 diventa lo scrittore del cluster. Verificatelo con il seguente input:
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].DBClusterMembers' \
--output table
```
```
--------------------------------------------------------------------------------------------------------
| DescribeDBClusters |
+--------------------------------+---------------------------------+------------------+----------------+
| DBClusterParameterGroupStatus | DBInstanceIdentifier | IsClusterWriter | PromotionTier |
+--------------------------------+---------------------------------+------------------+----------------+
| in-sync | sample-provisioned-instance-2 | False | 1 |
| in-sync | sample-provisioned-instance-1 | False | 1 |
| in-sync | sample-serverless-instance-2 | False | 1 |
| in-sync | sample-serverless-instance-1 | True | 1 |
+--------------------------------+---------------------------------+------------------+----------------+
```
Infine, elimina le istanze fornite originariamente:
```
aws docdb delete-db-instance \
--db-instance-identifier sample-provisioned-instance-1
aws docdb delete-db-instance \
--db-instance-identifier sample-provisioned-instance-2
```
------
## Migrazione da MongoDB a DocumentDB serverless
Puoi migrare i tuoi database MongoDB su DocumentDB senza server, proprio come con Amazon DocumentDB fornito. Per ulteriori informazioni, consulta [Migrazione ad Amazon DocumentDB](docdb-migration.md).
# Gestione senza server di Amazon DocumentDB
## Visualizzazione e modifica della configurazione dell'intervallo di capacità di scalabilità di un cluster
L'`ServerlessV2ScalingConfiguration`argomento specifica l'intervallo di capacità di scalabilità delle istanze serverless di DocumentDB. È costituito dai valori minimo e massimo dell'unità di capacità DocumentDB (DCU) che si applicano a tutte le istanze serverless di DocumentDB nel cluster.
+ **`MinCapacity`**— La capacità di scalabilità minima di qualsiasi istanza serverless di DocumentDB nel cluster.
+ **`MaxCapacity`**— La capacità di scalabilità massima di tutte le istanze serverless di DocumentDB nel cluster.
**Nota**
Le seguenti modifiche alla configurazione di scalabilità richiedono il riavvio dell'istanza per riflettere i nuovi valori AND: `MinCapacity` `MaxCapacity`
Eventuali modifiche al valore `MaxCapacity`
Modifica del `MinCapacity` valore a 1,0 o inferiore da un valore più alto
Modificare il `MinCapacity` valore da un valore inferiore a 1,0 a un valore maggiore di 1,0
Per ulteriori informazioni sulla configurazione di scalabilità e su come selezionare i limiti di capacità di scalabilità appropriati, vedere. [Configurazione di scalabilità senza server di Amazon DocumentDB](docdb-serverless-scaling-config.md)
------
#### [ Using the Console di gestione AWS ]
Il seguente esempio Console di gestione AWS di configurazione mostra come visualizzare e modificare le impostazioni di configurazione di scalabilità di un cluster serverless DocumentDB.
1. Accedi [Console di gestione AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1)e apri la console Amazon DocumentDB.
1. Nel pannello di navigazione scegliere **Cluster**.
**Suggerimento**
Se il riquadro di navigazione non viene visualizzato sul lato sinistro della schermata, scegliere l'icona del menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-menu-icon.png)) nell'angolo in alto a sinistra della pagina.
Viene visualizzata la tabella **Clusters**.
1. Nella tabella **Cluster**, selezionare la casella di controllo del cluster in cui si desidera modificare la capacità di scalabilità.
1. Scegli **Actions (Operazioni)**, quindi **Modify (Modifica)**.
Viene visualizzata la finestra di dialogo **Modifica cluster**.
1. Individuate la sezione di **impostazione della capacità serverless** e impostate la configurazione di scalabilità (**intervallo di capacità**) in base alla descrizione della capacità nella finestra di dialogo.
Per ulteriori informazioni sulla scalabilità e sugli intervalli di capacità, vedere. [Configurazione di scalabilità senza server di Amazon DocumentDB](docdb-serverless-scaling-config.md)
1. Scegli **Continue** (Continua).
1. In **Scheduling of Modifications (Pianificazione delle modifiche)**, scegliere **Apply immediately (Applica immediatamente)**.
1. Scegliere **Modify cluster (Modifica cluster)**.
1. Una volta completata la modifica, ogni istanza serverless deve essere riavviata. Per ridurre al minimo l'indisponibilità del writer, esegui la seguente sequenza di operazioni:
1. Riavviate ogni istanza del lettore serverless.
1. **Seleziona l'istanza del lettore, scegli **Azioni**, quindi Riavvia.**
1. Attendi che lo stato dell'istanza ritorni a **Disponibile**.
1. Esegui un failover su un'istanza serverless riavviata.
1. **Seleziona il cluster, scegli **Azioni**, quindi Failover.**
1. Attendi il completamento dell'operazione di failover.
1. Riavviare l'istanza serverless rimanente.
1. **Seleziona l'istanza rimanente, scegli **Azioni**, quindi Riavvia.**
1. Attendi che lo stato dell'istanza ritorni a **Disponibile**.
------
#### [ Using the AWS CLI ]
Il seguente esempio AWS CLI di configurazione mostra la configurazione di ridimensionamento corrente.
Nell'esempio seguente, sostituite ciascuno di essi *user input placeholder* con informazioni o parametri di configurazione personalizzati.
L'attuale configurazione di ridimensionamento del cluster può essere visualizzata utilizzando il `describe-db-clusters` AWS CLI comando:
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[0].ServerlessV2ScalingConfiguration'
```
L'output di questo comando è il seguente:
```
{
"MinCapacity": 0.5,
"MaxCapacity": 16.0
}
```
La configurazione di scalabilità del cluster può essere modificata utilizzando il `modify-db-cluster` comando:
```
aws docdb modify-db-cluster \
--db-cluster-identifier sample-cluster \
--serverless-v2-scaling-configuration MinCapacity=0.5,MaxCapacity=32
```
Una volta completata, ogni istanza serverless deve essere riavviata. Per ridurre al minimo l'indisponibilità degli scrittori, possiamo eseguire la seguente sequenza di operazioni:
```
aws docdb reboot-db-instance \
--db-instance-identifier sample-serverless-instance-reader
aws docdb wait db-instance-available \
--db-instance-identifier sample-serverless-instance-reader
aws docdb failover-db-cluster \
--db-cluster-identifier sample-cluster \
--target-db-instance-identifier sample-serverless-instance-reader
aws docdb reboot-db-instance \
--db-instance-identifier sample-serverless-instance-writer
aws docdb wait db-instance-available \
--db-instance-identifier sample-serverless-instance-writer
aws docdb failover-db-cluster \
--db-cluster-identifier sample-cluster \
--target-db-instance-identifier sample-serverless-instance-writer
```
------
## Visualizzazione e modifica del livello di promozione dei lettori serverless
Per i cluster contenenti più istanze serverless di DocumentDB o una combinazione di istanze serverless e con provisioning, prestate attenzione all'impostazione del livello di promozione per ogni istanza serverless. Questa impostazione controlla più comportamenti per le istanze serverless rispetto alle istanze con provisioning.
Per le istanze con provisioning, la scelta del livello 0-15 determina solo l'ordine in cui Amazon DocumentDB sceglie quale istanza di lettura promuovere al writer durante un'operazione di failover. Tuttavia, per le istanze serverless, il numero del livello determina anche se l'istanza è scalabile fino a soddisfare la capacità dell'istanza di writer o se è scalabile indipendentemente in base al proprio carico di lavoro. Le istanze di lettura serverless di livello 0 o 1 vengono mantenute a una capacità minima almeno pari a quella dell'istanza writer. In questo modo, sono pronte a sostituire l'istanza writer in caso di failover. Se l'istanza writer è un'istanza fornita, Amazon DocumentDB stima la capacità serverless di DocumentDB equivalente. Utilizza tale stima come capacità minima per l'istanza serverless reader.
Le istanze di lettore serverless DocumentDB nei livelli da 2 a 15 non hanno lo stesso vincolo sulla capacità minima. Quando sono inattivi, possono ridursi al valore minimo dell'unità di capacità DocumentDB (DCU) specificato nell'intervallo di capacità del cluster.
------
#### [ Using the Console di gestione AWS ]
L'esempio di Console di gestione AWS configurazione seguente mostra come visualizzare e modificare le impostazioni del livello promozionale di un lettore di istanze serverless DocumentDB.
1. Accedi [Console di gestione AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1)e apri la console Amazon DocumentDB.
I livelli di promozione di ogni istanza vengono visualizzati nella colonna **Livello di promozione** di. Console di gestione AWS
1. Nel pannello di navigazione scegliere **Cluster**.
**Suggerimento**
Se il riquadro di navigazione non viene visualizzato sul lato sinistro della schermata, scegliere l'icona del menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-menu-icon.png)) nell'angolo in alto a sinistra della pagina.
Viene visualizzata la tabella **Cluster**.
1. Nella tabella **Cluster**, seleziona la casella di controllo dell'istanza in cui desideri modificare il livello di promozione.
1. Scegli **Actions (Operazioni)**, quindi **Modify (Modifica)**.
Viene visualizzata la finestra di dialogo **Modifica istanza**.
1. Individuate la sezione **Failover** e impostate il **livello di promozione** sul livello desiderato.
1. Scegli **Continue** (Continua).
1. In **Scheduling of Modifications (Pianificazione delle modifiche)**, scegliere **Apply immediately (Applica immediatamente)**.
1. Scegli **Modify instance (Modifica istanza)**.
------
#### [ Using the AWS CLI ]
Il seguente esempio AWS CLI di configurazione mostra la configurazione di scalabilità corrente.
Nell'esempio seguente, sostituite ciascuno di essi *user input placeholder* con informazioni o parametri di configurazione personalizzati.
I livelli di promozione di tutte le istanze di un cluster possono essere visualizzati utilizzando il `describe-db-clusters` AWS CLI comando:
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[0].DBClusterMembers' \
--output table
```
L'output di questo comando è il seguente:
```
--------------------------------------------------------------------------------------------------------
| DescribeDBClusters |
+--------------------------------+---------------------------------+------------------+----------------+
| DBClusterParameterGroupStatus | DBInstanceIdentifier | IsClusterWriter | PromotionTier |
+--------------------------------+---------------------------------+------------------+----------------+
| in-sync | sample-serverless-instance-2 | False | 1 |
| in-sync | sample-serverless-instance-1 | True | 1 |
+--------------------------------+---------------------------------+------------------+----------------+
```
Il livello di promozione di un'istanza specifica può essere modificato utilizzando il `modify-db-instance` comando:
```
aws docdb modify-db-instance \
--db-instance-identifier sample-serverless-instance-2 \
--promotion-tier 3
```
------
# Limiti delle istanze serverless di Amazon DocumentDB
Per le istanze serverless di DocumentDB, i seguenti limiti per istanza dipendono dalla capacità di scalabilità corrente dell'istanza:
+ Memoria a istanze (GiB)
+ Connessioni (tutte)
+ Limite del cursore
+ Transazioni aperte
+ Connessioni (attive)
Le tabelle seguenti descrivono come i limiti per istanza delle istanze serverless si ridimensionano in relazione all'attuale capacità di scalabilità dell'istanza.
Tieni presente che i valori limite sono diversi a seconda che la configurazione di `MinCapacity` scalabilità del cluster sia stata impostata su più di due (2). Se `MinCapacity` è impostato su minore o uguale a 2, i valori limite per il limite del cursore, le transazioni aperte e le connessioni (attive) sono limitati a un valore massimo inferiore. (Il motivo tecnico del limite è il supporto del ridimensionamento a uno stato «inattivo». Per ulteriori informazioni, consulta [Stato di inattività (0,5) DCUs](docdb-serverless-how-it-works.md#docdb-serverlerss-idle-state).
**i limiti dell'istanza db.serverless sono ≤1 MinCapacity **
| Capacità attuale (DCU) | Memoria a istanze (GiB) | Connessioni (tutte) | Limite del cursore | Transazioni aperte | Connessioni (attive) |
| --- | --- | --- | --- | --- | --- |
| 0,5 | 1 | 250 | 6 | 12 | 39 |
| 1 | 2 | 500 | 12 | 24 | 79 |
| 2 | 4 | 1000 | 24 | 48 | 173 |
| 4 | 8 | 2000 | 48 | 96 | 416 |
| 8 | 16 | 4000 | 96 | 192 | 1071 |
| 16 | 32 | 8000 | 132 | 264 | 1550 |
| 32 | 64 | 16000 | 132 | 264 | 1550 |
| 64 | 128 | 32000 | 132 | 264 | 1550 |
| 128 | 256 | 60000 | 132 | 264 | 1550 |
| 256 | 512 | 60000 | 132 | 264 | 1550 |
**limiti dell'istanza db.serverless se >1 MinCapacity **
| Capacità attuale (DCU) | Memoria a istanze (GiB) | Connessioni (tutte) | Limite del cursore | Transazioni aperte | Connessioni (attive) |
| --- | --- | --- | --- | --- | --- |
| 1.5 | 3 | 7250 | 18 | 36 | 124 |
| 2 | 4 | 1000 | 24 | 48 | 173 |
| 4 | 8 | 2000 | 48 | 96 | 416 |
| 8 | 16 | 4000 | 96 | 192 | 1071 |
| 16 | 32 | 8000 | 192 | 384 | 2709 |
| 32 | 64 | 16000 | 384 | 768 | 4500 |
| 64 | 128 | 32000 | 768 | 1536 | 4500 |
| 128 | 256 | 60000 | 1536 | 3072 | 4500 |
| 256 | 512 | 60000 | 3072 | 6144 | 4500 |
È possibile monitorare e generare allarmi in base ai limiti per istanza utilizzando le seguenti CloudWatch metriche. Per ulteriori informazioni sui CloudWatch parametri di Amazon DocumentDB, consulta. [Monitoraggio di Amazon DocumentDB con CloudWatch](cloud_watch.md)
| Risorsa | CloudWatch metrica limite | CloudWatch metrica di utilizzo (massimo 1 minuto) | CloudWatch metrica di utilizzo |
| --- | --- | --- | --- |
| Memoria di istanza | - | - | FreeableMemory |
| Connessioni (tutte) | DatabaseConnectionsLimit | DatabaseConnectionsMax | DatabaseConnections |
| Cursori | DatabaseCursorsLimit | DatabaseCursorsMax | DatabaseCursors |
| Transazioni | TransactionsOpenLimit | TransactionsOpenMax | TransactionsOpen |
# Configurazione di scalabilità senza server di Amazon DocumentDB
**Topics**
+ [Scelta dell'intervallo di capacità di scalabilità per un cluster serverless DocumentDB](#docdb-serverless-scaling-capacity-choosing)
+ [Scelta dell'`MinCapacity`impostazione per un cluster serverless DocumentDB](#docdb-serverless-scaling-mincapacity-choosing)
+ [Scelta dell'`MaxCapacity`impostazione per un cluster serverless DocumentDB](#docdb-serverless-scaling-maxcapacity-choosing)
+ [Evitare gli errori out-of-memory](#docdb-serverless-scaling-mem-errors)
+ [Perché la mia istanza serverless non si sta ridimensionando?](#docdb-serverless-scaling-down)
## Scelta dell'intervallo di capacità di scalabilità per un cluster serverless DocumentDB
Prima di aggiungere qualsiasi istanza serverless di DocumentDB a un cluster Amazon DocumentDB, il cluster deve disporre anche del set di parametri. `ServerlessV2ScalingConfiguration`
Il `ServerlessV2ScalingConfiguration` parametro è composto da due valori che definiscono l'intervallo di capacità di scalabilità senza server di qualsiasi istanza serverless del cluster:
+ **`MinCapacity`**— La capacità di scalabilità minima di qualsiasi istanza serverless di DocumentDB nel cluster.
+ **`MaxCapacity`**— La capacità di scalabilità massima di tutte le istanze serverless di DocumentDB nel cluster.
## Scelta dell'`MinCapacity`impostazione per un cluster serverless DocumentDB
Si è tentati di scegliere sempre 0,5 per. `MinCapacity` Questo valore consente all'istanza di ridimensionarsi fino alla capacità minima quando è completamente inattiva, pur rimanendo attiva. Tuttavia, a seconda del modo in cui si utilizza il cluster e delle altre impostazioni configurate, una capacità minima diversa potrebbe essere la più efficace. Considera i seguenti fattori nella scelta dell'impostazione della capacità minima:
+ La velocità di scalabilità di un'istanza serverless di DocumentDB dipende dalla sua capacità attuale. Maggiore è la capacità attuale, più veloce sarà il relativo dimensionamento verso l'alto. Se hai bisogno che l'istanza raggiunga rapidamente una capacità molto elevata, valuta la possibilità di impostare la capacità minima su un valore in cui la velocità di scalabilità soddisfi i tuoi requisiti.
+ Se in genere si modifica la classe di istanza delle istanze in previsione di un carico di lavoro particolarmente elevato o basso, è possibile utilizzare tale esperienza per effettuare una stima approssimativa dell'intervallo di capacità serverless DocumentDB equivalente. Per determinare la dimensione della memoria di un tipo di istanza Amazon DocumentDB di cui è stato effettuato il provisioning, consulta. [Limiti di istanze](limits.md#limits.instance)
Ad esempio, supponiamo di utilizzare la classe di `db.r6g.xlarge` istanza quando il cluster ha un carico di lavoro ridotto. Quella classe di istanza ha 32 GiB di memoria. Pertanto, puoi specificare un numero `MinCapacity` di 16 per configurare un'istanza serverless in grado di ridimensionarsi all'incirca fino a raggiungere la stessa capacità. Questo perché ogni DCU corrisponde a circa 2 GiB di memoria. È possibile specificare un valore leggermente inferiore per consentire all'istanza di ridimensionarsi ulteriormente nel caso in cui l'`db.r6g.xlarge`istanza venga talvolta sottoutilizzata.
+ Se l'applicazione funziona in modo più efficiente quando le istanze hanno una certa quantità di dati nella cache buffer, valuta la possibilità di specificare un'impostazione DCU minima in cui la memoria sia sufficientemente grande da contenere i dati a cui si accede di frequente. In caso contrario, alcuni dati vengono rimossi dalla cache buffer quando le istanze serverless vengono ridotte a una dimensione di memoria inferiore. Quindi, quando le istanze vengono ridimensionate di nuovo, le informazioni vengono lette nel tempo nella cache buffer. Se la quantità di dati da I/O riportare nella cache buffer è notevole, potrebbe essere più efficace scegliere un valore DCU minimo più elevato. Per ulteriori informazioni, consulta [Dimensionamento delle istanze](best_practices.md#best_practices-instance_sizing).
+ Se le istanze serverless di DocumentDB vengono eseguite per la maggior parte del tempo con una capacità particolare, valuta la possibilità di specificare un'impostazione di capacità minima inferiore a quella di base, ma non troppo inferiore. Le istanze serverless possono stimare in modo più efficace quanto e quanto velocemente scalare quando la capacità attuale non è drasticamente inferiore alla capacità richiesta.
+ Se il carico di lavoro assegnato presenta requisiti di memoria troppo elevati per classi di istanze di piccole dimensioni come T3 o T4g, scegli un'impostazione DCU minima che fornisca una memoria paragonabile a un'istanza R5 o R6g.
+ In particolare, consigliamo il seguente valore minimo da utilizzare con `MinCapacity` le funzionalità specificate (questi consigli sono soggetti a modifiche):
+ Performance Insights — 2 DCUs
+ Cluster globali: 8 DCUs (si applica solo ai cluster Regione AWS primari)
+ In Amazon DocumentDB, la replica avviene a livello di storage, quindi la capacità del lettore non influisce direttamente sulla replica. Tuttavia, per le istanze di lettura serverless di DocumentDB con scalabilità indipendente, assicurati che la capacità minima sia sufficiente per gestire i carichi di lavoro durante i periodi di scrittura intensivi per evitare la latenza delle query. Se le istanze Reader nei livelli di promozione 2—15 presentano problemi di prestazioni, prendete in considerazione l'aumento della capacità minima del cluster. Per ulteriori informazioni su come modificare la scalabilità delle istanze Reader, in base alle esigenze dell'autore o indipendentemente, consulta. [Visualizzazione e modifica del livello di promozione dei lettori serverless](docdb-serverless-managing.md#docdb-serverless-promo-tier)
Se disponete di un cluster con istanze di lettura serverless DocumentDB, i lettori non si adattano alla scala dell'istanza writer quando il livello di promozione dei lettori non è 0 o 1. In tal caso, l'impostazione di una capacità minima ridotta può comportare un eccessivo ritardo nella replica. Ciò è dovuto al fatto che le istanze di lettura potrebbero non avere capacità sufficiente per applicare le modifiche dell'istanza di scrittura quando il database è occupato. Si consiglia di impostare la capacità minima su un valore che rappresenti una quantità di memoria e CPU paragonabile a quella dell'istanza writer.
+ Il tempo impiegato da un'istanza serverless di DocumentDB per passare dalla capacità minima alla capacità massima dipende dalla differenza tra i valori DCU minimo e massimo. Quando la capacità corrente dell'istanza è elevata, DocumentDB serverless aumenta con incrementi maggiori rispetto a quando l'istanza parte da una capacità ridotta. Pertanto, se si specifica una capacità massima relativamente elevata e l'istanza trascorre la maggior parte del tempo vicino a tale capacità, è consigliabile aumentare l'impostazione DCU minima. In questo modo, un'istanza inattiva può tornare alla capacità massima più rapidamente.
+ Alcuni limiti di istanza sono determinati dalla capacità corrente dell'istanza serverless, ad esempio il limite delle connessioni, il limite del cursore e il limite delle transazioni aperte. Se la capacità attuale dell'istanza è ridotta, anche i limiti saranno altrettanto piccoli. Se questi limiti rappresentano un problema quando l'istanza serverless viene ridotta al suo `MinCapacity` valore, valuta la possibilità di `MinCapacity` aumentarne il valore. Per ulteriori informazioni, consulta [Limiti delle istanze serverless di Amazon DocumentDB](docdb-serverless-instance-limits.md).
+ Inoltre, alcuni limiti di istanza sono limitati a un valore massimo inferiore se impostato su un valore inferiore o uguale a 1,0 DCUs, ad esempio il limite delle connessioni attive, il limite del cursore e il limite delle transazioni aperte. `MinCapacity` Se questi limiti massimi non sono sufficienti per il tuo carico di lavoro, utilizza un `MinCapacity` valore di almeno 1,5. DCUs Per ulteriori informazioni, consulta [Limiti delle istanze serverless di Amazon DocumentDB](docdb-serverless-instance-limits.md).
Per istruzioni su come modificare la configurazione di scalabilità di un cluster, vedere. [Gestione senza server di Amazon DocumentDB](docdb-serverless-managing.md)
## Scelta dell'`MaxCapacity`impostazione per un cluster serverless DocumentDB
Si è tentati di scegliere sempre un valore elevato per l'impostazione massima della capacità serverless di DocumentDB. Una grande capacità massima consente all'istanza di scalare al massimo quando esegue un carico di lavoro intensivo. Un valore basso evita il rischio di dover sostenere di addebiti imprevisti. A seconda di come si utilizza il cluster e delle altre impostazioni configurate, il valore più efficace potrebbe essere maggiore o minore basso rispetto a quello originariamente individuato. Considera i seguenti fattori nella scelta dell'impostazione della capacità massima:
+ La capacità massima deve essere almeno pari alla capacità minima. Puoi impostare lo stesso valore per la capacità minima e la capacità massima. Tuttavia, in questo caso la capacità non aumenta né diminuisce mai. Pertanto, a parte gli scenari di test, l'uso di valori identici per la capacità minima e massima non è appropriato.
+ La capacità massima deve essere almeno 1,0 DCUs e deve essere al massimo 256 DCUs.
+ Ti consigliamo di monitorare la scalabilità e l'utilizzo delle risorse delle istanze serverless. Se l'istanza serverless viene spesso scalata fino alla capacità massima e soddisfa i limiti delle risorse (ad esempio quando la `DCUUtilization` metrica è pari a 100,0), ti consigliamo di selezionare un valore più alto. `MaxCapacity` Per ulteriori informazioni, consulta [Monitoraggio di Amazon DocumentDB senza server](docdb-serverless-monitoring.md).
+ Se in genere si modifica la classe di istanza delle istanze assegnate in previsione di un carico di lavoro particolarmente elevato o basso, è possibile utilizzare tale esperienza per stimare l'intervallo di capacità serverless DocumentDB equivalente. Per determinare la dimensione della memoria delle istanze di Amazon DocumentDB assegnate, consulta. [Limiti di istanze](limits.md#limits.instance)
Ad esempio, supponiamo di utilizzare la classe di `db.r6g.4xlarge` istanza quando il cluster ha un carico di lavoro elevato. Quella classe di istanza ha 128 GiB di memoria. Pertanto, è possibile specificare un'impostazione DCU massima di 64 per configurare un'istanza serverless in grado di scalare fino a circa la stessa capacità. Questo perché ogni DCU corrisponde a circa 2 GiB di memoria. Potresti specificare un valore leggermente più alto per consentire all'istanza di scalare ulteriormente nel caso in cui a volte l'`db.r6g.4xlarge`istanza non abbia una capacità sufficiente per gestire il carico di lavoro in modo efficace.
+ Se hai un limite di budget per l'utilizzo del database, scegli un valore che rimanga entro tale limite anche se tutte le istanze serverless funzionano sempre alla massima capacità. Ricorda che quando nel cluster sono presenti n istanze serverless, la capacità teorica massima che il cluster può consumare in qualsiasi momento è n volte la massima impostazione DCU per il cluster. La quantità effettiva consumata potrebbe essere inferiore, ad esempio se alcune istanze di lettura vengono dimensionate in modo indipendente rispetto all'istanza di scrittura.
+ Se utilizzi istanze serverless reader per scaricare parte del carico di lavoro di sola lettura dall'istanza writer, potresti scegliere un'impostazione di capacità massima inferiore. Lo fai per tenere conto del fatto che non è necessario scalare ogni istanza di lettura come se il cluster contenesse una sola istanza.
+ Supponiamo di voler evitare un uso eccessivo a causa di parametri del database configurati in modo errato o di query inefficienti nell'applicazione. In tal caso, è possibile evitare un uso eccessivo accidentale scegliendo un'impostazione di capacità massima inferiore a quella più alta possibile.
+ Se i picchi dovuti alla reale attività degli utenti sono rari ma si verificano, è possibile tenerne conto quando si sceglie l'impostazione della capacità massima. Se è prioritario che l'applicazione continui a funzionare con prestazioni e scalabilità complete, è possibile specificare un'impostazione di capacità massima superiore a quella osservata durante il normale utilizzo. Se l'applicazione può essere eseguita con una capacità di throughput effettiva ridotta durante picchi di attività molto estremi, è possibile scegliere un'impostazione di capacità massima leggermente inferiore. Assicurati di scegliere un'impostazione che disponga ancora di memoria e risorse CPU sufficienti per mantenere l'applicazione in esecuzione.
+ Se nel cluster attivate impostazioni che aumentano l'utilizzo della memoria per ogni istanza, tenete conto di tale memoria quando decidete il valore DCU massimo. Tali impostazioni includono quelle per Performance Insights e cluster globali. Assicurati che il valore DCU massimo consenta alle istanze serverless di scalare abbastanza da gestire il carico di lavoro quando vengono utilizzate tali funzionalità. Per informazioni sulla risoluzione dei problemi causati dalla combinazione di un'impostazione DCU massima bassa e delle funzionalità di Amazon DocumentDB che impongono un sovraccarico di memoria, [Evitare gli errori out-of-memory](#docdb-serverless-scaling-mem-errors) vedi (sotto).
+ In particolare, consigliamo di utilizzare le seguenti caratteristiche `MaxCapacity` minime con le funzionalità specificate (queste raccomandazioni sono soggette a modifiche):
+ Creazione di istanze serverless su un cluster con un grande volume di dati — 2 DCUs (inclusa la creazione di istanze serverless come parte di un ripristino del cluster).
+ Alcuni limiti di istanza sono determinati dalla capacità corrente dell'istanza, ad esempio il limite delle connessioni, il limite del cursore e il limite delle transazioni aperte. Quando scegli il `MaxCapacity` valore per il tuo carico di lavoro, assicurati di tenere a mente questi limiti di istanza per evitare di essere ostacolato da uno di questi limiti. Per ulteriori informazioni, consulta [Limiti delle istanze serverless di Amazon DocumentDB](docdb-serverless-instance-limits.md).
Per istruzioni su come modificare la configurazione di scalabilità di un cluster, consulta. [Gestione senza server di Amazon DocumentDB](docdb-serverless-managing.md)
## Evitare gli errori out-of-memory
**Se una delle tue istanze serverless di DocumentDB raggiunge costantemente il limite della sua capacità massima, Amazon DocumentDB indica questa condizione impostando l'istanza su uno stato di parametri incompatibili.** **Sebbene l'istanza abbia lo stato di parametri incompatibili, alcune operazioni sono bloccate.** Ad esempio, non è possibile aggiornare la versione del motore. Per ulteriori informazioni sullo stato di un'istanza Amazon DocumentDB, consulta [Monitoraggio dello stato di un'istanza Amazon DocumentDB](https://docs.aws.amazon.com//documentdb/latest/developerguide/monitoring_docdb-instance_status.html).
In genere, l'istanza assume questo stato quando si riavvia frequentemente a causa di errori. out-of-memory Amazon DocumentDB registra un evento quando si verifica questo tipo di riavvio. Per visualizzare gli eventi relativi alle risorse, consulta[Visualizzazione degli eventi di Amazon DocumentDB](managing-events.md#viewing-events). Un utilizzo della memoria insolitamente elevato può verificarsi a causa del sovraccarico dovuto all'attivazione di impostazioni come Performance Insights. Può anche derivare da un carico di lavoro intenso sull'istanza o dalla gestione dei metadati associati a un gran numero di oggetti dello schema.
Se la pressione della memoria diminuisce in modo che l'istanza non raggiunga molto spesso la sua capacità massima, Amazon DocumentDB modifica automaticamente lo stato dell'istanza rendendolo disponibile.
Per gestire in modo ottimale questa situazione, è possibile eseguire alcune o tutte le seguenti azioni:
+ Aumenta il limite inferiore di capacità per le istanze serverless modificando il valore minimo dell'unità di capacità DocumentDB (DCU) per il cluster. In questo modo si evitano i problemi in cui un database inattivo viene ridotto a una capacità di memoria inferiore a quella necessaria per le funzionalità attivate nel cluster. Dopo aver modificato le impostazioni DCU per il cluster, riavvia l'istanza serverless. In questo modo si valuta se Amazon DocumentDB è in grado di ripristinare lo stato rendendolo disponibile.
+ Aumenta il limite massimo di capacità per le istanze serverless modificando il valore DCU massimo per il cluster. Ciò consente di evitare problemi nel caso in cui un database occupato non sia in grado di eseguire il dimensionamento verso l'alto fino a una capacità con memoria sufficiente per le funzionalità attivate nel cluster e nel carico di lavoro del database. Dopo aver modificato le impostazioni DCU per il cluster, riavvia l'istanza serverless. In questo modo si valuta se Amazon DocumentDB è in grado di ripristinare lo stato rendendolo disponibile.
+ Disattivare le impostazioni di configurazione che richiedono un sovraccarico di memoria. Ad esempio, supponiamo di avere una funzionalità come Performance Insights attivata ma non la utilizzi. In tal caso, puoi disattivarla. In alternativa, puoi regolare i valori di capacità minima e massima per il cluster a un livello superiore per tenere conto della memoria utilizzata da questi tipi di funzionalità. Per le linee guida sulla scelta delle impostazioni di capacità minima e massima, consulta [Scelta dell'intervallo di capacità di scalabilità per un cluster serverless DocumentDB](#docdb-serverless-scaling-capacity-choosing).
+ Riduci il carico di lavoro sull'istanza. Ad esempio, puoi aggiungere istanze di lettura al cluster per distribuire il carico derivante dalle query di sola lettura su più istanze.
## Perché la mia istanza serverless non si sta ridimensionando?
In alcuni casi, DocumentDB serverless non si riduce alla capacità minima, anche senza carico sul database. Questo può accadere per i seguenti motivi:
+ Performance Insights può aumentare l'utilizzo delle risorse e impedire la scalabilità del database fino alla capacità minima. Le caratteristiche principali comprendono:
+ Se un'istanza reader non è scalabile al minimo e mantiene una capacità uguale o superiore a quella dell'istanza writer, controlla il livello di priorità dell'istanza reader. Le istanze di lettura serverless di DocumentDB di livello 0 o 1 vengono mantenute a una capacità minima almeno pari a quella dell'istanza writer. Imposta il livello di priorità dell'istanza di lettura almeno su 2 in modo che possa essere aumentata o ridotta indipendentemente dall'istanza di scrittura. Per ulteriori informazioni, consulta [Scalabilità senza server di Amazon DocumentDB](docdb-serverless-how-it-works.md#docdb-serverless-scaling).
+ I carichi di lavoro di database gravosi possono aumentare l'utilizzo delle risorse.
+ I volumi di database di grandi dimensioni possono aumentare l'utilizzo delle risorse. Amazon DocumentDB utilizza risorse di memoria e CPU per la gestione dei cluster. Amazon DocumentDB richiede più CPU e memoria per gestire cluster con volumi di database più grandi. Se la capacità minima del cluster è inferiore a quella minima richiesta per la gestione dei cluster, il cluster non verrà ridotto fino alla capacità minima.
+ L'attività di manutenzione in background può aumentare periodicamente l'utilizzo delle risorse.
Se il database non riesce ancora a ridurre fino la capacità minima configurata, interrompi e riavvia il database per recuperare eventuali frammenti di memoria che potrebbero essersi accumulati nel tempo. L'arresto e l'avvio di un database comportano tempi di inattività, quindi consigliamo di farlo raramente.
# Monitoraggio di Amazon DocumentDB senza server
Per ulteriori informazioni sul monitoraggio in Amazon DocumentDB, consulta. [Monitoraggio di Amazon DocumentDB](monitoring_docdb.md)
**Topics**
+ [Memoria insufficiente: stato dei parametri incompatibili](#w2aac41c27b7)
+ [CloudWatch Parametri Amazon per DocumentDB senza server](#w2aac41c27b9)
+ [Monitoraggio delle prestazioni senza server di DocumentDB con Performance Insights](#w2aac41c27c11)
## Memoria insufficiente: stato dei parametri incompatibili
Se una delle tue istanze serverless raggiunge costantemente il limite della sua capacità massima, Amazon DocumentDB indica questa condizione impostando l'istanza su uno stato di parametri incompatibili. Per ulteriori informazioni, consulta [Evitare gli errori out-of-memory](docdb-serverless-scaling-config.md#docdb-serverless-scaling-mem-errors).
## CloudWatch Parametri Amazon per DocumentDB senza server
Per ulteriori informazioni sull'utilizzo CloudWatch con Amazon DocumentDB, consulta. [Monitoraggio di Amazon DocumentDB con CloudWatch](cloud_watch.md)
Puoi visualizzare le tue istanze serverless in CloudWatch per monitorare la capacità consumata da ciascuna istanza con la metrica. `ServerlessDatabaseCapacity` È inoltre possibile monitorare tutte le CloudWatch metriche standard di DocumentDB, ad esempio Queries. `DatabaseConnections` Per l'elenco completo dei CloudWatch parametri che puoi monitorare per Amazon DocumentDB, consulta. [Monitoraggio di Amazon DocumentDB con CloudWatch](cloud_watch.md) Le seguenti metriche a CloudWatch livello di istanza sono importanti da monitorare per consentirvi di comprendere in che modo le istanze serverless di DocumentDB si stanno scalando verso l'alto e verso il basso. Tutti questi parametri vengono calcolati ogni secondo. In questo modo, puoi monitorare lo stato attuale delle tue istanze serverless. Puoi impostare allarmi per avvisarti se un'istanza serverless si avvicina a una soglia per le metriche relative alla capacità. È possibile determinare se le impostazioni di capacità minima e massima sono appropriate o se è necessario adeguarle. È possibile individuare le aree da valutare con maggiore attenzione per ottimizzare l'efficienza del database.
+ **`ServerlessDatabaseCapacity`**— Come metrica a livello di istanza, riporta il numero di valori rappresentati dalla capacità corrente dell'istanza. DCUs Come metrica a livello di cluster, rappresenta la media dei `ServerlessDatabaseCapacity` valori di tutte le istanze serverless di DocumentDB nel cluster.
+ **`DCUUtilization.`**— Questa metrica è nuova in DocumentDB serverless. Questo valore è rappresentato come percentuale. Viene calcolata come il valore della `ServerlessDatabaseCapacity` metrica diviso per il valore DCU massimo del cluster. Considera le seguenti linee guida per l'interpretazione di questo parametro e per valutare quale azione eseguire:
+ Se questa metrica si avvicina a un valore di`100.0`, l'istanza è aumentata il più possibile. Valuta la possibilità di aumentare l'impostazione DCU massima per il cluster. In questo modo, sia le istanze Writer che Reader possono scalare fino a raggiungere una capacità superiore.
+ Supponiamo che un carico di lavoro di sola lettura faccia sì che un'istanza reader si avvicini a una `DCUUtilization` di`100.0`, mentre l'istanza writer non sia vicina alla sua capacità massima. In questo caso, prendete in considerazione l'aggiunta di ulteriori istanze di lettura al cluster. In questo modo, puoi distribuire la parte di sola lettura del carico di lavoro su più istanze, riducendo il carico su ciascuna istanza del lettore.
+ Supponiamo di eseguire un'applicazione di produzione, in cui prestazioni e scalabilità sono fattori di primaria importanza. In questo caso, è possibile impostare il valore DCU massimo per il cluster su un numero elevato. Il tuo obiettivo è che la `DCUUtilization` metrica sia sempre inferiore a 100,0. Con un valore DCU massimo elevato, puoi essere certo che c'è spazio sufficiente in caso di picchi imprevisti nell'attività del database. Dovrai sostenere solo i costi relativi al consumo effettivo di capacità del database.
+ **`CPUUtilization`**— Questa metrica viene interpretata in modo diverso in DocumentDB serverless rispetto alle istanze con provisioning. Per DocumentDB serverless, questo valore è una percentuale calcolata come la quantità di CPU attualmente utilizzata, divisa per la capacità della CPU disponibile in base al valore DCU massimo del cluster. Amazon DocumentDB monitora automaticamente questo valore e aumenta la scalabilità dell'istanza serverless quando l'istanza utilizza costantemente una percentuale elevata della sua capacità di CPU.
Se questa metrica si avvicina a un valore di`100.0`, l'istanza ha raggiunto la capacità massima della CPU. Valuta la possibilità di aumentare l'impostazione DCU massima per il cluster. Se questa metrica si avvicina a un valore pari a 1 `100.0` su un'istanza Reader, valuta la possibilità di aggiungere altre istanze Reader al cluster. In questo modo, puoi distribuire la parte di sola lettura del carico di lavoro distribuita su più istanze, riducendo il carico su ciascuna istanza del lettore.
+ **`FreeableMemory`**— Questo valore rappresenta la quantità di memoria inutilizzata disponibile quando l'istanza serverless di DocumentDB viene scalata alla capacità massima. Per ogni unità DCU la cui capacità attuale è inferiore alla capacità massima, questo valore aumenta di circa 2 GiB. Pertanto, questa metrica non si avvicina allo zero finché l'istanza non viene scalata il più possibile.
Se questa metrica si avvicina al valore zero, l'istanza si è ingrandita il più possibile e si avvicina al limite della memoria disponibile. Valuta la possibilità di aumentare l'impostazione DCU massima per il cluster. Se questa metrica si avvicina al valore zero su un'istanza Reader, valuta la possibilità di aggiungere altre istanze Reader al cluster. In questo modo, la parte di sola lettura del carico di lavoro può essere distribuita su più istanze, riducendo l'utilizzo della memoria su ciascuna istanza del lettore.
+ **`TempStorageIops`**— Il numero di IOPS eseguiti sullo storage locale collegato all'istanza. Include gli IOPS per le operazioni sia di letture che di scrittura. Questo parametro rappresenta un conteggio e viene misurato una volta al secondo. Questa è una nuova metrica per DocumentDB serverless. Per informazioni dettagliate, vedi [Monitoraggio di Amazon DocumentDB con CloudWatch](cloud_watch.md).
+ **`TempStorageThroughput`**— La quantità di dati trasferiti da e verso l'archiviazione locale associata all'istanza. Questo parametro rappresenta i byte e viene misurato una volta al secondo. Questa è una nuova metrica per DocumentDB serverless. Per informazioni dettagliate, vedi [Monitoraggio di Amazon DocumentDB con CloudWatch](cloud_watch.md).
In genere, la maggior parte del ridimensionamento per le istanze serverless di DocumentDB è causata dall'utilizzo della memoria e dall'attività della CPU. Le `TempStorageThroughput` metriche `TempStorageIops` e possono aiutarvi a diagnosticare i rari casi in cui l'attività di rete per i trasferimenti tra l'istanza e i dispositivi di archiviazione locali è responsabile di aumenti imprevisti della capacità. Per monitorare altre attività di rete, puoi utilizzare i seguenti parametri:
+ `NetworkReceiveThroughput`
+ `NetworkThroughput`
+ `NetworkTransmitThroughput`
+ `StorageNetworkReceiveThroughput`
+ `StorageNetworkThroughput`
+ `StorageNetworkTransmitThroughput`
### In che modo le CloudWatch metriche serverless di DocumentDB si applicano alla fattura AWS
Gli addebiti serverless di DocumentDB sulla AWS fattura vengono calcolati in base alla stessa `ServerlessDatabaseCapacity` metrica che puoi monitorare. Il meccanismo di fatturazione può differire dalla CloudWatch media calcolata per questa metrica nei casi in cui si utilizza la capacità serverless di DocumentDB solo per una parte dell'ora. Può anche differire se i problemi di sistema rendono la CloudWatch metrica non disponibile per brevi periodi. Pertanto, potresti vedere un valore delle ore DCU-ore sulla bolletta leggermente diverso rispetto a quando calcoli tu stesso il numero partendo dal valore medio. `ServerlessDatabaseCapacity`
### Esempi di comandi Amazon CloudWatch CLI per i parametri serverless di DocumentDB
AWS CLI Gli esempi seguenti mostrano come monitorare le CloudWatch metriche più importanti relative a DocumentDB serverless. In ogni caso, `Value=` sostituite la stringa per il `--dimensions` parametro con l'identificatore della vostra istanza serverless DocumentDB.
Il seguente esempio di Linux mostra i valori di capacità minima, massima e media per un'istanza, misurati ogni 10 minuti nell'arco di un'ora. I comandi Linux date specificano l'ora di inizio e di fine rispetto alla data e all'ora correnti. La funzione `sort_by` nel parametro `--query` ordina i risultati cronologicamente in base al campo `Timestamp`.
```
aws cloudwatch get-metric-statistics \
--metric-name "ServerlessDatabaseCapacity" \
--start-time "$(date -d '1 hour ago')" \
--end-time "$(date -d 'now')" \
--period 600 \
--namespace "AWS/DocDB" \
--statistics Minimum Maximum Average \
--dimensions Name=DBInstanceIdentifier,Value=my_instance \
--query 'sort_by(Datapoints[*].{min:Minimum,max:Maximum,avg:Average,ts:Timestamp},&ts)' \
--output table
```
Il seguente esempio di Linux dimostra il monitoraggio della capacità di un'istanza in un cluster. Misura l'utilizzo minimo, massimo e medio della capacità di un'istanza. Le misurazioni vengono effettuate una volta ogni ora per un periodo di tre ore. Questi esempi utilizzano la `DCUUtilization` metrica che rappresenta una percentuale del limite superiore di DCUs, anziché `ServerlessDatabaseCapacity` rappresentare un numero fisso di. DCUs In questo modo, non è necessario conoscere i numeri effettivi dei valori DCU minimo e massimo nell'intervallo di capacità. Puoi visualizzare percentuali che vanno da 0 a 100.
```
aws cloudwatch get-metric-statistics \
--metric-name "DCUUtilization" \
--start-time "$(date -d '3 hours ago')" \
--end-time "$(date -d 'now')" \
--period 3600 \
--namespace "AWS/DocDB" \
--statistics Minimum Maximum Average \
--dimensions Name=DBInstanceIdentifier,Value=my_instance \
--query 'sort_by(Datapoints[*].{min:Minimum,max:Maximum,avg:Average,ts:Timestamp},&ts)' \
--output table
```
Il seguente esempio Linux esegue misurazioni simili a quelle precedenti. In questo caso, le misure fanno riferimento al parametro `CPUUtilization`. Le misurazioni vengono effettuate ogni 10 minuti per un periodo di 1 ora. I numeri rappresentano la percentuale di CPU disponibile utilizzata, in base alle risorse della CPU disponibili per l'impostazione della capacità massima per l'istanza.
```
aws cloudwatch get-metric-statistics \
--metric-name "CPUUtilization" \
--start-time "$(date -d '1 hour ago')" \
--end-time "$(date -d 'now')" \
--period 600 \
--namespace "AWS/DocDB" \
--statistics Minimum Maximum Average \
--dimensions Name=DBInstanceIdentifier,Value=my_instance \
--query 'sort_by(Datapoints[*].{min:Minimum,max:Maximum,avg:Average,ts:Timestamp},&ts)' \
--output table
```
Il seguente esempio Linux esegue misurazioni simili a quelle precedenti. In questo caso, le misure fanno riferimento al parametro `FreeableMemory`. Le misurazioni vengono effettuate ogni 10 minuti per un periodo di 1 ora.
```
aws cloudwatch get-metric-statistics \
--metric-name "FreeableMemory" \
--start-time "$(date -d '1 hour ago')" \
--end-time "$(date -d 'now')" \
--period 600 \
--namespace "AWS/DocDB" \
--statistics Minimum Maximum Average \
--dimensions Name=DBInstanceIdentifier,Value=my_instance \
--query 'sort_by(Datapoints[*].{min:Minimum,max:Maximum,avg:Average,ts:Timestamp},&ts)' \
--output table
```
## Monitoraggio delle prestazioni senza server di DocumentDB con Performance Insights
È possibile utilizzare Performance Insights per monitorare le prestazioni delle istanze serverless di DocumentDB. Per le procedure di Approfondimenti sulle prestazioni, consulta [Monitoraggio con Performance Insights](performance-insights.md).
I seguenti nuovi contatori Performance Insights si applicano alle istanze serverless di DocumentDB:
+ **`os.general.serverlessDBCapacity`**— La capacità attuale dell'istanza in. DCUs Il valore corrisponde alla `ServerlessDatabaseCapacity` CloudWatch metrica dell'istanza.
+ **`os.general.dcuUtilization`**— La percentuale di capacità attuale rispetto alla capacità massima configurata. Il valore corrisponde alla `DCUUtilization` CloudWatch metrica dell'istanza.
+ **`os.general.maxConfiguredDcu`**— La capacità massima configurata per questa istanza serverless di DocumentDB. Viene misurata in. DCUs
+ **`os.general.minConfiguredDcu`**— La capacità minima configurata per questa istanza serverless di DocumentDB. Viene misurata in. DCUs
Per l'elenco completo dei contatori di Approfondimenti sulle prestazioni, consulta [Performance Insights per le contrometriche](performance-insights-counter-metrics.md).
Quando i valori vCPU vengono visualizzati per un'istanza serverless DocumentDB in Performance Insights, tali valori rappresentano stime basate sul valore DCU per l'istanza. Per intervalli di default di un minuto, tutti i valori vCPU frazionari vengono arrotondati al numero intero più vicino. Per intervalli più lunghi, il valore vCPU visualizzato è la media dei valori vCPU interi per ogni minuto.