Help us improve the AWS re:Post Knowledge Center by sharing your feedback in a brief survey. Your input can influence how we create and update our content to better support your AWS journey.
Come posso risolvere gli errori di Kibana o OpenSearch Dashboards nel Servizio OpenSearch?
Desidero risolvere gli errori di Kibana o OpenSearch Dashboards che ricevo nel Servizio OpenSearch di Amazon.
Risoluzione
In caso di problemi di infrastruttura o configurazione sottostanti, ricevi uno dei seguenti messaggi di errore:
"OpenSearch Dashboards/Kibana server is not ready yet"
"OpenSearch Dashboards/Kibana did not load properly"
"OpenSearch Dashboards/Kibana did not load properly. Check the server output for more information."
Per risolvere questi problemi e verificare che il server funzioni correttamente, controlla le seguenti impostazioni:
- Assicurati che l'utilizzo della CPU non superi l'80%.
- Assicurati che la metrica relativa pressione della memoria Java Virtual Machine (JVM) non superi il 75%.
- Risolvi gli errori ClusterBlockException e IndexCreateBlockException che ricevi.
- Verifica se lo spazio di archiviazione è insufficiente nel dominio del Servizio OpenSearch.
- Distribuisci uniformemente gli shard tra i nodi.
- Assicurati che gli shard non superino il valore di soglia predefinito di 1.000 in ogni nodo. Per ridurre il numero di shard dei nodi, elimina gli indici non necessari o aggiungi altri nodi al cluster. Per eliminare gli indici, consulta Delete index API (API delete index) sul sito web OpenSearch. Per ulteriori informazioni sulle best practice relative agli shard, consulta Scelta del numero di shard.
- Verifica la presenza di nodi con errori.
- Non utilizzare query in blocco che creano un carico elevato sul cluster. Se devi utilizzare query in blocco per migliorare le prestazioni di indicizzazione, inizia con un blocco di dimensioni ridotte e aumentalo in modo incrementale. Per ulteriori informazioni, consulta Using and sizing bulk requests (Utilizzo e dimensionamento delle richieste in blocco) sul sito web Elastic.
- Verifica che la policy basata sulle risorse del dominio del Servizio OpenSearch consenta agli utenti e ai ruoli AWS Identity and Access Management (AWS IAM) di interagire con il servizio.
Nota: puoi anche utilizzare una policy basata su IP. Non puoi utilizzare una policy basata sull'identità per configurare l'accesso alla dashboard di Kibana o a OpenSearch Dashboards.
Se i problemi persistono, utilizza i seguenti passaggi per risolvere il problema.
Risolvi l'errore "Http request timed out" o i problemi di accesso al VPC
Se il cluster del Servizio OpenSearch si trova in un cloud privato virtuale (VPC), potresti ricevere il messaggio di errore "{"Message":"Http request timed out connecting"}". Questo errore si verifica quando un problema di raggiungibilità della rete blocca la connessione a Kibana o OpenSearch Dashboards.
Per risolverlo, intraprendi le seguenti azioni:
- Assicurati che i gruppi di sicurezza del VPC consentano il traffico in entrata sulla porta 443 dall'indirizzo IP del client.
- Se il client si trova in un VPC diverso da quello del cluster del Servizio OpenSearch, verifica di aver configurato correttamente il client e le sottoreti del Servizio OpenSearch. Ad esempio, controlla gli endpoint VPC, la connessione peering VPC, la VPN o la connessione AWS Direct Connect.
- Assicurati che le tabelle di routing della sottorete contengano i percorsi necessari per accedere al dominio del Servizio OpenSearch.
Per ulteriori informazioni, consulta Avvio dei domini del Servizio OpenSearch di Amazon all'interno di un VPC.
Risolvi l'errore "User: anonymous is not authorized to perform"
Se hai attivato il controllo granulare degli accessi e utilizzi l'autenticazione SAML 2.0, potresti ricevere il seguente messaggio di errore:
"{"Message":"User: anonymous is not authorized to perform: es:ESHttpGet because no resource-based policy allows the es:ESHttpGet action"}"
Per risolverlo, intraprendi le seguenti azioni:
- Verifica che la tua policy basata sulle risorse includa le autorizzazioni necessarie per gli utenti SAML 2.0 autenticati.
- Verifica di aver mappato correttamente i ruoli del backend sugli attributi di SAML 2.0.
Risolvi i problemi di integrazione con SAML 2.0, Amazon Cognito o il Centro identità IAM
Intraprendi le seguenti azioni:
- Verifica di aver configurato correttamente i metadati di SAML 2.0 sia nel gestore dell'identità digitale che nel Servizio OpenSearch.
- Verifica di aver impostato e collegato correttamente il pool di utenti e il pool di identità di Amazon Cognito al dominio del Servizio OpenSearch. Per risolvere gli errori, consulta Problemi di configurazione comuni.
- Assicurati di aver configurato i ruoli e le autorizzazioni IAM richiesti per l'autenticazione Amazon Cognito.
Risolvi i problemi relativi ai proxy personalizzati
Se riscontri problemi quando utilizzi un proxy personalizzato, intraprendi le seguenti azioni:
- Utilizza l'URL dell'endpoint per accedere a Kibana o OpenSearch Dashboards senza il proxy per verificare se l'accesso è bloccato dalla configurazione del proxy.
- Verifica che il proxy inoltri le richieste al dominio del Servizio OpenSearch.
- Assicurati che il proxy mantenga le intestazioni necessarie. Per informazioni sulla configurazione del proxy NGINX, consulta How do I use an NGINX proxy to access Kibana or OpenSearch Dashboards outside of a VPC that doesn’t use Amazon Cognito authentication? (Come posso utilizzare un proxy NGINX per accedere a Kibana o OpenSearch Dashboards al di fuori di un VPC che non utilizza l'autenticazione Amazon Cognito?)
Per un esempio di configurazione proxy, consulta Build SAML identity federation for Amazon OpenSearch Service domains within a VPC (Creazione di una federazione di identità SAML per domini del Servizio OpenSearch all'interno di un VPC).
Per l'autenticazione Amazon Cognito in un VPC, consulta Come posso utilizzare un proxy NGINX per accedere a OpenSearch Dashboards con l'autenticazione di Amazon Cognito dall'esterno di un VPC?
Risolvi i problemi relativi a certificati scaduti
I certificati scaduti negli endpoint dei proxy possono causare problemi di accesso.
Per risolverli, intraprendi le seguenti azioni:
- Controlla le date di scadenza dei certificati che utilizzi nella configurazione del proxy.
- Rinnova i certificati scaduti e aggiornali nella configurazione del proxy.
- Monitora i certificati in modo da ricevere una notifica prima della loro scadenza.
Risolvi l'errore "exceeded the number of permissible concurrent requests" o i problemi derivanti da risorse con limitazione (della larghezza di banda della rete)
Se i nodi ricevono troppe richieste firmate con credenziali IAM diverse, viene generato il seguente errore:
"You have exceeded the number of permissible concurrent requests with unique IAM Identities"
Per risolverlo, intraprendi le seguenti azioni:
- Consolida i ruoli o gli utenti IAM per ridurre la varietà di credenziali utilizzate per le richieste.
- Aggiungi nodi al cluster per aumentare le soglie di limitazione (della larghezza di banda della rete) a livello di nodo.
- Implementa la logica della ripetizione nelle applicazioni client.
- Aumenta gradualmente il volume delle richieste.
- Evita le operazioni in blocco con più credenziali.
Risolvi i problemi di indicizzazione e migrazione durante le implementazioni blu/verdi
Potresti ricevere durante le implementazioni blu/verdi a causa dei seguenti problemi:
- Conflitti tra modelli di indice con caratteri jolly che influiscono sull'indice di Kibana o OpenSearch Dashboards.
- Documenti danneggiati nell'indice di Kibana o OpenSearch Dashboards.
Per risolverli, verifica la presenza di modelli di indice in conflitto eseguendo questo comando:
GET _cat/templates
Esempio di output:
GET _cat/templates?v name index_patterns order version composed_of my-index-template [*] 0 GET _template/my-index-template { "my-index-template": { "order": 0, "index_patterns": [ "*" ], "settings": { <index-settings> }, "mappings": { <index-mappings> }, "aliases": { <index-alias> } } }
Per ulteriori informazioni, consulta CAT templates API (API cat templates) sul sito web OpenSearch.
Non è consigliabile utilizzare "index_patterns": "*" nel modello di indice perché include tutti gli indici. Esegui invece questo comando per modificare il modello di indice in modo da includere solo gli indici con un prefisso specifico:
PUT _template/my-index-template { "index_patterns": ["your-index-prefix-*"], "settings": { index-settings }, "mappings": { index-mappings }, "aliases": { index-alias } }
Nota: sostituisci your-index-prefix-* con un prefisso di indice, index-settings con le impostazioni del tuo indice, index-mappings con le mappature del tuo indice e index-alias con l'alias del tuo indice. Per ulteriori informazioni, consulta Put template (API put template) sul sito web OpenSearch.
Se necessario, elimina l'indice di Kibana o OpenSearch Dashboards. Per ulteriori informazioni, consulta Delete index API (API delete index) sul sito web Elastic. Quindi ripristina l'indice da uno snapshot manuale.
Risolvi i problemi di singoli nodi
Arresti anomali di singoli nodi possono causare la perdita dell'accesso a Kibana o OpenSearch Dashboards.
Per risolverlo, intraprendi le seguenti azioni:
- Controlla le metriche del cluster in Amazon CloudWatch relative ai nodi interessati per individuare quando diventano non integri:
Per Elasticsearch versione 7.10 e precedenti, controlla KibanaHealthyNodes.
Per OpenSearch versione 1.x e successive, controlla OpenSearchDashboardsHealthyNodes. - Aumenta il numero di nodi nel cluster per una migliore ridondanza.
Se hai un solo nodo, completa i seguenti passaggi per ripristinare l'indice .kibana* da snapshot automatici:
- Per elencare gli snapshot automatici disponibili nel repository, esegui questo comando:
Nota: sostituisci repository con **cs-automated ** per un dominio non crittografato e cs-automated-enc per un dominio crittografato.GET /_cat/snapshots/repository - Per visualizzare un elenco degli indici in uno snapshot specifico, esegui questo comando:
Nota: sostituisci repo-name con il nome del tuo repository e snapshot-id con l'ID dello snapshot.GET _snapshot/repo-name/snapshot-id?pretty - Per ripristinare l'indice .kibana*, esegui questo comando:
Nota: sostituisci repo-name con il nome del tuo repository e snapshot-id con l'ID dello snapshot. Se riscontri problemi di autorizzazione quando provi a ripristinare l'indice, invia una richiesta di assistenza al Supporto AWS. Sia Kibana che OpenSearch Dashboards utilizzano l'indice kibana*.POST _snapshot/repo-name/snapshot-id { "indices": ".kibana*" }
Per ulteriori informazioni, consulta Perché il mio nodo del Servizio OpenSearch si è bloccato?
Risolvi l'errore "OpenSearch Security not initialized"
Il messaggio di errore "OpenSearchSecurityException[OpenSearch Security not initialized for __PATH__]" si verifica quando l'inizializzazione della sicurezza non riesce.
Per verificare che il plugin di sicurezza sia stato inizializzato per il dominio, apri l'URL https://kibana-dashboards-url/api/status?pretty nel browser.
Nota: sostituisci kibana-dashboards-url con l'URL della tua dashboard.
Esempio di output:
... Redacted ... { "id": "plugin:securityDashboards@2.15.0", "message": "All dependencies are available", "since": "2025-08-22T11:23:58.243Z", "state": "green", "icon": "success", "uiColor": "secondary" }, ... Redacted ...
Se lo stato non è verde nell'output, riapri l'URL. Se lo stato continua a non essere verde o cambia ogni volta che apri l'URL, il plugin di sicurezza non viene inizializzato correttamente. Per risolvere il problema, invia una richiesta di assistenza al Supporto AWS.
Risolvi gli errori "500"
Se l'utilizzo della CPU è elevato o se è elevata la pressione della memoria JVM, potresti ricevere il seguente messaggio di errore:
"{"statusCode":500,"error":"Internal Server Error","message":"An internal server error occurred."}"
Assicurati che l'utilizzo della CPU e la pressione della memoria JVM non siano troppo elevati. Per approfondire i problemi riscontrati, consulta le ulteriori informazioni sugli errori o sull'eccezione contenute nei log di OpenSearch. Se l'utilizzo della CPU e la pressione della memoria JVM sono bassi ma continui a ricevere l'errore "500", invia una richiesta di assistenza al Supporto AWS.
Risolvi i problemi relativi a informazioni mancanti
Potresti ricevere uno dei seguenti messaggi di errore:
- "OpenSearch Dashboards/Kibana blank page"
- "Unable to see any data on OpenSearch Dashboards/Kibana Visualization or Dashboards"
Se mancano informazioni nella pagina Discovery (Rilevamento) della dashboard, completa i seguenti passaggi per verificare che i documenti abbiano un campo di indicazione temporale:
- Apri Kibana o OpenSearch Dashboards.
- Scegli Dashboards Management (Gestione dashboard).
- Scegli Index Pattern (Modello di indice).
- Seleziona il modello di indice.
- Nel campo Time (Data/ora), seleziona Timestamp.
Dopo aver configurato un campo timestamp per i documenti, controlla le seguenti configurazioni:
- Per verificare di aver configurato correttamente il campo timestamp, esegui questo comando nella console Dev Tools:
Nota: sostituisci your-index con il nome del tuo indice. Nell'output, assicurati che timestamp sia impostato su date. Se non è impostato su date, utilizza l'API _reindex per impostare il timestamp. Per ulteriori informazioni, consulta Reindex data (Reindicizzazione dei dati) sul sito web OpenSearch.GET your-index/_mappings?pretty - Assicurati di aver selezionato l'intervallo di tempo corretto per il modello di indice nella pagina Discover (Rileva).
- Se hai attivato il controllo granulare degli accessi, verifica che il ruolo del backend abbia le autorizzazioni per visualizzare i dati.
Monitora lo stato di integrità dei nodi
Le dashboard di Kibana e OpenSearch utilizzano le stesse risorse CPUUtilization e JVMMemoryPressure dei nodi del Servizio OpenSearch. Per verificare lo stato di integrità dei nodi, rivedi la metrica KibanaHealthyNodes o OpenSearchDashboardsHealthyNodes. Oppure controlla lo stato di integrità di Kibana nella scheda Integrità cluster del dominio nella console Servizio OpenSearch.
Le metriche sullo stato di integrità mostrano uno dei seguenti stati del plugin di Kibana o OpenSearch Dashboards che viene eseguito sui nodi di dati:
- Il verde indica che Kibana o OpenSearch Dashboards è in esecuzione su tutti i nodi di dati e non sono presenti problemi noti.
- Il giallo indica che Kibana o OpenSearch Dashboards è in esecuzione su alcuni nodi di dati, ma non tutti. Kibana o OpenSearch Dashboards funziona lentamente in questo stato.
- Il **rosso ** indica che Kibana o OpenSearch Dashboards è inattivo su tutti i nodi. Kibana o OpenSearch Dashboards non viene eseguito in questo stato e gli utenti non possono accedervi.
- Argomenti
- Analytics
- Lingua
- Italiano
