OpenSearch Dashboards zur Fehlerbehebung

In diesem Abschnitt werden bekannte Probleme beschrieben, die dazu führen können, dass OpenSearch Dashboards nicht mehr verfügbar sind, nicht geladen werden können oder sich unerwartet verhalten. Jedes Problem enthält die Maßnahmen, die Sie ergreifen können, um es selbst zu lösen. Dashboards wird auf den Hot-Data-Nodes in Ihrer Domain ausgeführt und speichert ihren Status (Indexmuster, Visualisierungen und Dashboards) im Dashboard-Index. OpenSearch Daher sind die meisten Probleme mit der Verfügbarkeit von Dashboards auf den Zustand des Clusters, den Speicher, eine OpenSearch Dashboard-Indexmigration, eine Cluster- oder Dashboard-Einstellung, Ressourcenlimits oder die Service-Softwareversion der Domain zurückzuführen.

Jedes Problem ist in Symptome (was Sie sehen und wie Sie es bestätigen können), Grundursache, Problembehebungsmöglichkeiten (Self-Service-Schritte) und Vorgeschlagene Maßnahmen (wie Sie verhindern können, dass es erneut auftritt) unterteilt.

Anmerkung

Viele bekannte Probleme mit Dashboards wurden bereits in einer neueren Version der Servicesoftware behoben. Bevor Sie weitere Probleme beheben, öffnen Sie die Amazon OpenSearch Service-Konsole (die AWS Konsole für den Service, nicht die OpenSearch Dashboard-Benutzeroberfläche), überprüfen Sie den Benachrichtigungsbereich und installieren Sie das neueste verfügbare Service-Software-Update. In den folgenden Abschnitten wird diese Maßnahme als empfohlene Maßnahme aufgeführt. Wenn bereits eine Konfigurationsänderung oder ein Upgrade durchgeführt wird, warten Sie, bis die Änderung abgeschlossen ist, bevor Sie ein Update installieren.

Dashboards bleibt bei „Server ist noch nicht bereit“ hängen (HTTP 503 not ready Fehler)

Symptom

Dashboards wird angezeigt OpenSearch Dashboards server is not ready yet (der Fehler HTTP 503 ist nicht bereit) und der Ladevorgang wird nicht abgeschlossen. Dashboards zeigt diese Seite immer dann an, wenn der Start noch nicht abgeschlossen ist. Eine kurze Version ist bei einem Neustart, Upgrade oder einer blue/green Bereitstellung normal und wird von selbst gelöscht. Behandeln Sie es als Problem, wenn es weiterhin besteht. Um die Ursache einzugrenzen, überprüfen Sie den Zustand des Clusters der Domäne und ob gerade eine Konfigurationsänderung oder ein Upgrade im Gange ist:

• Wenn gerade eine Änderung oder ein Upgrade durchgeführt wird, ist die Meldung in der Regel vorübergehend. Warten Sie, bis die Domäne wieder aktiv ist.

• Wenn der Clusterstatus rot ist, können Dashboards nicht gestartet werden, da dies vom Cluster abhängt. Beheben Sie zuerst das Clusterproblem (sieheVerwandte Cluster- und Zugriffsprobleme).

• Wenn die Meldung weiterhin angezeigt wird, obwohl der Clusterstatus grün ist, ist die OpenSearch Dashboard-Indexmigration höchstwahrscheinlich blockiert (siehe unten).

Ursache

Dashboards meldet, dass der Server noch nicht bereit ist, bis die Initialisierung aller Kerndienste abgeschlossen ist. Aus diesem Grund wird beim Start und bei der Bereitstellung eine vorübergehende Version der Nachricht erwartet. blue/green Wenn weiterhin ein grüner Cluster angezeigt wird, ist die häufigste Ursache, dass die Migration des OpenSearch Dashboards-Index blockiert ist: Beim Start migriert Dashboards seine gespeicherten Objekte in einen neuen Index hinter einem Alias, und wenn diese Migration nicht abgeschlossen werden kann, ist Dashboards nie bereit. Häufige Auslöser für eine blockierte Migration:

