Salta al contenuto

Come posso risolvere gli errori di Kibana o OpenSearch Dashboards nel Servizio OpenSearch?

11 minuti di lettura
0

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:

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:

Risolvi i problemi di integrazione con SAML 2.0, Amazon Cognito o il Centro identità IAM

Intraprendi le seguenti azioni:

Risolvi i problemi relativi ai proxy personalizzati

Se riscontri problemi quando utilizzi un proxy personalizzato, intraprendi le seguenti azioni:

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:

Se hai un solo nodo, completa i seguenti passaggi per ripristinare l'indice .kibana* da snapshot automatici:

  1. Per elencare gli snapshot automatici disponibili nel repository, esegui questo comando:
    GET /_cat/snapshots/repository
    Nota: sostituisci repository con **cs-automated ** per un dominio non crittografato e cs-automated-enc per un dominio crittografato.
  2. Per visualizzare un elenco degli indici in uno snapshot specifico, esegui questo comando:
    GET _snapshot/repo-name/snapshot-id?pretty
    Nota: sostituisci repo-name con il nome del tuo repository e snapshot-id con l'ID dello snapshot.
  3. Per ripristinare l'indice .kibana*, esegui questo comando:
    POST _snapshot/repo-name/snapshot-id
    { "indices": ".kibana*" }
    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*.

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:

  1. Apri Kibana o OpenSearch Dashboards.
  2. Scegli Dashboards Management (Gestione dashboard).
  3. Scegli Index Pattern (Modello di indice).
  4. Seleziona il modello di indice.
  5. 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:
    GET your-index/_mappings?pretty
    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.
  • 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.
AWS UFFICIALEAggiornata 6 mesi fa