Come posso risolvere i problemi relativi ad aggiornamenti bloccati o non riusciti nel Servizio OpenSearch?

Breve descrizione

Il Servizio OpenSearch utilizza un processo di implementazione blu/verde per gli aggiornamenti del dominio. Durante questo processo, problemi con il trasferimento degli shard possono causare il blocco del dominio nello stato Modifica in corso. Oppure il dominio potrebbe non superare i controlli di convalida dell'aggiornamento.

Nota: non puoi annullare un aggiornamento dopo averlo avviato. Se l'aggiornamento si blocca, devi attendere che AWS risolva il problema sottostante prima che il processo possa essere completato.

Risoluzione

Il dominio è bloccato nello stato Modifica in corso durante il trasferimento degli shard

Durante l'implementazione blu/verde, il Servizio OpenSearch copia i dati dai nodi esistenti ai nuovi nodi. Se il processo di trasferimento degli shard si blocca, il dominio rimane nello stato Modifica in corso.

L'errore si verifica per i seguenti motivi:

• Le grandi dimensioni degli shard, superiori a 50 GB, aumentano il tempo di copia degli shard.
• Un carico di indicizzazione o ricerca causa un elevato utilizzo delle risorse nel cluster.
• Non è disponibile spazio sufficiente su disco per copiare gli shard nei nuovi nodi.
• Hai raggiunto una quota per quel che riguarda il numero di shard.

Per risolvere questi problemi, utilizza Amazon CloudWatch per visualizzare le metriche FreeStorageSpace, ClusterStatus e ClusterIndexWritesBlocked del Servizio OpenSearch per individuare problemi di spazio su disco o un carico elevato del cluster.

A seconda dei problemi individuati, intraprendi le seguenti azioni:

• Se FreeStorageSpace è basso, elimina gli indici non utilizzati.
• Se ClusterStatus è Rosso o Giallo, consulta Perché il mio cluster Servizio OpenSearch di Amazon è rosso o giallo?
• Se ClusterIndexWritesBlocked è ** True**, elimina gli indici inutilizzati per liberare spazio su disco. Oppure, se la pressione della memoria di Java Virtual Machine (JVM) è elevata, riduci il traffico verso il dominio.

Per ulteriori informazioni sull'eliminazione degli indici, consulta DeleteIndex o Delete Index API (API Delete Index) sul sito web OpenSearch.

Per monitorare il processo di migrazione degli shard, esegui questo comando:

GET _cat/recovery?active_only=true

L'output del comando mostra lo stato di ripristino degli shard attivi, la percentuale di avanzamento, il tempo di ripristino, lo stato di errore e le dimensioni del trasferimento dei dati. Se gli shard non mostrano un avanzamento, o se ricevi un output vuoto, il processo di aggiornamento potrebbe non funzionare correttamente. Per risolvere i problemi di aggiornamento, crea una richiesta di assistenza al Supporto AWS.

Se le dimensioni degli shard superano i 50 GB, reindicizza i dati per creare più shard con dimensioni inferiori. Per istruzioni, consulta Reindex data (Reindicizzazione dei dati) sul sito web OpenSearch.

Se nessuna delle precedenti azioni di risoluzione risolve il problema, crea una richiesta di assistenza al Supporto AWS.

Il dominio non supera i controlli di convalida dell'aggiornamento

Durante un aggiornamento, il Servizio OpenSearch verifica che la configurazione del dominio sia compatibile con la nuova versione. Se la convalida ha esito negativo, il dominio rimane bloccato nello stato Modifica in corso.

Per risolvere il problema, controlla la descrizione del dominio per le attività non riuscite o i messaggi di errore relativi alla convalida. Completa i passaggi per la risoluzione dell'errore, quindi riprova a modificare la configurazione.

Best practice per prevenire problemi di aggiornamento

Intraprendi le seguenti azioni:

• Reindicizza gli shard più grandi per mantenere le dimensioni dei singoli shard al di sotto di 50 GB.
• Utilizza il numero corretto di shard per la configurazione in uso e attieniti alle best practice relative per quanto concerne strategia di sharding.
• Avvia gli aggiornamenti durante i periodi di scarso utilizzo del cluster.
• Prova prima gli aggiornamenti sui domini non di produzione.
• Assicurati che il dominio disponga di CPU, memoria e spazio su disco sufficienti per l'aumento del carico durante un aggiornamento. Monitora l'utilizzo delle risorse prima di avviare gli aggiornamenti.
• Verifica le modifiche alla configurazione prima di applicarle.

Informazioni correlate

Perché il mio dominio del Servizio OpenSearch è bloccato nello stato "Modifica in corso"?