Soluciona problemas de la aplicación para dispositivos móviles de Looker

La aplicación para dispositivos móviles de Looker te permite acceder a tu contenido de Looker y Data Studio Pro en dispositivos iOS y Android, ver Looks y paneles, y colaborar sobre la marcha. Si tienes problemas mientras usas la aplicación para dispositivos móviles, como problemas de acceso, errores de renderización, fallas de la aplicación, demoras en el rendimiento o discrepancias en la pantalla, esta guía te ayudará a solucionarlos.

Requisitos previos y requisitos de configuración comunes

Antes de comenzar a solucionar problemas, asegúrate de que tu entorno y tu cuenta cumplan con los requisitos previos para usar la aplicación de Looker para dispositivos móviles:

  • Acceso a la aplicación para dispositivos móviles habilitado: Un administrador de Looker debe habilitar el acceso a la aplicación para dispositivos móviles para tu instancia.
  • Permisos de usuario: Tu cuenta de usuario debe tener el permiso mobile_app_access asignado directamente o a través de un grupo de usuarios.
  • Instancias compatibles: La aplicación para dispositivos móviles de Looker admite instancias de Looker (Google Cloud Core) (IP pública o IP privada con acceso privado a servicios o Private Service Connect accesible a través de una VPN corporativa) y de Looker (original) (alojado en Looker y alojado por el cliente).
  • VPN corporativa y listas de IPs permitidas: Si tu instancia de Looker aplica la lista de IPs permitidas, tu dispositivo móvil debe conectarse a través de una VPN corporativa con una dirección IP estática en la lista de IPs permitidas de la instancia.
  • Autenticación admitida: La aplicación de Looker para dispositivos móviles admite OAuth de Google, SAML, LDAP, OpenID Connect y credenciales de correo electrónico y contraseña. El acceso con códigos QR solo se admite en la aplicación de Looker Mobile (heredada) y requiere que se habilite el SSO integrado.

Árbol de depuración

Usa el siguiente árbol de decisión para comenzar a solucionar problemas de la aplicación para dispositivos móviles de Looker:

En las siguientes secciones, se describen las situaciones del árbol con más detalle.

Identificar qué aplicación para dispositivos móviles está instalada

Como tanto la aplicación para dispositivos móviles de Looker como la aplicación de Looker Mobile (heredada) están disponibles en las tiendas de aplicaciones, el primer paso para solucionar problemas es determinar qué aplicación está instalada en tu dispositivo móvil. El paso inicial de clasificación del equipo de asistencia se basa en esta distinción para evitar investigaciones retrasadas o mal dirigidas:

  • Looker: Es la aplicación unificada para dispositivos móviles actual del contenido de Looker y Data Studio Pro. En la pantalla principal del dispositivo y en las tiendas de aplicaciones, esta app se llama Looker. Admite métodos de autenticación estándar (como Google OAuth, SAML, OpenID Connect, LDAP y credenciales de correo electrónico y contraseña) y no admite el acceso con código QR. Esta guía de solución de problemas abarca principalmente esta aplicación.
  • Looker Mobile (heredada): Es la aplicación para dispositivos móviles anterior. En la pantalla principal del dispositivo y en las tiendas de aplicaciones, esta app se llama Looker Mobile (Legacy) (o Looker Mobile). Admite el acceso con código QR, correo electrónico y contraseña, pero no admite instancias de Google OAuth, SAML ni Looker (Google Cloud Core).

Para determinar qué aplicación está instalada en tu dispositivo, haz lo siguiente:

  1. Verifica el nombre de la aplicación que se muestra debajo del ícono de la app en la pantalla principal del dispositivo o en el selector de aplicaciones.
  2. En la aplicación para dispositivos móviles, selecciona Más en el menú de navegación inferior o abre Configuración y busca el nombre de la aplicación y el número de versión en la parte inferior del menú.
  3. Revisa la lista de apps instaladas en la App Store de Apple (iOS) o en Google Play Store (Android).

