En esta guía, se explica cómo solucionar un error 404 en una página web de Looker o en una solicitud a la API de Looker. Por lo general, un error 404 significa que el recurso solicitado no existe o que el usuario no tiene permiso para acceder a él.
Árbol de depuración
Utiliza el siguiente árbol de decisión para comenzar a solucionar un error 404:
En las siguientes secciones, se describen las situaciones del árbol con más detalle.
Cómo solucionar un error 404 en el navegador
Si el error 404 aparece en una página web en un navegador, sigue los pasos que se indican en esta sección. De lo contrario, consulta la sección Error de API.
Verifica la consola de JavaScript
Primero, consulta la Consola de JavaScript en 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 para desarrolladores.
- 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 se origina en 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 relacionados con recursos externos es limitada.
Si la URL es de Looker, continúa con la siguiente sección.
Verifica que la URL no tenga errores tipográficos
Verifica si hay errores de escritura comunes en la URL. Por ejemplo:
- Un error de escritura común para una página de Look es
/look/123
. La sintaxis correcta es/looks/123
. - Un error de escritura común para una página del panel es
/dashboard/123
. La sintaxis correcta es/dashboards/123
.
Cuando incluyas un vínculo a un Explorar, un Look o un panel en tu LookML, siempre prueba el vínculo primero para asegurarte de que la sintaxis sea correcta.
Si encuentras un error de escritura en un vínculo que se generó a partir de tu código LookML, corrígelo en tu código LookML. Si encuentras un error tipográfico en una URL que generó Looker (por ejemplo, en un elemento de navegación de la IU), comunícate con el equipo de asistencia para solicitar que se corrija la URL en el producto.
Soluciona un error 404 en la API
Si el error aparece como respuesta a una llamada a la API de Looker, sigue los pasos que se indican en esta sección.
Revisa la documentación del extremo de API
Busca la documentación del extremo de API que devuelve el error 404. Por ejemplo, la página de documentación del endpoint create_sso_embed_url
es Crea una URL de incorporación firmada. Verifica los parámetros y asegúrate de proporcionar los correctos a la llamada a la API.
Asegúrate de que el verbo y la ruta de la solicitud sean correctos. Por ejemplo, el extremo /api/4.0/embed/sso_url
se debe usar con el verbo POST
.
También puedes probar el extremo de API directamente en tu instancia con el Explorador de API.
Verifica las condiciones requeridas del extremo
Algunos extremos solo están disponibles en determinadas condiciones:
- Algunos extremos de proyectos de LookML (como
create_project
,deploy_to_production
yreset_project_to_production
) solo están disponibles en el modo de desarrollo.- Si es necesario, usa el extremo
update_session
con el cuerpo de la solicitud{"workspace_id": "dev"}
para cambiar tu sesión de la API al modo de desarrollo.
- Si es necesario, usa el extremo
- El extremo
reset_project_to_production
no está disponible en las ramas compartidas. - El extremo
deploy_ref_to_production
solo está disponible cuando se habilita el Modo de implementación avanzado.
Verifica la configuración del webhook
Si la URL de solicitud es un webhook de implementación, verifica la configuración del webhook.
Si usas el webhook para implementar una rama o referencia específica, 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.
Verifica si existen los recursos solicitados
Confirma que todos los recursos a los que se hace referencia en la solicitud existan en tu instancia de Looker.
Verifica que todos los valores de la URL y el cuerpo de la solicitud (como los IDs de carpetas o de paneles) hagan referencia a recursos válidos y existentes. Por ejemplo, para verificar si existe un panel, navega a /dashboards/[id]
como usuario administrador. Si falta un recurso o no es válido, crea el recurso faltante o especifica uno existente.
Si el recurso existe, pero sigues recibiendo un error 404, verifica si el recurso existe en el modo de desarrollo. Si el usuario de Looker tiene el permiso develop
, verifica si puede acceder al recurso cuando ingresa al modo de desarrollo. Para las llamadas a la API, usa el extremo 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 de develop
, intenta implementar el proyecto de LookML en producción y, luego, verifica si puede acceder a él.
Verifica los permisos de los usuarios y la configuración de acceso al contenido
Si los recursos existen, pero el usuario sigue recibiendo un error 404, verifica los permisos del usuario y el acceso al contenido.
Suplantar la identidad del usuario y verificar si hay errores
Si eres administrador, navega al panel Administrador > Usuarios y suplanta (sudo) al usuario que experimenta el error 404.
- Si el usuario es un usuario integrado, verifica que su credencial integrada en la página Administrador > Usuarios coincida con el
external_user_id
en la URL de acceso integrado. - Si el usuario realiza una llamada a la API, usa el extremo
login_user
para suplantar su identidad.
Si el error 404 aparece cuando suplantas al usuario, pero no cuando ves el recurso como administrador, es probable que el usuario no tenga permisos suficientes o la configuración de acceso al contenido adecuada.
Verifica los permisos necesarios
Verifica los roles del usuario en el panel Administrador > Usuarios y la lista de permisos en Looker para asegurarte de que el usuario tenga los permisos necesarios en al menos uno de sus roles. Por ejemplo, para ver un panel, un usuario necesita al menos los permisos access data
, see_looks
y see_user_dashboards
. Si el usuario no tiene los permisos necesarios, agrégalos a un conjunto de permisos en un rol que se le asigne a ese usuario.
Si algún permiso requerido es específico del modelo, verifica que el modelo de LookML se incluya en el conjunto de modelos para al menos uno de los roles del usuario con el permiso requerido. De lo contrario, agrega el modelo al conjunto de modelos de uno de los roles asignados al usuario.
Verifica si hay permisos de incorporación válidos
Si el usuario es un usuario de incorporación firmado, verifica si el permiso requerido es un permiso de incorporación válido. De lo contrario, el usuario incorporado no podrá realizar la solicitud correctamente. Por ejemplo, a los usuarios incorporados no se les puede asignar el permiso see_lookml
.
Verifica los otorgamientos de acceso
Si el contenido se basa en una exploración con required_access_grants
definido, verifica la definición de access_grant
en el proyecto de LookML. Edita el valor del atributo del usuario para el atributo de usuario especificado y asígnale uno de los valores requeridos en el otorgamiento de acceso.
Verifica el acceso al contenido
Si el recurso solicitado se almacena en una carpeta, verifica la configuración de acceso al contenido de esa carpeta. Las vistas, los paneles y los informes de Looker Studio se almacenan en carpetas.
Revisión final y asistencia
Si el error 404 persiste, revisa los pasos para solucionar el problema que se indican en esta página. Si aún no puedes resolver el error 404, comunícate con el equipo de asistencia al cliente.