Direkt zum Inhalt
Durch die Nutzung von AWS re:Post stimmt du den AWS re:Post Nutzungsbedingungen
AWS re:Postre:Post
Über re:Post

Wie behebe ich Fehler in Kibana oder OpenSearch Dashboards in OpenSearch Service?

Lesedauer: 10 Minute
0

Ich möchte Fehler in Kibana oder OpenSearch Dashboards beheben, die ich in Amazon OpenSearch Service erhalte.

Lösung

Wenn grundlegende Infrastruktur- oder Konfigurationsprobleme vorliegen, erhältst du eine der folgenden Fehlermeldungen:

„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.“

Überprüfe die folgenden Einstellungen, um diese Probleme zu beheben und zu überprüfen, ob der Server ordnungsgemäß funktioniert:

Wenn weiterhin Probleme auftreten, führe die folgenden Schritte zur Problembehandlung aus, um das Problem zu lösen.

Behebe den Fehler „Http request timed out“ oder Probleme mit dem VPC-Zugriff

Wenn sich der OpenSearch-Service-Cluster in einer Virtual Private Cloud (VPC) befindet, erhältst du möglicherweise die Fehlermeldung „{"Message":"Http request timed out connecting"}“. Dieses Problem tritt auf, wenn ein Problem mit der Netzwerkerreichbarkeit die Verbindung zu Kibana oder OpenSearch Dashboards blockiert.

Gehe wie folgt vor, um diesen Fehler zu beheben:

  • Stelle sicher, dass die Sicherheitsgruppen der VPC eingehenden Datenverkehr auf Port 443 von deiner Client-IP-Adresse zulassen.
  • Wenn sich der Client in einer anderen VPC befindet als der OpenSearch-Service-Cluster, stelle sicher, dass du den Client und die OpenSearch-Service-Subnetze korrekt konfiguriert hast. Überprüfe beispielsweise die VPC-Endpunkte, die VPC-Peering-Verbindung, das VPN oder die AWS-Direct-Connect-Verbindung.
  • Stelle sicher, dass die Subnetz-Routing-Tabellen über die erforderlichen Routen für den Zugriff auf die OpenSearch-Service-Domain verfügen.

Weitere Informationen findest du unter Starten der OpenSearch-Service-Domains innerhalb einer VPC.

Den Fehler „User: anonymous is not authorized to perform“ beheben

Wenn du die differenzierte Zugriffskontrolle aktiviert hast und die SAML 2.0-Authentifizierung verwendest, wird möglicherweise die folgende Fehlermeldung angezeigt:

„{"Message":"User: anonymous is not authorized to perform: es:ESHttpGet because no resource-based policy allows the es:ESHttpGet action"}“

Gehe wie folgt vor, um diesen Fehler zu beheben:

Behebung von Integrationsproblemen bei SAML 2.0, Amazon Cognito oder IAM Identity Center

Ergreife die folgenden Maßnahmen:

Probleme mit benutzerdefinierten Proxys beheben

Wenn bei der Verwendung eines benutzerdefinierten Proxys Probleme auftreten, ergreife die folgenden Maßnahmen:

Ein Beispiel für eine Proxykonfiguration findest du unter Erstellen eines SAML-Identitätsverbunds für OpenSearch-Service-Domains innerhalb einer VPC.

Informationen zur Amazon-Cognito-Authentifizierung in einer VPC findest du unter Wie verwende ich einen NGINX-Proxy, um von außerhalb einer VPC auf OpenSearch Dashboards mit Amazon-Cognito-Authentifizierung zuzugreifen?

Problembehandlung bei abgelaufenen Zertifikaten

Abgelaufene Zertifikate auf Proxy-Endpunkten können zu Zugriffsproblemen führen.

Gehe wie folgt vor, um Zugriffsprobleme zu beheben:

  • Überprüfe die Ablaufdaten der Zertifikate, die du in deiner Proxyeinrichtung verwendest.
  • Erneuere abgelaufene Zertifikate und aktualisiere sie in der Proxykonfiguration.
  • Überwache die Zertifikate, damit du benachrichtigt wirst, bevor das Zertifikat abläuft.

Den Fehler „exceeded the number of permissible concurrent requests“ oder Probleme mit gedrosselten Ressourcen beheben

Wenn die Knoten zu viele signierte Anforderungen mit unterschiedlichen IAM-Anmeldeinformationen erhalten, erhältst du die folgende Fehlermeldung:

„You have exceeded the number of permissible concurrent requests with unique IAM Identities“

Gehe wie folgt vor, um diesen Fehler zu beheben:

  • Konsolidiere die IAM-Rollen oder -Benutzer, um die Vielfalt der Anmeldeinformationen zu reduzieren, die für Anforderungen verwendet werden.
  • Füge dem Cluster Knoten hinzu, um die Schwellenwerte für die Drosselung auf Knotenebene zu erhöhen.
  • Implementiere eine Wiederholungslogik in den Client-Anwendungen.
  • Erhöhe schrittweise das Anforderungsvolumen.
  • Vermeide Massenvorgänge mit mehreren Anmeldeinformationen.

Problembehandlung von Index- und Migrationsproblemen bei Blau/Grün-Bereitstellungen

Bei Blau/Grün-Bereitstellungen können aufgrund der folgenden Probleme Fehler auftreten:

  • Konflikte mit Platzhalter-Indexmustern in Vorlagen, die sich auf den Kibana- oder OpenSearch-Dashboards-Index auswirken.
  • Beschädigte Dokumente im Kibana- oder OpenSearch-Dashboard-Index.

Um diese Probleme zu beheben, führe den folgenden Befehl aus, um nach in Konflikt stehenden Indexvorlagen zu suchen:

GET _cat/templates

Beispielausgabe:

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> }
  }
}

Weitere Informationen findest du unter CAT templates API (CAT-Vorlagen-API) auf der OpenSearch-Website.

Es hat sich nicht bewährt, "index_patterns": "*" in der Indexvorlage zu verwenden, da sie alle Indizes enthält. Führe stattdessen den folgenden Befehl aus, um die Indexvorlage so zu ändern, dass sie nur Indizes mit einem bestimmten Präfix enthält:

PUT _template/my-index-template
{
    "index_patterns": ["your-index-prefix-*"],
    "settings": { index-settings },
    "mappings": { index-mappings },
    "aliases": { index-alias }
}

Hinweis: Ersetzeyour-index-prefix-* durch ein Indexpräfix, index-settings durch deine Indexeinstellungen, index-mappings durch deine Indexzuordnungen und index-alias durch deinen Index-Alias. Weitere Informationen findest du unter Put template (Vorlage platzieren) auf der OpenSearch-Website.

Lösche bei Bedarf den Kibana- oder OpenSearch-Dashboards-Index. Weitere Informationen findest du unter Delete index API (API zum Löschen von Indizes) auf der OpenSearch-Website. Stelle dann den Index aus einem manuellen Snapshot wieder her.

Problembehandlung bei Ausfällen einzelner Knoten

Abstürze einzelner Knoten können dazu führen, dass du den Zugriff auf Kibana oder OpenSearch Dashboards verlierst.

Gehe wie folgt vor, um diesen Fehler zu beheben:

Wenn du einen einzelnen Knoten hast, führe die folgenden Schritte aus, um den .kibana*-Index aus automatisierten Snapshots wiederherzustellen:

  1. Führe den folgenden Befehl aus, um die in deinem Repository verfügbaren automatisierten Snapshots aufzulisten: 
    GET /_cat/snapshots/repository
    Hinweis: Ersetze repository durch cs-automated bei einer unverschlüsselten Domain und durch cs-automated-enc bei einer verschlüsselten Domain.
  2. Führe den folgenden Befehl aus, um eine Liste der Indizes in einem bestimmten Snapshot anzuzeigen: 
    GET _snapshot/repo-name/snapshot-id?pretty
    Hinweis: Ersetze repo-name durch den Namen deines Repositorys und snapshot-id durch die Snapshot-ID.
  3. Führe den folgenden Befehl aus, um den .kibana*-Index wiederherzustellen: 
    POST _snapshot/repo-name/snapshot-id
{ "indices": ".kibana*" }
    Hinweis: Ersetze repo-name durch den Namen deines Repositorys und snapshot-id durch die Snapshot-ID. Wenn du beim Versuch, den Index wiederherzustellen, auf Berechtigungsprobleme stößt, öffne einen AWS-Supportfall. Sowohl Kibana als auch OpenSearch Dashboards verwenden den kibana*-Index.

Weitere Informationen findest du unter Warum ist mein OpenSearch-Service-Knoten abgestürzt?

Beheben des Fehlers „OpenSearch Security not initialized“

Die Fehlermeldung „OpenSearchSecurityException[OpenSearch Security not initialized for __PATH__]“ tritt auf, wenn die Sicherheitsinitialisierung fehlschlägt.

Um zu überprüfen, ob das Sicherheits-Plug-in für die Domain initialisiert wurde, öffne die URL https://kibana-dashboards-url/api/status?pretty in deinem Browser.

**Hinweis:**Ersetze kibana-dashboards-url durch deine Dashboard-URL.