Si tienes instalada la versión heredada de Looker Mobile, la compatibilidad con esta aplicación finalizará el 31 de enero de 2027 y se quitará de la lista. Google recomienda enfáticamente migrar a la aplicación para dispositivos móviles de Looker actual. Para obtener documentación y solucionar problemas relacionados con la aplicación heredada, consulta la guía de la aplicación de Looker Mobile (heredada).

Si tienes instalada la aplicación para dispositivos móviles de Looker, continúa con los pasos para solucionar problemas que se indican en las siguientes secciones.

Verifica si el problema se reproduce fuera de la aplicación para dispositivos móviles

El primer paso para solucionar problemas es determinar si el problema se limita a la aplicación para dispositivos móviles o si también afecta a la aplicación web de Looker.

Abre un navegador web para computadoras o dispositivos móviles, accede a tu instancia de Looker y trata de realizar la misma acción:

  • ¿Puedes acceder a tu cuenta a través de un navegador web? Si no puedes acceder desde un navegador web, el problema no es específico de la aplicación para dispositivos móviles. Verifica tus credenciales, la configuración del proveedor de identidad (IdP) o el estado de la cuenta de usuario.
  • ¿Se cargan las consultas o los paneles en un navegador web? Si el panel o el Look no se cargan, devuelven un error de base de datos o se agota el tiempo de espera en el navegador, el problema se debe a la consulta subyacente, la conexión de la base de datos o el modelo de LookML, en lugar de la aplicación para dispositivos móviles.
  • ¿Tienes permiso para acceder al contenido? Si no puedes ver el contenido en la interfaz web, verifica que tengas los permisos de acceso adecuados a la carpeta, el modelo y la exploración.

Si el problema también se reproduce en un navegador web, soluciona el problema en tu instancia de Looker.

Si el problema solo ocurre en la aplicación para dispositivos móviles, ve a la sección correspondiente de esta guía.

Soluciona problemas de acceso

Si no puedes acceder a la aplicación de Looker para dispositivos móviles, investiga las siguientes causas comunes:

  • Formato de URL de la instancia: Cuando ingreses la URL de la instancia en la app para dispositivos móviles, usa el formato instance_name.looker.com o tu dominio personalizado. No incluyas https://, http:// ni barras finales.
  • Habilitación de la instancia: Verifica con tu administrador de Looker que el acceso a la aplicación para dispositivos móviles esté habilitado en Administrador > General > Aplicación para dispositivos móviles.
  • Permisos del usuario: Verifica con tu administrador que tu rol o grupo de usuario incluya el permiso mobile_app_access.
  • VPN corporativa y listas de entidades permitidas de IP: Si tu instancia aplica listas de entidades permitidas de IP, asegúrate de que tu dispositivo móvil esté conectado a la VPN de tu organización y de que la dirección IP estática del servidor de VPN esté en la lista de entidades permitidas de IP de la instancia. Para probar esto, abre la URL de la instancia en un navegador web en el mismo dispositivo móvil mientras estás conectado a la VPN.
  • Configuración de la API alojada por el cliente: Si usas una instancia de Looker (original) alojada por el cliente, verifica que la URL del host de la API de tu instancia en Administrador > Plataforma > API coincida con el nombre de host de tu instancia. También verifica que tu red permita el tráfico de dispositivos móviles en el puerto 443 o en el puerto 19999. Para obtener más información, consulta las páginas de documentación sobre las consideraciones para las instancias alojadas por el cliente y la solución de problemas de la API de Looker.
  • Acceso biométrico: Si falla la verificación biométrica (huella dactilar o reconocimiento facial), accede con tu nombre de usuario y contraseña estándares. Puedes volver a configurar la verificación biométrica en el menú Configuración de la app, en Seguridad. Ten en cuenta que los datos biométricos también deben estar habilitados en la configuración del sistema de tu dispositivo móvil.

Problemas de acceso con código QR

La aplicación unificada de Looker para dispositivos móviles no admite el acceso con un código QR. En su lugar, usa la autenticación estándar (OAuth de Google, SAML, LDAP, OpenID Connect o correo electrónico y contraseña).

