Résoudre les erreurs 404

Ce guide vous aide à résoudre les problèmes d'erreur 404 sur une page Web Looker ou dans une requête de l'API Looker. Une erreur 404 signifie généralement que la ressource demandée n'existe pas ou que l'utilisateur n'est pas autorisé à y accéder.

Arborescence de débogage

Utilisez l'arbre de décision suivant pour commencer à résoudre une erreur 404 :

Les sections suivantes décrivent plus en détail les scénarios de l'arborescence.

Résoudre une erreur 404 dans le navigateur

Si l'erreur 404 s'affiche sur une page Web dans un navigateur, suivez la procédure décrite dans cette section. Dans le cas contraire, consultez la section Erreur d'API.

Vérifier la console JavaScript

Commencez par consulter la console JavaScript de votre navigateur pour en savoir plus sur l'erreur. Pour ouvrir la console JavaScript sur Google Chrome, procédez comme suit :

  1. Cliquez sur le menu à trois points Plus.
  2. Sélectionnez Plus d'outils.
  3. Cliquer sur Outils de développement.
  4. Cliquez sur l'onglet Console.

Recherchez l'erreur 404 dans la liste des erreurs et trouvez l'URL correspondante.

Si l'URL renvoyant une erreur 404 n'est pas une URL Looker, l'erreur provient d'une ressource externe. Si l'URL de la requête appartient à une application personnalisée qui se connecte à Looker, examinez le code et les journaux de votre application pour résoudre le problème. L'assistance Looker pour les problèmes liés aux ressources externes est limitée.

Si l'URL est une URL Looker, passez à la section suivante.

Vérifiez que l'URL ne contient pas de fautes de frappe.

Vérifiez que l'URL ne contient pas de fautes de frappe courantes. Exemple :

  • Une faute de frappe courante pour une page Look est /look/123. La syntaxe correcte est /looks/123.
  • Une faute de frappe courante pour une page de tableau de bord est /dashboard/123. La syntaxe correcte est /dashboards/123.

Lorsque vous incluez un lien vers une exploration, un Look ou un tableau de bord dans votre LookML, testez toujours le lien en premier pour vous assurer que la syntaxe est correcte.

