404-Fehler beheben

In dieser Anleitung erfahren Sie, wie Sie einen 404-Fehler auf einer Looker-Webseite oder in einer Looker API-Anfrage beheben. Ein 404-Fehler bedeutet in der Regel, dass die angeforderte Ressource nicht vorhanden ist oder dass der Nutzer keine Berechtigung hat, darauf zuzugreifen.

Debugging-Baum

Verwenden Sie den folgenden Entscheidungsbaum, um die Fehlerbehebung für einen 404-Fehler zu starten:

In den folgenden Abschnitten werden die Szenarien im Baum näher beschrieben.

404-Fehler im Browser beheben

Wenn der 404-Fehler auf einer Webseite in einem Browser angezeigt wird, folgen Sie der Anleitung in diesem Abschnitt. Andernfalls lesen Sie den Abschnitt API-Fehler.

JavaScript-Konsole prüfen

Prüfen Sie zuerst die JavaScript-Konsole in Ihrem Browser, um weitere Informationen zum Fehler zu erhalten. So öffnen Sie die JavaScript-Konsole in Google Chrome:

  1. Klicken Sie auf das Dreipunkt-Menü Mehr.
  2. Wählen Sie Weitere Tools aus.
  3. Klicken Sie auf Entwicklertools.
  4. Klicken Sie auf den Tab Konsole.

Suchen Sie in der Liste der Fehler nach dem 404-Fehler und suchen Sie die entsprechende URL.

Wenn die URL, die einen 404-Fehler zurückgibt, keine Looker-URL ist, stammt der Fehler von einer externen Ressource. Wenn die Anforderungs-URL zu einer benutzerdefinierten Anwendung gehört, die mit Looker verbunden ist, prüfen Sie den Code und die Logs Ihrer Anwendung, um den Fehler zu beheben. Der Looker-Support für Probleme mit externen Ressourcen ist begrenzt.

Wenn die URL eine Looker-URL ist, fahren Sie mit dem nächsten Abschnitt fort.

URL auf Tippfehler prüfen

Prüfen Sie die URL auf häufige Tippfehler. Beispiel:

  • Ein häufiger Tippfehler für eine Look-Seite ist /look/123. Die korrekte Syntax ist /looks/123.
  • Ein häufiger Tippfehler für eine Dashboard-Seite ist /dashboard/123. Die korrekte Syntax ist /dashboards/123.

Wenn Sie einen Link zu einem Explore, einem Look oder einem Dashboard in Ihre LookML einfügen, testen Sie den Link immer zuerst, um sicherzustellen, dass die Syntax korrekt ist.

Wenn Sie einen Tippfehler in einem Link finden, der aus Ihrer LookML generiert wurde, korrigieren Sie den Tippfehler in Ihrer LookML. Wenn Sie einen Tippfehler in einer URL finden, die von Looker generiert wurde (z. B. in einem UI-Navigationselement), wenden Sie sich an den Support und bitten Sie darum, die URL im Produkt zu korrigieren.

404-Fehler in der API beheben

Wenn der Fehler als Antwort auf einen Looker API-Aufruf angezeigt wird, folgen Sie der Anleitung in diesem Abschnitt.

Dokumentation zum API-Endpunkt prüfen

Suchen Sie die Dokumentation für den API-Endpunkt, der den 404-Fehler zurückgibt. Die Dokumentationsseite für den create_sso_embed_url Endpunkt ist Signierte Einbettungs-URL erstellen. Prüfen Sie die Parameter und stellen Sie sicher, dass Sie die richtigen Parameter für den API-Aufruf angeben.

Prüfen Sie, ob das Anforderungsverb und der Pfad korrekt sind. Der Endpunkt /api/4.0/embed/sso_url sollte beispielsweise mit dem Verb POST verwendet werden.

Sie können den API-Endpunkt auch direkt in Ihrer Instanz mit dem API Explorer testen.

Erforderliche Endpunktbedingungen prüfen

Einige Endpunkte sind nur unter bestimmten Bedingungen verfügbar:

  • Einige LookML-Projektendpunkte (z. B. create_project, deploy_to_production und reset_project_to_production) sind nur im Entwicklermodus verfügbar.
    • Verwenden Sie bei Bedarf den Endpunkt update_session mit dem Anfragetext {"workspace_id": "dev"}, um Ihre API-Sitzung in den Entwicklermodus zu wechseln.
  • Der reset_project_to_production Endpunkt ist in freigegebenen Branches nicht verfügbar.
  • Der Endpunkt deploy_ref_to_production ist nur verfügbar, wenn der erweiterte Bereitstellungsmodus aktiviert ist.

Webhook-Einstellungen prüfen

Wenn die Anforderungs-URL ein Bereitstellungs-Webhook ist, prüfen Sie die Webhook-Einstellungen.

Wenn Sie den Webhook verwenden, um einen bestimmten Branch oder eine bestimmte Referenz bereitzustellen, aktivieren Sie den erweiterten Bereitstellungsmodus für das Projekt.

Wenn für das Projekt ein Webhook-Bereitstellungs-Secret aktiviert ist, müssen Sie das Secret in die Anfrage einfügen.