Si usas la aplicación de Looker Mobile (legacy) y no puedes acceder con un código QR, investiga lo siguiente:

  • Autenticación de SSO incorporada: En la interfaz web de Looker, navega a Administrador > Plataforma > Incorporar y confirma que la Autenticación de SSO incorporada esté habilitada. Este parámetro de configuración habilita la opción de acceso con código QR.
  • Actualiza el código QR: Los códigos QR son sensibles al tiempo. Actualiza la página web en la que se muestra el código QR y, luego, intenta escanear el código QR recién generado.
  • Permisos de acceso a la cámara y visibilidad: Asegúrate de que la aplicación para dispositivos móviles tenga permiso de acceso a la cámara del dispositivo y de que haya suficiente iluminación cuando escanees la pantalla.
  • Acceso alternativo: Si la autenticación con código QR sigue fallando, usa las credenciales de correo electrónico y contraseña para acceder, o bien migra a la aplicación para dispositivos móviles de Looker actualizada.

Soluciona problemas de renderización de contenido

Si los paneles o los Looks no se renderizan, muestran tarjetas en blanco o muestran mensajes de error en la aplicación para dispositivos móviles, investiga lo siguiente:

  • Alcance del problema: Determina si la falla de renderización afecta a todo el contenido o solo a Looks o paneles específicos:
    • Falla todo el contenido: Revisa la conexión de red de tu dispositivo móvil, verifica que tu sesión no haya vencido y prueba salir de la aplicación y volver a acceder a ella.
    • Fallas de contenido específico: Comprueba si el contenido usa visualizaciones personalizadas o formatos de diseño no admitidos. También verifica que tengas acceso al modelo y a las Exploraciones subyacentes.
  • Inspecciona los mensajes de error: Si aparece un banner de error o un error de tarjeta, anota el mensaje específico. Entre los problemas habituales, se incluyen errores de conexión a la base de datos, tiempos de espera de consultas o referencias de campos faltantes.
  • Fallas intermitentes frente a fallas coherentes: Si el contenido falla de forma intermitente, el problema podría estar relacionado con la carga de la base de datos o las fluctuaciones temporales de la red.
  • Deslizar hacia abajo para actualizar: Usa el gesto de deslizar hacia abajo para actualizar (desliza hacia abajo en la pantalla) para volver a cargar el panel o Look y ejecutar consultas nuevas.

Soluciona problemas de fallas en la aplicación

Si la aplicación para dispositivos móviles de Looker se bloquea o se cierra de forma inesperada, sigue estos pasos para solucionar el problema:

  • Identifica los activadores de fallas: Anota cuándo se produce la falla. ¿La app falla inmediatamente después de iniciarse, cuando se abre un panel específico, cuando se rota el dispositivo entre los modos vertical y horizontal, o después de una interacción específica del usuario?
  • Actualiza la aplicación: Consulta la tienda de aplicaciones de Apple o Google Play Store para asegurarte de que estás ejecutando la versión más reciente de la app de Looker para dispositivos móviles. Las actualizaciones suelen incluir mejoras de estabilidad y correcciones de errores.
  • Actualiza el sistema operativo del dispositivo: Asegúrate de que tu dispositivo móvil ejecute una versión compatible de iOS o Android. Los sistemas operativos desactualizados pueden generar problemas de compatibilidad.
  • Borra la caché y reinicia el dispositivo:
    • Fuerza el cierre de la aplicación y vuelve a abrirla.
    • Reinicia tu dispositivo móvil.
    • En Android, borra la caché de la aplicación en Configuración > Apps > Looker > Almacenamiento > Borrar caché.
  • Reinstala la aplicación: Desinstala la app, reinicia el dispositivo y reinstala la aplicación desde la tienda de aplicaciones oficial.

Soluciona problemas de rendimiento y latencia

