View a markdown version of this page

OpenSearch Dashboard di risoluzione dei problemi - OpenSearch Servizio Amazon

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

OpenSearch Dashboard di risoluzione dei problemi

Questa sezione descrive i problemi noti che possono causare l'indisponibilità, il mancato caricamento o il comportamento imprevisto dei OpenSearch dashboard. Ogni problema include le azioni che puoi intraprendere per risolverlo autonomamente. Dashboards viene eseguito sugli hot data node del dominio e ne archivia lo stato (modelli di indice, visualizzazioni e dashboard) nell'indice Dashboards. OpenSearch Di conseguenza, la maggior parte dei problemi di disponibilità di Dashboard è riconducibile allo stato del cluster, allo storage, alla migrazione dell'indice di OpenSearch Dashboards, a un'impostazione del cluster o delle dashboard, ai limiti delle risorse o alla versione del software di servizio del dominio.

Ogni problema è organizzato per Sintomo (cosa vedi e come confermarlo), Causa principale, Modalità di mitigazione (procedure self-service) e Azione consigliata (come evitare che si ripresenti).

Nota

Molti problemi noti relativi a Dashboards sono già stati risolti in una versione più recente del software di servizio. Prima di risolvere ulteriormente i problemi, apri la console di Amazon OpenSearch Service (la AWS console del servizio, non l'interfaccia utente di OpenSearch Dashboards), controlla il pannello Notifiche e installa l'ultimo aggiornamento del software di servizio disponibile. Diverse sezioni seguenti elencano questa azione come azione consigliata. Se è già in corso una modifica o un aggiornamento della configurazione, attendi che finisca prima di installare un aggiornamento.

Il pannello di controllo è bloccato su «il server non è ancora pronto» (errore HTTP 503 non pronto)

Caratteristiche

I dashboard vengono visualizzati OpenSearch Dashboards server is not ready yet (un errore HTTP 503 non pronto) e il caricamento non viene completato. Dashboards mostra questa pagina ogni volta che l'avvio non è terminato. Una versione breve è normale durante il riavvio, l'aggiornamento o la blue/green distribuzione e si cancella da sola. Trattala come un problema quando persiste. Per restringere la causa, controlla lo stato del cluster del dominio e se è in corso una modifica o un aggiornamento della configurazione:

  • Se è in corso una modifica o un aggiornamento, il messaggio è in genere temporaneo; attendi che il dominio ritorni ad Active.

  • Se lo stato del cluster è rosso, le dashboard non possono avviarsi perché dipendono dal cluster; risolvi prima il problema del cluster (vedi). Problemi correlati ai cluster e agli accessi

  • Se il messaggio persiste mentre lo stato del cluster è verde, è molto probabile che la migrazione dell'indice di OpenSearch Dashboards sia bloccata (descritta di seguito).

Causa principale

Dashboards riporta che «il server non è ancora pronto» fino al completamento dell'inizializzazione di tutti i suoi servizi principali, motivo per cui è prevista una versione temporanea del messaggio durante l'avvio e le distribuzioni. blue/green Quando persiste con un cluster verde, la causa più comune è che la migrazione dell'indice OpenSearch Dashboards è bloccata: all'avvio, Dashboards migra gli oggetti salvati in un nuovo indice dietro un alias e, se la migrazione non può essere completata, Dashboards non diventa mai pronta. Trigger comuni per una migrazione bloccata:

  • Dopo un aggiornamento, può verificarsi una migrazione bloccata per i seguenti motivi:

    • Un indice di OpenSearch Dashboards rimasto da una versione precedente impedisce la creazione del nuovo alias.

    • Un aggiornamento da una versione precedente del motore i cui Dashboard non utilizzavano un alias è in conflitto con un indice esistente.

    • I documenti scritti da un'istanza di Dashboards più recente (autogestita) non possono essere migrati automaticamente alla versione di destinazione.

  • Senza un aggiornamento, può verificarsi una migrazione bloccata per i seguenti motivi:

    • Un indice OpenSearch Dashboards danneggiato creato da una richiesta di interfaccia utente o da un ripristino blocca l'alias.

    • Due o più indici di OpenSearch Dashboard con versioni puntano allo stesso alias. Questo può apparire anche come un Internal Server Error (HTTP 500) anche quando lo stato del cluster è verde.

    • Per-user o gli indici per-tenant sono stati creati senza un alias su domini che utilizzano il controllo granulare degli accessi o l'autenticazione Amazon Cognito.

    • Una modifica alla mappatura degli oggetti salvati non può essere applicata a causa di un documento danneggiato.

Come mitigare
  1. Se è in corso una modifica alla configurazione o un aggiornamento della versione, attendi che il dominio ritorni ad Active. Il messaggio è spesso transitorio e si cancella da solo. Una normale modifica o aggiornamento viene completata entro poche ore. Se Dashboards non è ancora disponibile più di 4 ore dopo che il dominio torna ad essere attivo, consideralo un problema persistente. Continua con i seguenti passaggi. (Non puoi avviare un aggiornamento del software di servizio mentre il dominio sta ancora elaborando una modifica.)

  2. Se lo stato del cluster è rosso o giallo, risolvi prima il problema del cluster (vediProblemi correlati ai cluster e agli accessi). I dashboard non possono essere avviati su un cluster non integro.

  3. Se il messaggio persiste mentre lo stato del cluster è verde, raccogli alcuni dati di diagnostica di sola lettura per aiutare AWS Support a risolvere il problema più rapidamente, quindi contatta l'AWS assistenza per ripristinare l'indice dei dashboard. OpenSearch Includi l'output dei seguenti comandi nel tuo caso:

    GET _cat/aliases/.kibana*?v GET _cat/indices/.kibana*?v

    La riparazione della migrazione bloccata è la soluzione per un dominio già bloccato. L'installazione di un aggiornamento software non sblocca di per sé un dominio già bloccato. Non cancellate voi stessi l'indice delle OpenSearch dashboard. La sua eliminazione rimuove definitivamente tutte le visualizzazioni, i dashboard e gli schemi di indice salvati di cui non è stato eseguito il backup in un'istantanea. Se una riparazione richiede l'eliminazione di un indice che contiene dati, AWS Support richiede prima la tua autorizzazione. Per un dominio di produzione che non è disponibile da più di un'ora e non è in corso alcuna modifica della configurazione, apri la tua richiesta Support se la gravità del sistema di produzione è compromessa o superiore.

  4. Per evitare che si ripetano, mantieni il dominio aggiornato sull'ultimo aggiornamento del software di servizio; le versioni attuali risolvono le cause più comuni degli errori di migrazione. Installa l'aggiornamento dopo che il dominio è tornato ad Active.

  5. Scatta un'istantanea manuale prima di ogni aggiornamento di versione in modo da poter ripristinare gli oggetti salvati se una migrazione fallisce. Per ulteriori informazioni sull'acquisizione di istantanee, consulta. Creazione di istantanee dell'indice in Amazon Service OpenSearch

Azione suggerita

Mantieni il dominio sulla versione corrente del software di servizio e scatta un'istantanea prima di ogni aggiornamento. Se ti affidi alle dashboard per il monitoraggio della produzione, prendi in considerazione quella centralizzataUtilizzo OpenSearch dell'interfaccia utente in Amazon OpenSearch Service, che non è legata alla migrazione degli indici delle dashboard per dominio di un singolo dominio. OpenSearch

Le dashboard non vengono caricate con un messaggio allow_explicit_index

Caratteristiche

I pannelli di controllo non vengono caricati e visualizza un messaggio simile al seguente:

Kibana must be able to specify the index within Elasticsearch multi-requests (rest.action.multi.allow_explicit_index=true).
Causa principale

L'opzione cluster rest.action.multi.allow_explicit_index avanzata è impostata su. false Imposta questa opzione true in modo che Dashboards possa eseguire le operazioni bulk, mget e msearch.

Come mitigare

rest.action.multi.allow_explicit_indexTorna a true nelle opzioni avanzate del dominio. Si tratta di una modifica al piano di gestione che puoi apportare con AWS le tue credenziali, nella console (apri il dominio, scegli Modifica e aggiorna le impostazioni avanzate del cluster) o tramite l'interfaccia a riga di AWS comando (CLI):AWS

aws opensearch update-domain-config \ --domain-name my-domain \ --advanced-options rest.action.multi.allow_explicit_index=true

La modifica di un'opzione avanzata attiva una blue/green distribuzione, pertanto la modifica richiede alcuni minuti per essere applicata. Per ulteriori informazioni sulle impostazioni avanzate del cluster, vedereImpostazioni avanzate del cluster.

Azione suggerita

Esegui questa impostazione rest.action.multi.allow_explicit_index a false meno che tu non intenda limitare l'accesso all'indice tramite politiche basate sulle risorse. Se si lascia l'impostazione predefinita (true), le dashboard restano operative.

La memoria di Dashboards sta esaurendo

Caratteristiche

Le dashboard si riavviano, si bloccano o non rispondono sotto carico, soprattutto quando si aprono dashboard di grandi dimensioni o si caricano molti oggetti salvati.

Causa principale

Il processo Dashboards ha esaurito la memoria disponibile, spesso a causa del caricamento di troppi oggetti salvati o del rendering di dashboard pesanti.

Come mitigare
  1. Installa l'aggiornamento più recente del software di servizio. Le versioni correnti ridimensionano l'heap dei dashboard in modo dinamico e rimuovono il precedente limite di dimensione fissa.

  2. Se l'hai aumentato savedObjects:listingLimit (impostazione predefinita1000) nelle Impostazioni avanzate, riducilo. Valori elevati, ad esempio10000, hanno causato errori di esaurimento della memoria.

  3. Riduci la complessità della dashboard, il numero di pannelli e la frequenza di aggiornamento automatico.

  4. Se l'utilizzo della memoria è cronicamente elevato, passa a un tipo di istanza con più memoria. Per ulteriori informazioni sul dimensionamento dei domini, consulta. Dimensionamento dei domini Amazon OpenSearch Service

Azione suggerita

Per capirlo prima che Dashboards esaurisca la memoria, osserva la OpenSearchDashboardsHeapUtilization CloudWatch metrica; se supera costantemente l'80%, passa a un tipo di istanza più grande. Right-size scegli il tipo di istanza per l'utilizzo delle dashboard, mantieni le dashboard snelle ed savedObjects:listingLimit evita di andare oltre ciò di cui hai bisogno.

Le richieste hanno esito negativo a causa delle dimensioni del payload

Caratteristiche

Alcune pagine di dashboard non vengono caricate perché il payload della richiesta supera il limite di payload di Dashboards (server.maxPayloadBytes, che per impostazione predefinita è 1 MB/1.048.576 byte).

Causa principale

I modelli di indice che corrispondono a un numero molto elevato di indici o campi generano richieste superiori al limite di payload.

Come mitigare
  1. Riduci la dimensione della richiesta anziché aumentare il limite:

    • Riduci il numero di indici nei tuoi modelli di indice.

    • Riduci il numero di campi.

    • Riduci la lunghezza dei nomi dei campi.

  2. Contatta l'AWS assistenza per richiedere l'opzione supportata a livello di account che mantiene un server.maxPayloadBytes valore maggiore in modo che sopravviva blue/green alle implementazioni e alle sostituzioni dei nodi. Questa opzione è disponibile su tutte le versioni supportate OpenSearch di Amazon Service.

Nota

Non cercare di aumentare questo limite modificando tu stesso la configurazione delle dashboard sui nodi. Node-level le modifiche non sono persistenti. Qualsiasi blue/green distribuzione o sostituzione di nodi li rimuove. Utilizza invece l'opzione a livello di account tramite AWS Support.

Azione suggerita

Mantieni i modelli di indice limitati agli indici e ai campi che utilizzi effettivamente, in modo che le richieste rientrino nel limite del payload.

I dashboard non sono disponibili durante l'aggiornamento della versione

Caratteristiche

I dashboard non sono disponibili per la maggior parte della durata dell'implementazione di un aggiornamento della versione blue/green del motore. Si tratta di un comportamento previsto, non di un errore, e si risolve automaticamente al termine dell'aggiornamento.

Causa principale

Le dashboard rimangono offline per la maggior parte degli aggiornamenti di versione, per evitare che si verifichino le condizioni di concorrenza tra il vecchio e il nuovo ambiente.

Come mitigare

Attendi il completamento dell'aggiornamento; le dashboard tornano automaticamente disponibili. Considera gli aggiornamenti delle versioni come una finestra di manutenzione pianificata delle dashboard e pianificali al di fuori degli orari aziendali critici. Per ulteriori informazioni sulle modifiche alla configurazione, consulta. Apportare modifiche alla configurazione in Amazon OpenSearch Service

Azione suggerita

Pianifica gli aggiornamenti durante le finestre a traffico ridotto. Se hai bisogno di una disponibilità delle dashboard che non sia legata alla finestra di aggiornamento di un singolo dominio, prendi in considerazione la soluzione centralizzata. Utilizzo OpenSearch dell'interfaccia utente in Amazon OpenSearch Service

L'aggiornamento di una versione del motore non supera il controllo di pre-aggiornamento con un indice incompatibile

Caratteristiche

Si avvia un aggiornamento della versione del motore (o si esegue il controllo di idoneità all'aggiornamento) e il controllo pre-aggiornamento ha esito negativo, prima dell'inizio di qualsiasi aggiornamento. La notifica di convalida elenca uno o più indici incompatibili e può assegnare un nome specifico all'indice Dashboards. OpenSearch Ciò si verifica in genere quando si esegue l'aggiornamento a OpenSearch 3.x mentre il dominio ha ancora indici creati in OpenSearch 1.3, Elasticsearch 7.10 o versioni precedenti, incluso l'indice Dashboards. OpenSearch (Gli aggiornamenti dalla versione OpenSearch 1.3 o 2.x devono passare prima alla versione 2.19 e poi alla 3.x). OpenSearch OpenSearch

Causa principale

OpenSearch può leggere gli indici solo dalla versione principale immediatamente precedente, quindi OpenSearch 3.x non supporta gli indici creati in 1.3, Elasticsearch 7.10 o versioni precedenti. OpenSearch Il controllo di pre-aggiornamento blocca l'aggiornamento ed elenca questi indici appositamente, in modo da non perdere alcun dato. È necessario reindicizzare o rimuovere gli indici precedenti prima di eseguire un aggiornamento della versione principale; il servizio non li reindicizza automaticamente. L'indice OpenSearch Dashboards segue la stessa regola.

Come mitigare
  1. Esegui il controllo di idoneità all'aggiornamento per visualizzare l'elenco completo degli indici incompatibili (lo stesso elenco si trova nella notifica di aggiornamento non riuscito). Per ulteriori informazioni sull'aggiornamento dei domini, consulta. Aggiornamento dei domini Amazon Service OpenSearch

  2. Scatta un'istantanea manuale prima di apportare modifiche. Per ulteriori informazioni sull'acquisizione di istantanee, vedere. Creazione di istantanee dell'indice in Amazon Service OpenSearch

  3. Per ogni indice di dati incompatibile, reindicizzalo in un nuovo indice (creato nella versione corrente), quindi elimina quello precedente. Per gli UltraWarm indici freddi, spostali prima nella memorizzazione a caldo, reindicizzali e poi spostali indietro.

    POST _reindex { "source": { "index": "my-old-index" }, "dest": { "index": "my-new-index" } }
  4. Per quanto riguarda l'indice OpenSearch Dashboards, esegui prima il backup perché contiene i modelli di indice, le visualizzazioni e i dashboard: in Dashboard, vai a Gestione dashboard, Oggetti salvati ed esportali. Quindi elimina l'indice incompatibile. Un nuovo indice compatibile viene creato automaticamente dopo l'aggiornamento; in seguito reimporta gli oggetti salvati. Se preferisci non eliminarlo, contatta l'AWS assistenza.

  5. Elimina qualsiasi indice incompatibile che non ti serve più invece di reindicizzarlo.

  6. Re-run il controllo di idoneità e riattiva l'aggiornamento una volta superato.

Azione suggerita

Reindicizza o ritira i vecchi indici in modo che non coprano più di una versione principale; gli indici rimasti in diversi aggiornamenti finiranno per bloccarne uno. Scatta un'istantanea manuale prima di ogni aggiornamento ed esporta periodicamente gli oggetti salvati nella dashboard come backup. OpenSearch

Le dashboard non si caricano correttamente, mostrano una pagina vuota o generano report vuoti

Caratteristiche

Un singolo utente o browser visualizza una pagina vuota, report vuoti o un banner rosso con la scrittaOpenSearch Dashboards did not load properly. Check the server output for more information., mentre gli altri utenti non ne risentono. Conferma riproducendolo in una finestra privata (in incognito) o in un altro browser.

Causa principale

Una cache del browser obsoleta causa questo problema, soprattutto dopo un aggiornamento del software di servizio o quando si utilizza la funzionalità di segnalazione.

Come mitigare
  1. Svuota la cache e i cookie del browser, quindi ricarica la pagina. Prova una finestra privata (in incognito) e un browser supportato e aggiornato.

  2. Disattiva gli ad blocker o le estensioni del browser per l'URL delle dashboard.

  3. Se il banner persiste per tutti gli utenti (non solo per un browser), installa l'ultimo aggiornamento del software di servizio, quindi contatta l'AWS assistenza se il problema persiste.

Azione suggerita

Svuota la cache del browser dopo un aggiornamento del software di servizio e utilizza un browser supportato e aggiornato.

Configurazioni non supportate

Evita queste configurazioni, che sono fonti comuni di problemi con le dashboard:

  • I proxy inversi (ad esempio nginx) davanti ai dashboard sono supportati solo per il controllo degli accessi, come descritto in. Utilizzo di un proxy per accedere a OpenSearch Service from Dashboards Se esegui Dashboard tramite un software proxy di terze parti e riscontri un errore imprevisto, riproduci il problema senza il proxy prima di contattare l'assistenza AWS .

  • Le modifiche manuali ai file di configurazione dei nodi non sono persistenti. Qualsiasi blue/green implementazione o sostituzione di nodi li ripristina. Utilizza le impostazioni e le opzioni supportate anziché le modifiche a livello di nodo. Non puoi usare SSH per accedere ai nodi o modificare direttamente i file di configurazione.

Poiché i dashboard dipendono da un cluster integro e dalla configurazione di accesso del dominio, i seguenti argomenti di risoluzione dei problemi si applicano spesso quando i dashboard non sono disponibili. Per tutti questi argomenti, consulta. Risoluzione dei problemi con Amazon OpenSearch Service

  • Impossibile accedere alle OpenSearch dashboard: policy di accesso e autenticazione di Amazon Cognito, inclusi User: anonymous is not authorized to perform: es:ESHttpGet i timeout di errore VPC-access e richiesta.

  • Stato rosso del cluster e stato giallo del cluster: gli shard non assegnati impediscono alle dashboard di leggere o scrivere l'indice delle dashboard. OpenSearch

  • ClusterBlockException: lo spazio di archiviazione insufficiente o l'elevata pressione della memoria JVM bloccano le scritture, incluse le scritture nell'indice Dashboards. OpenSearch

  • JVM OutOfMemoryError e Request throttling: il sovraccarico del cluster emerge come errori e risposte delle dashboard. 429 Too Many Requests