• Nach einem Upgrade kann es aus den folgenden Gründen zu einer blockierten Migration kommen:

  • Ein OpenSearch Dashboard-Index, der von einer früheren Version übrig geblieben ist, verhindert, dass der neue Alias erstellt wird.

  • Ein Upgrade von einer älteren Engine-Version, deren Dashboards keinen Alias verwendet haben, steht in Konflikt mit einem vorhandenen Index.

  • Dokumente, die von einer neueren (selbstverwalteten) Dashboards-Instanz geschrieben wurden, können nicht automatisch auf die Zielversion migriert werden.

• Ohne ein Upgrade kann es aus den folgenden Gründen zu einer blockierten Migration kommen:

  • Ein beschädigter OpenSearch Dashboard-Index, der durch eine UI-Anfrage oder eine Wiederherstellung erstellt wurde, blockiert den Alias.

  • Zwei oder mehr versionierte OpenSearch Dashboard-Indizes verweisen auf denselben Alias. Dies kann auch als Internal Server Error (HTTP 500) angezeigt werden, selbst wenn der Clusterstatus grün ist.

  • Per-user oder Indizes pro Mandant wurden ohne Alias für Domains erstellt, die eine differenzierte Zugriffskontrolle oder Amazon Cognito Cognito-Authentifizierung verwenden.

  • Eine Änderung der Zuordnung von gespeicherten Objekten kann aufgrund eines fehlerhaften Dokuments nicht angewendet werden.

Wie kann das Problem behoben werden

1. Wenn eine Konfigurationsänderung oder ein Versionsupgrade im Gange ist, warten Sie, bis die Domain wieder aktiv ist. Die Meldung ist oft vorübergehend und löscht sich von selbst. Eine normale Änderung oder ein Upgrade wird innerhalb weniger Stunden abgeschlossen. Wenn Dashboards mehr als 4 Stunden, nachdem die Domain wieder aktiv ist, immer noch nicht verfügbar ist, behandeln Sie es als anhaltendes Problem. Fahren Sie mit den folgenden Schritten fort. (Sie können kein Service-Softwareupdate starten, solange die Domäne noch eine Änderung verarbeitet.)

2. Wenn der Clusterstatus rot oder gelb ist, lösen Sie zuerst das Clusterproblem (sieheVerwandte Cluster- und Zugriffsprobleme). Dashboards können auf einem fehlerhaften Cluster nicht gestartet werden.

3. Wenn die Meldung weiterhin angezeigt wird, obwohl der Clusterstatus grün ist, erstellen Sie einige schreibgeschützte Diagnosen, damit der AWS Support das Problem schneller lösen kann, und wenden Sie sich dann an den AWS Support, um den OpenSearch Dashboard-Index zu reparieren. Schließen Sie in Ihrem Fall die Ausgabe der folgenden Befehle ein:

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

   Das Reparieren der blockierten Migration ist die Lösung für eine bereits festgefahrene Domain. Durch die Installation eines Softwareupdates wird eine bereits festgefahrene Domain nicht entsperrt. Löschen Sie den OpenSearch Dashboards-Index nicht selbst. Wenn Sie ihn löschen, werden alle gespeicherten Visualisierungen, Dashboards und Indexmuster, die nicht in einem Snapshot gesichert wurden, dauerhaft entfernt. Wenn für eine Reparatur ein Index gelöscht werden muss, der Daten enthält, bittet der AWS Support zunächst um Ihre Zustimmung. Für eine Produktionsdomäne, die seit mehr als einer Stunde nicht verfügbar ist und keine Konfigurationsänderung im Gange ist, öffnen Sie Ihren Support-Fall mit dem Schweregrad Produktionssystem beeinträchtigt oder höher.

4. Um ein erneutes Auftreten zu verhindern, sollten Sie für die Domäne stets das neueste Service-Software-Update verwenden. Aktuelle Versionen beheben die häufigsten Ursachen für Migrationsfehler. Installieren Sie das Update, nachdem die Domäne wieder aktiv ist.

5. Erstellen Sie vor jedem Versionsupgrade einen manuellen Snapshot, damit Sie gespeicherte Objekte wiederherstellen können, falls eine Migration fehlschlägt. Weitere Informationen zum Erstellen von Schnappschüssen finden Sie unterIndex-Snapshots in Amazon OpenSearch Service erstellen.

Vorgeschlagene Aktion

Verwenden Sie für Ihre Domain immer die aktuelle Version der Service-Software und erstellen Sie vor jedem Upgrade einen Snapshot. Wenn Sie sich bei der Produktionsüberwachung auf Dashboards verlassen, sollten Sie die zentralisierte Methode in Betracht ziehenVerwenden der OpenSearch Benutzeroberfläche in Amazon OpenSearch Service, die nicht an die Indexmigration der OpenSearch Dashboards pro Domain einer einzelnen Domain gebunden ist.

Dashboards können mit einer allow_explicit_index-Nachricht nicht geladen werden

Symptom

Dashboards können nicht geladen werden und es wird eine Meldung ähnlich der folgenden angezeigt:

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

Ursache

Die rest.action.multi.allow_explicit_index erweiterte Clusteroption ist auf false eingestellt. Stellen Sie diese Option auf ein, true damit Dashboards ihre Bulk-, Mget- und Msearch-Operationen ausführen kann.

Wie kann das Problem behoben werden

rest.action.multi.allow_explicit_indexKehren Sie zu true den erweiterten Optionen der Domain zurück. Dies ist eine Änderung auf der Verwaltungsebene, die Sie mit Ihren eigenen AWS Anmeldeinformationen vornehmen, entweder in der Konsole (öffnen Sie die Domäne, wählen Sie Bearbeiten und aktualisieren Sie die erweiterten Clustereinstellungen) oder über die AWS Befehlszeilenschnittstelle (AWS CLI):

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

Wenn Sie eine erweiterte Option ändern, wird eine blue/green Bereitstellung ausgelöst, sodass es einige Minuten dauert, bis die Änderung übernommen wird. Weitere Informationen zu erweiterten Clustereinstellungen finden Sie unterErweiterte Clustereinstellungen.

Vorgeschlagene Aktion

Setzen Sie diesen Wert nicht rest.action.multi.allow_explicit_index auf, false es sei denn, Sie beabsichtigen, den Indexzugriff durch ressourcenbasierte Richtlinien einzuschränken. Wenn Sie die Standardeinstellung (true) beibehalten, bleiben die Dashboards betriebsbereit.

Den Dashboards geht der Arbeitsspeicher aus

Symptom

Dashboards starten neu, stürzen ab oder reagieren beim Laden nicht mehr, insbesondere wenn große Dashboards geöffnet oder viele gespeicherte Objekte geladen werden.

Ursache

Der Dashboard-Prozess hat den verfügbaren Speicherplatz erschöpft, was häufig darauf zurückzuführen ist, dass zu viele gespeicherte Objekte geladen oder umfangreiche Dashboards gerendert wurden.

Wie kann das Problem behoben werden

1. Installieren Sie das neueste Service-Software-Update. Aktuelle Versionen passen die Größe des Dashboard-Heaps dynamisch an und entfernen die frühere feste Größenbeschränkung.

2. Wenn Sie es in den erweiterten Einstellungen erhöht haben savedObjects:listingLimit (Standard1000), reduzieren Sie es. Große Werte, wie z. B.10000, haben zu Fehlern aufgrund mangelnden Speichers geführt.

3. Reduzieren Sie die Komplexität des Dashboards, die Anzahl der Bedienfelder und die Häufigkeit der automatischen Aktualisierung.

4. Wenn die Speichernutzung chronisch hoch ist, skalieren Sie auf einen Instance-Typ mit mehr Speicher. Weitere Informationen zur Größenbestimmung von Domänen finden Sie unterDimensionierung von Amazon OpenSearch Service-Domains.