Si la aplicación de Looker para dispositivos móviles es lenta, no responde o tarda mucho en cargar el contenido, investiga lo siguiente:

  • Identifica el componente lento: Determina si la demora se produce cuando se inicia la app, se navega por carpetas y tableros, se cargan listas de contenido almacenado en caché o se ejecutan consultas para los paneles.
  • Almacenamiento en caché de listas: La aplicación para dispositivos móviles almacena en caché listas de contenido favorito y visto recientemente para acelerar la navegación. La lista se actualiza automáticamente cuando se inicia la app, pero puedes tirar hacia abajo para actualizarla manualmente si parece desactualizada.
  • Complejidad del panel y cantidad de tarjetas: Los paneles con muchas tarjetas o tipos de visualización complejos requieren una gran cantidad de recursos de memoria y procesamiento en los dispositivos móviles. Prueba si los paneles más pequeños o los Looks individuales se cargan más rápido.
  • Velocidad y latencia de la red: Es posible que las redes móviles experimenten alta latencia o pérdida de paquetes. Comprueba si el rendimiento mejora cuando te conectas a una red Wi-Fi confiable y de alta velocidad.
  • Rendimiento de las consultas de la base de datos: Si las tarjetas individuales tardan mucho en renderizarse, verifica la duración de la consulta en la interfaz web de Looker o en la actividad del sistema. La demora puede deberse a consultas de bases de datos de larga duración.

Soluciona problemas de visualización y diseño

Si encuentras defectos visuales, como elementos desalineados, íconos rotos, imágenes distorsionadas o relleno inesperado, investiga lo siguiente:

  • Orientación de la pantalla: Prueba el panel o el Look en orientaciones vertical y horizontal. Algunos paneles y tablas complejos están optimizados para una visualización horizontal más amplia.
  • Diseño del panel: Los paneles optimizados para dispositivos móviles ajustan dinámicamente las posiciones de las tarjetas para pantallas pequeñas. Si las tarjetas se superponen o truncan texto, verifica el tamaño y la configuración de las tarjetas en el modo de edición del panel en la aplicación web.
  • Configuración de pantalla del dispositivo: Los parámetros de configuración de accesibilidad, como los tamaños de fuente personalizados del sistema, el zoom de pantalla o las herramientas de inversión del modo oscuro de terceros, pueden alterar la forma en que se renderiza el contenido. Realiza pruebas con la configuración de pantalla predeterminada del sistema.
  • Documentación visual: Toma capturas de pantalla o grabaciones de pantalla que muestren claramente la discrepancia de renderización para compartirlas con tu administrador o el equipo de asistencia.

Recopila información de diagnóstico

Si no puedes resolver el problema después de seguir los pasos para solucionar problemas, recopila la siguiente información antes de comunicarte con el equipo de asistencia:

  1. Información de la instancia de Looker:
    • URL de la instancia (por ejemplo, instance_name.looker.com)
    • Versión de actualización de Looker (en la aplicación web, selecciona Ayuda > Acerca de).
    • Tipo de alojamiento de la instancia (alojada por Looker o por el cliente; Looker (Google Cloud Core) o Looker (original)).
  2. Información de la aplicación para dispositivos móviles:
    • Qué app está instalada: Especifica si instalaste la app de Looker para dispositivos móviles o Looker Mobile (heredada).
    • Número de versión de la aplicación (se encuentra en la parte inferior del menú Más de la app o en Configuración)
    • Es la tienda de aplicaciones desde la que se instaló la aplicación (App Store de Apple o Google Play Store).
  3. Detalles del dispositivo y del sistema operativo:
    • Fabricante y modelo del dispositivo (por ejemplo, Google Pixel 8 o iPhone 15 Pro)
    • Versión del sistema operativo (por ejemplo, Android 14 o iOS 17.5)
  4. Alcance e impacto:
    • ¿El problema afecta a todos los usuarios o solo a cuentas de usuario específicas?
    • ¿El problema ocurre en todos los dispositivos móviles o solo en modelos de dispositivos o versiones de sistemas operativos específicos?
  5. Ejemplos visuales y registros:
    • Capturas o grabaciones de pantalla que muestren el comportamiento inesperado o el mensaje de error
    • Pasos exactos para reproducir el problema

Comunicarse con el equipo de asistencia

Si verificaste todos los pasos anteriores y el problema aún no se resuelve, haz lo siguiente: