Esta guía le ayudará a solucionar un error 404 en una página web de Looker o en una solicitud de la API de Looker. Un error 404 suele significar que el recurso solicitado no existe o que el usuario no tiene permiso para acceder a él.
Árbol de depuración
Sigue este esquema para empezar a solucionar un error 404:
En las siguientes secciones se describen los escenarios del árbol con más detalle.
Solucionar un error 404 en el navegador
Si el error 404 aparece en una página web de un navegador, sigue los pasos que se indican en esta sección. De lo contrario, consulta la sección Error de API.
Consultar la consola de JavaScript
En primer lugar, consulta la consola de JavaScript de tu navegador para obtener más información sobre el error. Para abrir la consola de JavaScript en Google Chrome, sigue estos pasos:
- Haz clic en el menú de tres puntos Más.
- Selecciona Más herramientas.
- Haz clic en Herramientas de desarrollo.
- Haz clic en la pestaña Consola.
Busca el error 404 en la lista de errores y encuentra la URL correspondiente.
Si la URL que devuelve un error 404 no es una URL de Looker, el error procede de un recurso externo. Si la URL de la solicitud pertenece a una aplicación personalizada que se conecta a Looker, examina el código y los registros de la aplicación para solucionar el error. La asistencia de Looker para problemas de recursos externos es limitada.
Si la URL es de Looker, ve a la siguiente sección.
Comprueba que la URL no tenga errores tipográficos
Comprueba que la URL no tenga errores ortográficos habituales. Por ejemplo:
- Un error tipográfico habitual en una página de Look es
/look/123. La sintaxis correcta es/looks/123. - Un error tipográfico habitual en una página del panel de control es
/dashboard/123. La sintaxis correcta es/dashboards/123.
Cuando incluyas un enlace a un Exploración, una vista o un panel de control en tu LookML, siempre debes probar el enlace primero para asegurarte de que la sintaxis sea correcta.
Si detecta un error tipográfico en un enlace que se ha generado a partir de su LookML, corríjalo en su LookML. Si detecta un error tipográfico en una URL generada por Looker (por ejemplo, en un elemento de navegación de la interfaz de usuario), póngase en contacto con el equipo de Asistencia para solicitar que se corrija la URL en el producto.
Solucionar un error 404 en la API
Si el error aparece como respuesta a una llamada a la API de Looker, sigue los pasos de esta sección.
Consulta la documentación del endpoint de la API
Busca la documentación del endpoint de la API que devuelve el error 404. Por ejemplo, la página de documentación del endpoint create_sso_embed_url es Crear URL de inserción firmada. Comprueba los parámetros y asegúrate de que estás proporcionando los correctos en la llamada a la API.
Asegúrate de que el verbo y la ruta de la solicitud sean correctos. Por ejemplo, el endpoint /api/4.0/embed/sso_url debe usarse con el verbo POST.
También puedes probar el endpoint de la API directamente en tu instancia mediante el Explorador de APIs.
Comprobar las condiciones de endpoint necesarias
Algunos endpoints solo están disponibles en determinadas condiciones:
- Algunos endpoints de proyectos de LookML (como
create_project,deploy_to_productionyreset_project_to_production) solo están disponibles en el modo de desarrollo.- Si es necesario, usa el endpoint
update_sessioncon el cuerpo de la solicitud{"workspace_id": "dev"}para cambiar tu sesión de API al modo de desarrollo.
- Si es necesario, usa el endpoint
- El endpoint
reset_project_to_productionno está disponible en las ramas compartidas. - El endpoint
deploy_ref_to_productionsolo está disponible cuando se habilita el modo de implementación avanzado.
Comprobar la configuración de webhook
Si la URL de la solicitud es un webhook de implementación, comprueba la configuración del webhook.
Si usas el webhook para implementar una rama o una referencia específicas, habilita el modo de implementación avanzada en el proyecto.
Si hay un secreto de implementación de webhook habilitado en el proyecto, asegúrate de incluirlo en la solicitud.
Comprobar si existen los recursos solicitados
Confirma que todos los recursos a los que se hace referencia en la solicitud existen en tu instancia de Looker.
Comprueba que todos los valores de la URL de la solicitud y del cuerpo (como los IDs de carpetas o de paneles de control) hagan referencia a recursos válidos. Por ejemplo, para comprobar si existe un panel de control, vaya a /dashboards/[id] como usuario administrador. Si falta un recurso o no es válido, créalo o especifica uno que ya tengas.
Si el recurso existe, pero sigues recibiendo un error 404, comprueba si el recurso existe en el modo de desarrollo. Si el usuario de Looker tiene el permiso develop, comprueba si puede acceder al recurso cuando active el modo Desarrollo. En el caso de las llamadas a la API, utiliza el endpoint update_session con el cuerpo de la solicitud {"workspace_id": "dev"} para cambiar tu sesión de la API al modo de desarrollo.
Si el usuario no tiene permiso develop, prueba a implementar el proyecto de LookML en producción y, a continuación, comprueba si puede acceder a él.
Comprobar los permisos de usuario y los ajustes de acceso al contenido
Si los recursos existen, pero el usuario sigue recibiendo un error 404, comprueba los permisos del usuario y el acceso al contenido.
Representa al usuario y comprueba si se produce el error
Si eres administrador, ve al panel Administración > Usuarios y suplanta la identidad (sudo) del usuario que recibe el error 404.
- Si el usuario es un usuario insertado, comprueba que su credencial de inserción en la página Administrar > Usuarios coincida con el
external_user_idde la URL de inicio de sesión insertada. - Si el usuario está haciendo una llamada a la API, usa el endpoint
login_userpara suplantar su identidad.
Si el error 404 aparece cuando te haces pasar por el usuario, pero no cuando ves el recurso como administrador, es probable que el usuario no tenga permisos suficientes o que la configuración de acceso al contenido sea incorrecta.
Comprobar los permisos necesarios
Compruebe los roles del usuario en el panel Administrar > Usuarios y la lista de permisos de Looker para asegurarse de que el usuario tiene los permisos necesarios en al menos uno de sus roles. Por ejemplo, para ver un panel de control, un usuario necesita al menos los permisos access data, see_looks y see_user_dashboards. Si el usuario no tiene los permisos necesarios, añádelos a un conjunto de permisos en un rol asignado a ese usuario.
Si algún permiso obligatorio es específico de un modelo, compruebe que el modelo LookML esté incluido en el conjunto de modelos de al menos uno de los roles del usuario que tenga el permiso obligatorio. Si no es así, añade el modelo al conjunto de modelos de uno de los roles asignados al usuario.
Comprobar si hay permisos de inserción válidos
Si el usuario es un usuario de inserción firmado, comprueba si el permiso necesario es un permiso de inserción válido. Si no es así, el usuario insertado no podrá hacer la solicitud correctamente. Por ejemplo, a los usuarios insertados no se les puede asignar el permiso see_lookml.
Comprobar las concesiones de acceso
Si el contenido se basa en una Exploración con required_access_grants definido, comprueba la definición de access_grant en el proyecto de LookML. Edita el valor del atributo de usuario del atributo de usuario especificado y asigna uno de los valores obligatorios de la concesión de acceso.
Comprobar el acceso al contenido
Si el recurso solicitado está almacenado en una carpeta, comprueba los ajustes de acceso al contenido de esa carpeta. Los Looks, los paneles de control y los informes de Looker Studio se almacenan en carpetas.
Revisión final y asistencia
Si el error 404 sigue produciéndose, consulta los pasos para solucionar problemas que se indican en esta página. Si sigues sin poder resolver el error 404, ponte en contacto con el equipo de Asistencia.