Vorgeschlagene Aktion

Um dies catch, bevor Dashboards nicht mehr genügend Arbeitsspeicher zur Verfügung hat, sollten Sie die OpenSearchDashboardsHeapUtilization CloudWatch Metrik beobachten. Wenn sie durchweg 80% überschreitet, skalieren Sie auf einen größeren Instance-Typ. Right-size Wählen Sie den Instance-Typ für Ihre Dashboard-Nutzung aus, halten Sie die Dashboards schlank und vermeiden Sie, dass die Anzahl über das savedObjects:listingLimit hinausgeht, was Sie benötigen.

Anfragen schlagen aufgrund der Größe der Nutzlast fehl

Symptom

Bestimmte Dashboard-Seiten können nicht geladen werden, weil die Nutzlast der Anfrage das Payload-Limit für Dashboards überschreitet (standardmäßig 1 MB server.maxPayloadBytes /1.048.576 Byte).

Ursache

Indexmuster, die mit einer sehr großen Anzahl von Indizes oder Feldern übereinstimmen, führen zu Anfragen, die das Nutzlastlimit überschreiten.

Wie kann man das abmildern

1. Reduzieren Sie die Größe der Anfrage, anstatt das Limit zu erhöhen:

   • Reduzieren Sie die Anzahl der Indizes in Ihren Indexmustern.

   • Reduzieren Sie die Anzahl der Felder.

   • Reduzieren Sie die Länge des Feldnamens.

2. Wenden Sie sich an den AWS Support, um die unterstützte Option auf Kontoebene anzufordern, bei der ein erhöhter server.maxPayloadBytes Wert beibehalten wird, sodass sie blue/green Bereitstellungen und den Austausch von Knoten übersteht. Diese Option ist in allen unterstützten Amazon OpenSearch Service-Versionen verfügbar.

Anmerkung

Versuchen Sie nicht, dieses Limit zu erhöhen, indem Sie die Dashboard-Konfiguration auf den Knoten selbst bearbeiten. Node-level Änderungen sind nicht dauerhaft. Bei jeder blue/green Bereitstellung oder jedem Austausch von Knoten werden sie entfernt. Verwenden Sie stattdessen die Option auf Kontoebene über den AWS Support.

Vorgeschlagene Aktion

Beschränken Sie die Indexmuster auf die Indizes und Felder, die Sie tatsächlich verwenden, damit Anfragen innerhalb des Nutzlastlimits bleiben.

Dashboards sind während eines Versionsupgrades nicht verfügbar

Symptom

Dashboards sind für den Großteil der Dauer einer Bereitstellung eines blue/green Engine-Versionsupgrades nicht verfügbar. Dies ist ein erwartetes Verhalten, kein Fehler, und es behebt sich von selbst, wenn das Upgrade abgeschlossen ist.

Ursache

Dashboards bleiben während des größten Teils eines Versionsupgrades offline, um zu vermeiden, dass es bei der Versionsprüfung zu einem Wettlauf zwischen der alten und der neuen Umgebung kommt.

Wie kann das Problem behoben werden

Warten Sie, bis das Upgrade abgeschlossen ist. Dashboards sind automatisch wieder verfügbar. Behandeln Sie Versionsupgrades wie ein geplantes Wartungsfenster für Dashboards und planen Sie sie außerhalb geschäftskritischer Zeiten. Weitere Informationen zu Konfigurationsänderungen finden Sie unter. Konfigurationsänderungen in Amazon OpenSearch Service vornehmen

Vorgeschlagene Aktion

Planen Sie Upgrades in Zeitfenstern mit geringem Datenverkehr. Wenn Sie die Verfügbarkeit von Dashboards benötigen, die nicht an das Upgrade-Fenster einer einzelnen Domain gebunden ist, sollten Sie die zentralisierte Version in Betracht ziehen. Verwenden der OpenSearch Benutzeroberfläche in Amazon OpenSearch Service