Si vous trouvez une faute de frappe dans un lien généré à partir de votre code LookML, corrigez-la dans votre code LookML. Si vous trouvez une faute de frappe dans une URL générée par Looker (par exemple, dans un élément de navigation de l'UI), contactez l'assistance pour demander à ce que l'URL soit corrigée dans le produit.

Résoudre une erreur 404 dans l'API

Si l'erreur s'affiche en réponse à un appel de l'API Looker, suivez les étapes de cette section.

Consulter la documentation sur le point de terminaison de l'API

Consultez la documentation du point de terminaison de l'API qui renvoie l'erreur 404. Par exemple, la page de documentation du point de terminaison create_sso_embed_url est Créer une URL d'intégration signée. Vérifiez les paramètres et assurez-vous de fournir les bons paramètres à l'appel d'API.

Assurez-vous que le verbe et le chemin de la requête sont corrects. Par exemple, le point de terminaison /api/4.0/embed/sso_url doit être utilisé avec le verbe POST.

Vous pouvez également tester le point de terminaison de l'API directement sur votre instance à l'aide de l'explorateur d'API.

Vérifier les conditions requises pour le point de terminaison

Certains points de terminaison ne sont disponibles que sous certaines conditions :

  • Certains points de terminaison de projet LookML (tels que create_project, deploy_to_production et reset_project_to_production) ne sont disponibles qu'en mode Développement.
    • Si nécessaire, utilisez le point de terminaison update_session avec le corps de la requête {"workspace_id": "dev"} pour passer votre session d'API en mode développement.
  • Le point de terminaison reset_project_to_production n'est pas disponible sur les branches partagées.
  • Le point de terminaison deploy_ref_to_production n'est disponible que lorsque le mode de déploiement avancé est activé.

Vérifier les paramètres du webhook

Si l'URL de la requête est un webhook de déploiement, vérifiez les paramètres de votre webhook.

Si vous utilisez le webhook pour déployer une branche ou une référence spécifique, activez le mode Déploiement avancé dans le projet.

Si un secret de déploiement de webhook est activé dans le projet, assurez-vous d'inclure le secret dans la requête.

Vérifier si les ressources demandées existent

Vérifiez que toutes les ressources référencées dans la demande existent réellement dans votre instance Looker.

Vérifiez que toutes les valeurs de l'URL et du corps de la requête (telles que les ID de dossier ou de tableau de bord) font référence à des ressources valides et existantes. Par exemple, pour vérifier si un tableau de bord existe, accédez à /dashboards/[id] en tant qu'utilisateur administrateur. Si une ressource est manquante ou non valide, créez-la ou spécifiez-en une existante.

Si la ressource existe, mais que vous recevez toujours une erreur 404, vérifiez si elle existe en mode développement. Si l'utilisateur Looker dispose de l'autorisation develop, vérifiez s'il peut accéder à la ressource lorsqu'il passe en mode Développement. Pour les appels d'API, utilisez le point de terminaison update_session avec le corps de la requête {"workspace_id": "dev"} pour passer votre session d'API en mode Développement.

Si l'utilisateur ne dispose pas de l'autorisation develop, essayez de déployer le projet LookML en production, puis vérifiez s'il peut y accéder.

Vérifier les autorisations des utilisateurs et les paramètres d'accès au contenu

Si des ressources existent, mais que l'utilisateur reçoit toujours une erreur 404, vérifiez ses autorisations et son accès au contenu.

Emprunter l'identité de l'utilisateur et rechercher l'erreur

Si vous êtes administrateur, accédez au panneau Admin > Utilisateurs et empruntez l'identité (sudo) de l'utilisateur qui rencontre l'erreur 404.

  • Si l'utilisateur est un utilisateur intégré, vérifiez que ses identifiants d'intégration sur la page Admin > Utilisateurs correspondent à external_user_id dans l'URL de connexion intégrée.
  • Si l'utilisateur effectue un appel d'API, utilisez le point de terminaison login_user pour l'usurper.

Si l'erreur 404 s'affiche lorsque vous usurpez l'identité de l'utilisateur, mais pas lorsque vous consultez la ressource en tant qu'administrateur, il est probable que l'utilisateur ne dispose pas des autorisations ou des paramètres d'accès au contenu suffisants.

Vérifier les autorisations requises

Vérifiez les rôles de l'utilisateur dans le panneau Admin > Utilisateurs et la liste des autorisations dans Looker pour vous assurer qu'il dispose des autorisations nécessaires dans au moins l'un de ses rôles. Par exemple, pour afficher un tableau de bord, un utilisateur a besoin au moins des autorisations access data, see_looks et see_user_dashboards. Si l'utilisateur ne dispose pas des autorisations requises, ajoutez-les à un ensemble d'autorisations dans un rôle qui lui est attribué.

Si des autorisations requises sont spécifiques à un modèle, vérifiez que le modèle LookML est inclus dans l'ensemble de modèles pour au moins l'un des rôles de l'utilisateur disposant de l'autorisation requise. Sinon, ajoutez le modèle à l'ensemble de modèles de l'un des rôles attribués à l'utilisateur.

Vérifier que les autorisations d'intégration sont valides

Si l'utilisateur est un utilisateur d'intégration signée, vérifiez si l'autorisation requise est une autorisation d'intégration valide. Si ce n'est pas le cas, l'utilisateur intégré ne pourra pas effectuer la demande. Par exemple, les utilisateurs intégrés ne peuvent pas se voir attribuer l'autorisation see_lookml.

Vérifier les autorisations d'accès

Si le contenu est basé sur une exploration avec required_access_grants défini, vérifiez la définition de access_grant dans le projet LookML. Modifiez la valeur de l'attribut utilisateur de l'attribut utilisateur spécifié en lui attribuant l'une des valeurs requises dans l'autorisation d'accès.

Vérifier l'accès au contenu

Si la ressource demandée est stockée dans un dossier, vérifiez les paramètres d'accès au contenu de ce dossier. Les Looks, les tableaux de bord et les rapports Looker Studio sont tous stockés dans des dossiers.

Dernière vérification et assistance

Si l'erreur 404 persiste, suivez les étapes de dépannage décrites sur cette page. Si vous ne parvenez toujours pas à résoudre l'erreur 404, contactez l'assistance.