Prüfen, ob angeforderte Ressourcen vorhanden sind

Prüfen Sie, ob alle Ressourcen, auf die in der Anfrage verwiesen wird, tatsächlich in Ihrer Looker-Instanz vorhanden sind.

Prüfen Sie, ob alle Werte in der Anforderungs-URL und im Anfragetext (z. B. Ordner-IDs oder Dashboard-IDs) auf gültige, vorhandene Ressourcen verweisen. Wenn Sie beispielsweise prüfen möchten, ob ein Dashboard vorhanden ist, rufen Sie als Administrator /dashboards/[id] auf. Wenn eine Ressource fehlt oder ungültig ist, erstellen Sie die fehlende Ressource oder geben Sie eine vorhandene Ressource an.

Wenn die Ressource vorhanden ist, Sie aber trotzdem einen 404-Fehler erhalten, prüfen Sie, ob die Ressource im Entwicklermodus vorhanden ist. Wenn der Looker-Nutzer die Berechtigung develop hat, prüfen Sie, ob der Nutzer auf die Ressource zugreifen kann, wenn er in den Entwicklermodus wechselt. Verwenden Sie für API-Aufrufe den update_session Endpunkt mit dem Anfragetext {"workspace_id": "dev"}, um Ihre API-Sitzung in den Entwicklermodus zu wechseln.

Wenn der Nutzer nicht die Berechtigung develop hat, stellen Sie das LookML-Projekt in der Produktion bereit und prüfen Sie dann, ob er darauf zugreifen kann.

Nutzerberechtigungen und Einstellungen für den Zugriff auf Inhalte prüfen

Wenn Ressourcen vorhanden sind, der Nutzer aber trotzdem einen 404-Fehler erhält, prüfen Sie die Berechtigungen des Nutzers und den Zugriff auf Inhalte.

Nutzer imitieren und nach dem Fehler suchen

Wenn Sie Administrator sind, rufen Sie das Steuerfeld Verwaltung > Nutzer auf und imitieren Sie den Nutzer, bei dem der 404-Fehler auftritt.

  • Wenn der Nutzer ein Einbettungsnutzer ist, prüfen Sie, ob seine Einbettungsanmeldedaten auf der Seite Verwaltung > Nutzer mit der external_user_id in der Einbettungs-Anmelde-URL übereinstimmen.
  • Wenn der Nutzer einen API-Aufruf durchführt, verwenden Sie den login_user Endpunkt , um den Nutzer zu imitieren.

Wenn der 404-Fehler auftritt, während Sie sich als Nutzer ausgeben, aber nicht, wenn Sie die Ressource als Administrator aufrufen, hat der Nutzer wahrscheinlich nicht die erforderlichen Berechtigungen oder Einstellungen für den Zugriff auf Inhalte.

Erforderliche Berechtigungen prüfen

Prüfen Sie die Rollen des Nutzers im Steuerfeld Verwaltung > Nutzer und die Liste der Berechtigungen in Looker, um sicherzustellen, dass der Nutzer in mindestens einer seiner Rollen die erforderlichen Berechtigungen hat. Um beispielsweise ein Dashboard aufzurufen, benötigt ein Nutzer mindestens die Berechtigungen access data, see_looks und see_user_dashboards. Wenn der Nutzer nicht die erforderlichen Berechtigungen hat, fügen Sie diese Berechtigungen einem Berechtigungssatz in einer Rolle hinzu, die diesem Nutzer zugewiesen ist.

Wenn erforderliche Berechtigungen modellspezifisch sind, prüfen Sie, ob das LookML-Modell in mindestens einer der Rollen des Nutzers mit der erforderlichen Berechtigung im Modellsatz enthalten ist. Wenn nicht, fügen Sie das Modell dem Modellsatz einer der Rollen hinzu, die dem Nutzer zugewiesen sind.

Gültige Einbettungsberechtigungen prüfen

Wenn der Nutzer ein angemeldeter Einbettungsnutzer ist, prüfen Sie, ob die erforderliche Berechtigung eine gültige Einbettungsberechtigung ist. Wenn nicht, kann der Einbettungsnutzer die Anfrage nicht erfolgreich ausführen. Einbettungsnutzern kann beispielsweise nicht die see_lookml Berechtigung zugewiesen werden.

Zugriffserteilungen prüfen

Wenn der Inhalt auf einem Explore mit definierten required_access_grants basiert, prüfen Sie die Definition von access_grant im LookML-Projekt. Bearbeiten Sie den Wert des Nutzerattributs für das angegebene Nutzerattribut in einen der erforderlichen Werte in der Zugriffserteilung.

Zugriff auf Inhalte prüfen

Wenn die angeforderte Ressource in einem Ordner gespeichert ist, prüfen Sie die Einstellungen für den Zugriff auf Inhalte für diesen Ordner. Looks, Dashboards und Data Studio-Berichte werden alle in Ordnern gespeichert.

Letzte Überprüfung und Support

Wenn der 404-Fehler weiterhin auftritt, prüfen Sie die Schritte zur Fehlerbehebung auf dieser Seite. Wenn Sie den 404-Fehler immer noch nicht beheben können, wenden Sie sich an den Support.