Ein Engine-Versions-Upgrade schlägt die Prüfung vor dem Upgrade mit einem inkompatiblen Index fehl

Symptom

Sie starten ein Engine-Versions-Upgrade (oder führen die Upgrade-Eignungsprüfung durch), und die Prüfung vor dem Upgrade schlägt fehl, bevor das Upgrade beginnt. In der Bestätigungsbenachrichtigung werden ein oder mehrere inkompatible Indizes aufgeführt und der OpenSearch Dashboards-Index kann spezifisch benannt werden. Dies ist in der Regel der Fall, wenn Sie ein Upgrade auf OpenSearch 3.x durchführen, während die Domain noch über Indizes verfügt, die in OpenSearch 1.3, Elasticsearch 7.10 oder früher erstellt wurden, einschließlich des Dashboards-Index. OpenSearch (Upgrades von OpenSearch 1.3 oder 2.x müssen zuerst auf OpenSearch 2.19 und dann auf 3.x durchgeführt werden.) OpenSearch

Ursache

OpenSearch kann nur Indizes aus der unmittelbar vorhergehenden Hauptversion lesen, daher unterstützt OpenSearch 3.x keine Indizes, die in OpenSearch 1.3, Elasticsearch 7.10 oder früher erstellt wurden. Die Prüfung vor dem Upgrade blockiert das Upgrade und listet diese Indizes absichtlich auf, sodass Sie keine Daten verlieren. Vor einem Upgrade einer Hauptversion müssen Sie ältere Indizes neu indizieren oder entfernen. Der Service indexiert sie nicht automatisch neu. Der OpenSearch Dashboard-Index folgt derselben Regel.

Wie kann man das abmildern

1. Führen Sie die Upgrade-Eignungsprüfung durch, um die vollständige Liste der inkompatiblen Indizes zu sehen (dieselbe Liste befindet sich in der Benachrichtigung über ein fehlgeschlagenes Upgrade). Weitere Informationen zum Upgrade von Domänen finden Sie unter. Upgrade von Amazon OpenSearch Service-Domains

2. Erstellen Sie einen manuellen Snapshot, bevor Sie Änderungen vornehmen. Weitere Informationen zum Erstellen von Schnappschüssen finden Sie unterIndex-Snapshots in Amazon OpenSearch Service erstellen.

3. Indizieren Sie jeden inkompatiblen Datenindex erneut in einen neuen Index (der in der aktuellen Version erstellt wurde) und löschen Sie dann den alten. Bei Indizes UltraWarm oder kalten Indizes verschieben Sie sie zuerst in den heißen Speicher, indizieren Sie sie erneut und verschieben Sie sie dann zurück.

   POST _reindex
   { "source": { "index": "my-old-index" }, "dest": { "index": "my-new-index" } }

4. Erstellen Sie für den OpenSearch Dashboard-Index zuerst eine Sicherungskopie, da er Ihre Indexmuster, Visualisierungen und Dashboards enthält: Gehen Sie in Dashboards zu Dashboard-Verwaltung, Gespeicherte Objekte, und exportieren Sie sie. Löschen Sie anschließend den inkompatiblen Index. Nach dem Upgrade wird automatisch ein neuer, kompatibler Index erstellt. Importieren Sie Ihre gespeicherten Objekte anschließend erneut. Wenn Sie es lieber nicht löschen möchten, wenden Sie sich an den AWS Support.

5. Löschen Sie alle inkompatiblen Indizes, die Sie nicht mehr benötigen, anstatt sie erneut zu indizieren.

6. Re-run überprüfen Sie die Eignung und lösen Sie das Upgrade erneut aus, nachdem es erfolgreich abgeschlossen wurde.

Vorgeschlagene Aktion

Indizieren Sie alte Indizes neu oder entfernen Sie sie, sodass sie nicht mehr als eine Hauptversion umfassen. Indizes, die über mehrere Upgrades hinweg übrig geblieben sind, blockieren irgendwann eine. Erstellen Sie vor jedem Upgrade einen manuellen Snapshot und exportieren Sie die auf Ihrem OpenSearch Dashboard gespeicherten Objekte regelmäßig als Backup.