Beispielausgabe:

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

Wenn der Status in der Ausgabe nicht grün ist, öffne die URL erneut. Wenn der Status immer noch nicht grün ist oder bei jedem Öffnen der URL schwankt, wurde das Sicherheits-Plug-in nicht korrekt initialisiert. Öffne einen AWS-Supportfall, um dieses Problem zu beheben.

Beheben des „500“-Fehlers

Wenn die CPU-Auslastung oder der JVM-Speicherdruck hoch sind, erhältst du möglicherweise die folgende Fehlermeldung:

„{"statusCode":500,"error":"Internal Server Error","message":"An internal server error occurred."}“

Stelle sicher, dass die CPU-Auslastung und der JVM-Speicherdruck nicht zu hoch sind. Weitere Informationen zu den Problemen, auf die du stößt, findest du in den OpenSearch-Protokollen. Dort findest du weitere Informationen zu Fehlern oder Ausnahmen. Wenn die CPU-Auslastung und der JVM-Speicherdruck niedrig sind, du aber immer noch den Fehler „500“ erhältst, öffne einen AWS-Supportfall.

Problembehandlung bei fehlenden Informationen

Möglicherweise erhältst du eine der folgenden Fehlermeldungen:

  • „OpenSearch Dashboards/Kibana blank page“
  • „Unable to see any data on OpenSearch Dashboards/Kibana Visualization or Dashboards“

Wenn auf der Seite Discovery (Suche) des Dashboards Informationen fehlen, führe die folgenden Schritte aus, um zu überprüfen, ob die Dokumente ein Zeitstempelfeld haben:

  1. Öffne Kibana oder OpenSearch Dashboards.
  2. Wähle Dashboards Management (Verwaltung von Dashboards).
  3. WähleIndex Pattern (Indexmuster).
  4. Wähle dein Indexmuster aus.
  5. Wähle als Time field (Zeitfeld) die Option Timestamp (Zeitstempel) aus.

Nachdem du ein Zeitstempelfeld für die Dokumente konfiguriert hast, überprüfe die folgenden Konfigurationen:

  • Um zu überprüfen, ob du das Zeitstempelfeld richtig konfiguriert hast, führe den folgenden Befehl in der Dev Tools-Konsole aus: 
    GET your-index/_mappings?pretty
    Hinweis: Ersetze your-index durch deinen Indexnamen. Stelle in der Ausgabe sicher, dass timestamp (Zeitstempel) auf date (Datum) gesetzt ist. Wenn es nicht auf date (Datum) gesetzt ist, verwende die _reindex-API, um den Zeitstempel festzulegen. Weitere Informationen findest du unter Reindex data (Daten neu indizieren) auf der OpenSearch-Website.
  • Vergewissere dich, dass du auf der Seite Discover (Suchen) den richtigen Zeitraum für dein Indexmuster ausgewählt hast.
  • Wenn du die differenzierte Zugriffskontrolle aktiviert hast, stelle sicher, dass die Backend-Rolle über Berechtigungen zum Anzeigen der Daten verfügt.

Den Zustand der Knoten überwachen

Kibana und OpenSearch Dashboards verwenden dieselben CPUUtilization- und JVMMemoryPressure-Ressourcen wie die OpenSearch-Service-Knoten. Um den Zustand der Knoten zu überprüfen, prüfe die Metrik KibanaHealthyNodes oder OpenSearchDashboardsHealthyNodes. Oder überprüfe den Kibana-Zustand auf der Registerkarte Cluster-Zustand deiner Domain in der OpenSearch-Service-Konsole.

Die Zustandsmetriken zeigen einen der folgenden Zustände des Kibana- oder OpenSearch-Dashboards-Plug-ins, das auf den Datenknoten ausgeführt wird:

  • **Grün ** bedeutet, dass Kibana oder OpenSearch Dashboards auf allen Datenknoten ausgeführt werden und keine bekannten Probleme vorliegen.
  • Gelb bedeutet, dass Kibana oder OpenSearch Dashboards auf einigen, aber nicht allen Datenknoten ausgeführt werden. Kibana oder OpenSearch Dashboards werden in diesem Status langsam ausgeführt.
  • Rot bedeutet, dass Kibana oder OpenSearch Dashboards auf allen Knoten ausgefallen sind. Kibana oder OpenSearch Dashboards werden in diesem Status nicht ausgeführt und Benutzer haben keinen Zugriff.
Themen
Analytics
Tags
Amazon OpenSearch Service
Sprache
Deutsch
AWS OFFICIALAktualisiert vor 3 Monaten

Relevanter Inhalt