Dashboards wird nicht richtig geladen, zeigt eine leere Seite an oder generiert leere Berichte

Symptom

Ein einzelner Benutzer oder Browser sieht eine leere Seite, leere Berichte oder ein rotes Banner mit der AufschriftOpenSearch Dashboards did not load properly. Check the server output for more information., während andere Benutzer davon nicht betroffen sind. Bestätigen Sie, indem Sie es in einem privaten (Inkognito-) Fenster oder einem anderen Browser reproduzieren.

Ursache

Ein veralteter Browser-Cache verursacht dieses Problem, insbesondere nach einem Service-Software-Update oder wenn Sie die Berichtsfunktion verwenden.

Wie kann das Problem behoben werden

1. Leeren Sie Ihren Browser-Cache und die Cookies und laden Sie die Seite dann erneut. Versuchen Sie es mit einem privaten (Inkognito-) Fenster und einem unterstützten, aktuellen Browser.

2. Deaktivieren Sie Werbeblocker oder Browsererweiterungen für die Dashboard-URL.

3. Wenn das Banner für alle Benutzer (nicht nur für einen Browser) weiterhin angezeigt wird, installieren Sie das neueste Service-Software-Update und wenden Sie sich dann an den AWS Support, falls das Problem weiterhin besteht.

Vorgeschlagene Aktion

Leeren Sie Ihren Browser-Cache nach einem Service-Software-Update und verwenden Sie einen unterstützten, aktuellen Browser.

Nicht unterstützte Konfigurationen

Vermeiden Sie diese Konfigurationen, die häufig zu Problemen mit Dashboards führen:

• Reverse-Proxys (z. B. Nginx) vor Dashboards werden nur für die Zugriffskontrolle unterstützt, wie unter beschrieben. Verwenden eines Proxys für den Zugriff auf den OpenSearch Service über Dashboards Wenn Sie Dashboards mit Proxy-Software eines Drittanbieters ausführen und ein unerwarteter Fehler auftritt, reproduzieren Sie das Problem ohne den Proxy, bevor Sie sich an den AWS Support wenden.

• Manuelle Änderungen an Knotenkonfigurationsdateien sind nicht dauerhaft. Bei jeder blue/green Bereitstellung oder jedem Austausch von Knoten werden sie rückgängig gemacht. Verwenden Sie unterstützte Einstellungen und Optionen anstelle von Änderungen auf Knotenebene. Sie können SSH nicht verwenden, um auf Knoten zuzugreifen oder Konfigurationsdateien direkt zu ändern.

Verwandte Cluster- und Zugriffsprobleme

Da Dashboards von einem fehlerfreien Cluster und der Zugriffskonfiguration Ihrer Domain abhängen, gelten die folgenden Themen zur Fehlerbehebung häufig, wenn Dashboards nicht verfügbar sind. Informationen zu all diesen Themen finden Sie unter. Problembehebung bei Amazon OpenSearch Service

• Zugriff auf OpenSearch Dashboards nicht möglich: Zugriffsrichtlinie und Amazon Cognito Cognito-Authentifizierung, einschließlich der User: anonymous is not authorized to perform: es:ESHttpGet Fehler- und VPC-access Anforderungs-Timeouts.

• Roter Clusterstatus und gelber Clusterstatus: Nicht zugewiesene Shards verhindern, dass Dashboards ihren Dashboard-Index lesen oder schreiben. OpenSearch

• ClusterBlockException: Niedriger Speicherplatz oder hoher JVM-Speicherdruck blockieren Schreibvorgänge, einschließlich Schreibvorgänge in den Dashboard-Index. OpenSearch

• JVM OutOfMemoryError - und Anforderungsdrosselung: Eine Clusterüberlastung tritt als Fehler und Antworten der Dashboards auf. 429 Too Many Requests