Résoudre les problèmes liés à l'application mobile Looker

L'application mobile Looker vous permet d'accéder à vos contenus Looker et Data Studio Pro sur les appareils Android et iOS, d'afficher des Looks et des tableaux de bord, et de collaborer en déplacement. Si vous rencontrez des problèmes lors de l'utilisation de l'application mobile (problèmes de connexion, erreurs de rendu, plantages de l'application, ralentissements des performances ou différences d'affichage, par exemple), ce guide vous aidera à les résoudre.

Conditions préalables et exigences de configuration courantes

Avant de commencer à résoudre les problèmes, assurez-vous que votre environnement et votre compte remplissent les conditions préalables pour utiliser l'application mobile Looker :

  • Accès à l'application mobile activé : un administrateur Looker doit activer l'accès à l'application mobile pour votre instance.
  • Autorisations utilisateur : votre compte utilisateur doit disposer de l'autorisation Looker mobile_app_access, qui doit lui être attribuée directement ou par le biais d'un groupe d'utilisateurs.
  • Instances compatibles : l'application mobile Looker est compatible avec les instances Looker (Google Cloud Core) (adresse IP publique ou adresse IP privée utilisant l'accès aux services privés ou Private Service Connect accessible via un VPN d'entreprise) et les instances Looker (original) (hébergées par Looker et hébergées par le client).
  • VPN d'entreprise et listes d'autorisation d'adresses IP : si votre instance Looker applique une liste d'autorisation d'adresses IP, votre appareil mobile doit se connecter via un VPN d'entreprise avec une adresse IP statique sur la liste d'autorisation d'adresses IP de l'instance.
  • Authentification acceptée : l'application mobile Looker accepte les identifiants Google OAuth, SAML, LDAP, OpenID Connect, ainsi que les identifiants d'adresse e-mail et de mot de passe. La connexion avec des codes QR n'est compatible qu'avec l'ancienne application mobile Looker et nécessite que l'authentification unique intégrée soit activée.

Arborescence de débogage

Utilisez l'arbre de décision suivant pour commencer à résoudre les problèmes liés à l'application mobile Looker :

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

Identifier l'application mobile installée

Étant donné que l'application mobile Looker et l'application Looker Mobile (Legacy) sont disponibles dans les app stores, la première étape de dépannage consiste à déterminer quelle application est installée sur votre appareil mobile. L'étape de triage initiale de l'assistance repose sur cette distinction pour éviter les enquêtes mal orientées ou retardées :

  • Looker : application mobile unifiée actuelle pour les contenus Looker et Data Studio Pro. Sur l'écran d'accueil de votre appareil et dans les plates-formes de téléchargement d'applications, cette application est nommée Looker. Il est compatible avec les méthodes d'authentification standards (telles que Google OAuth, SAML, OpenID Connect, LDAP, et les identifiants d'adresse e-mail et de mot de passe), mais pas avec la connexion par code QR. Ce guide de dépannage concerne principalement cette application.
  • Looker Mobile (ancienne version) : l'ancienne application mobile. Sur l'écran d'accueil de votre appareil et dans les plates-formes de téléchargement d'applications, cette application est nommée Looker Mobile (ancienne version) (ou Looker Mobile). Il est compatible avec la connexion par code QR, ainsi que par adresse e-mail et mot de passe, mais pas avec les instances Google OAuth, SAML ni Looker (Google Cloud Core).

Pour savoir quelle application est installée sur votre appareil :

  1. Vérifiez le nom de l'application affiché sous l'icône de l'application sur l'écran d'accueil de votre appareil ou dans le lanceur d'applications.
  2. Dans l'application mobile, sélectionnez Plus dans le menu de navigation en bas de l'écran ou ouvrez Paramètres, puis recherchez le nom de l'application et le numéro de version en bas du menu.
  3. Consultez la liste des applications installées sur l'App Store d'Apple (iOS) ou le Google Play Store (Android).

Si vous avez installé Looker Mobile (ancienne version), sachez que cette application ne sera plus prise en charge à partir du 31 janvier 2027 et qu'elle sera supprimée. Google vous recommande vivement de migrer vers la version actuelle de l'application mobile Looker. Pour obtenir de la documentation et des informations sur le dépannage de l'ancienne application, consultez le guide de l'ancienne application mobile Looker.

Si l'application mobile Looker est installée, suivez les étapes de dépannage décrites dans les sections suivantes.

Vérifiez si le problème se reproduit en dehors de l'application mobile.

La première étape du dépannage consiste à déterminer si le problème est isolé à l'application mobile ou s'il affecte également l'application Web Looker.

Ouvrez un navigateur Web pour ordinateur ou mobile, connectez-vous à votre instance Looker et essayez d'effectuer la même action :

  • Pouvez-vous vous connecter à l'aide d'un navigateur Web ? Si vous ne parvenez pas à vous connecter depuis un navigateur Web, le problème n'est pas spécifique à l'application mobile. Vérifiez vos identifiants, la configuration de votre fournisseur d'identité (IdP) ou l'état de votre compte utilisateur.
  • Les requêtes ou les tableaux de bord se chargent-ils dans un navigateur Web ? Si le tableau de bord ou le Look ne se chargent pas, renvoient une erreur de base de données ou expirent dans le navigateur, le problème provient de la requête sous-jacente, de la connexion à la base de données ou du modèle LookML, et non de l'application mobile.
  • Avez-vous l'autorisation d'accéder au contenu ? Si vous ne parvenez pas à afficher le contenu dans l'interface Web, vérifiez que vous disposez des autorisations d'accès appropriées pour le dossier, le modèle et l'exploration.

Si le problème se reproduit également dans un navigateur Web, résolvez-le sur votre instance Looker.

Si le problème ne se produit que dans l'application mobile, passez à la section correspondante de ce guide.

Résoudre les problèmes de connexion

Si vous ne parvenez pas à vous connecter à l'application mobile Looker, examinez les causes courantes suivantes :

  • Format de l'URL de l'instance : lorsque vous saisissez l'URL de votre instance dans l'application mobile, utilisez le format instance_name.looker.com ou votre domaine personnalisé. N'incluez pas https://, http:// ni de barre oblique à la fin.
  • Activation de l'instance : vérifiez auprès de votre administrateur Looker que l'accès à l'application mobile est activé sous Admin > Général > Application mobile.
  • Autorisations utilisateur : vérifiez auprès de votre administrateur que votre rôle ou groupe d'utilisateur inclut l'autorisation mobile_app_access.
  • VPN d'entreprise et listes d'autorisation d'adresses IP : si votre instance applique des listes d'autorisation d'adresses IP, assurez-vous que votre appareil mobile est connecté au VPN de votre organisation et que l'adresse IP statique du serveur VPN figure dans la liste d'autorisation d'adresses IP de l'instance. Pour tester cela, ouvrez l'URL de l'instance dans un navigateur Web sur le même appareil mobile lorsque vous êtes connecté au VPN.
  • Configuration de l'API hébergée par le client : si vous utilisez une instance Looker (Original) hébergée par le client, vérifiez que l'URL de l'hôte de l'API de votre instance sous Admin > Plate-forme > API correspond au nom d'hôte de votre instance. Vérifiez également que votre réseau autorise le trafic issu des mobiles sur le port 443 ou le port 19999. Pour en savoir plus, consultez les pages de documentation Considérations pour les instances hébergées par le client et Dépannage de l'API Looker.
  • Connexion biométrique : si la validation biométrique (empreinte digitale ou reconnaissance faciale) échoue, connectez-vous à l'aide de votre nom d'utilisateur et de votre mot de passe habituels. Vous pouvez reconfigurer la validation biométrique dans le menu Paramètres de l'application, sous Sécurité. Notez que les données biométriques doivent également être activées dans les paramètres système de votre appareil mobile.

Problèmes de connexion par code QR

L'application mobile Looker unifiée ne permet pas de se connecter avec un code QR. Utilisez plutôt l'authentification standard (Google OAuth, SAML, LDAP, OpenID Connect, ou e-mail et mot de passe).

Si vous utilisez l'ancienne application mobile Looker et que vous ne parvenez pas à vous connecter avec un code QR, vérifiez les points suivants :

  • Authentification unique pour l'intégration : dans l'interface Web Looker, accédez à Admin > Plate-forme > Intégrer et vérifiez que l'option Authentification unique pour l'intégration est activée. Ce paramètre active l'option de connexion par code QR.
  • Actualisez le code QR : les codes QR sont sensibles au temps. Actualisez la page Web affichant le QR code, puis réessayez de scanner le nouveau QR code généré.
  • Autorisations d'accès à l'appareil photo et visibilité : assurez-vous que l'application mobile est autorisée à accéder à l'appareil photo de votre appareil et que l'éclairage est suffisant lorsque vous scannez l'écran.
  • Autre méthode de connexion : si l'authentification par QR code continue d'échouer, utilisez des identifiants (adresse e-mail et mot de passe) pour vous connecter, ou migrez vers la version mise à jour de l'application mobile Looker.

Résoudre les problèmes d'affichage du contenu

Si les tableaux de bord ou les Looks ne s'affichent pas, présentent des fiches vides ou affichent des messages d'erreur dans l'application mobile, examinez les points suivants :

  • Étendue du problème : déterminez si l'échec du rendu affecte l'ensemble du contenu ou uniquement certains Looks ou tableaux de bord :
    • Tous les contenus échouent : vérifiez la connexion réseau de votre appareil mobile, assurez-vous que votre session n'a pas expiré, puis essayez de vous déconnecter et de vous reconnecter à l'application.
    • Échec d'un contenu spécifique : vérifiez si le contenu utilise des visualisations personnalisées ou des formats de mise en page non compatibles. Vérifiez également que vous avez accès au modèle et aux explorations sous-jacents.
  • Examinez les messages d'erreur : si une bannière ou une vignette d'erreur s'affiche, notez le message spécifique. Il peut s'agir, par exemple, d'erreurs de connexion à la base de données, de délais d'expiration des requêtes ou de références de champs manquantes.
  • Échecs intermittents ou constants : si le contenu échoue de manière intermittente, le problème peut être lié à la charge de la base de données ou à des fluctuations temporaires du réseau.
  • Tirer pour actualiser : utilisez le geste "Tirer pour actualiser" (faites glisser l'écran vers le bas) pour recharger le tableau de bord ou le Look, et exécuter de nouvelles requêtes.

Résoudre les problèmes de plantage d'applications

Si l'application mobile Looker plante ou se ferme de manière inattendue, suivez ces étapes de dépannage :

  • Identifiez les déclencheurs de plantage : notez quand le plantage se produit. L'application plante-t-elle immédiatement au lancement, lors de l'ouverture d'un tableau de bord spécifique, lors de la rotation de l'appareil entre les modes Portrait et Paysage, ou après une interaction utilisateur spécifique ?
  • Mettez à jour l'application : vérifiez sur l'App Store d'Apple ou le Google Play Store que vous utilisez la dernière version de l'application mobile Looker. Les mises à jour incluent souvent des améliorations de la stabilité et des corrections de bugs.
  • Mettez à jour le système d'exploitation de votre appareil : assurez-vous que votre appareil mobile exécute une version compatible d'iOS ou d'Android. Les systèmes d'exploitation obsolètes peuvent entraîner des problèmes de compatibilité.
  • Videz le cache et redémarrez :
    • Forcez la fermeture de l'application, puis rouvrez-la.
    • Redémarrez votre appareil mobile.
    • Sur Android, videz le cache de l'application sous Paramètres > Applications > Looker > Stockage > Vider le cache.
  • Réinstallez l'application : désinstallez l'application, redémarrez l'appareil, puis réinstallez l'application depuis le magasin d'applications officiel.

Résoudre les problèmes de performances et de latence

Si l'application mobile Looker est lente, ne répond pas ou met beaucoup de temps à charger le contenu, examinez les points suivants :

  • Identifiez le composant lent : déterminez si le délai se produit lors du lancement de l'application, de la navigation dans les dossiers et les tableaux, du chargement des listes de contenu mises en cache ou de l'exécution des requêtes pour les tuiles de tableau de bord.
  • Mise en cache des listes : l'application mobile met en cache les listes de contenus récemment consultés et favoris pour accélérer la navigation. La liste s'actualise automatiquement au lancement de l'application, mais vous pouvez la faire glisser vers le bas pour l'actualiser manuellement si elle semble obsolète.
  • Complexité du tableau de bord et nombre de tuiles : les tableaux de bord comportant de nombreuses tuiles ou des types de visualisation complexes nécessitent des ressources de mémoire et de traitement importantes sur les appareils mobiles. Testez si les tableaux de bord plus petits ou les Looks individuels se chargent plus rapidement.
  • Débit et latence du réseau : les réseaux mobiles peuvent présenter une latence élevée ou une perte de paquets. Vérifiez si les performances s'améliorent lorsque vous êtes connecté à un réseau Wi-Fi fiable et à haut débit.
  • Performances des requêtes de base de données : si l'affichage de certaines tuiles prend beaucoup de temps, vérifiez la durée des requêtes dans l'interface Web Looker ou dans l'activité du système. Ce délai peut être dû à des requêtes de longue durée dans la base de données.

Résoudre les problèmes d'affichage et de style

Si vous rencontrez des défauts visuels (éléments mal alignés, icônes cassées, images déformées ou marge intérieure inattendue, par exemple), vérifiez les points suivants :

  • Orientation de l'écran : testez le tableau de bord ou le Look en mode portrait et paysage. Certains tableaux de bord et tableaux complexes sont optimisés pour une vue paysage plus large.
  • Mise en page du tableau de bord : les tableaux de bord adaptés aux mobiles ajustent dynamiquement la position des tuiles pour les petits écrans. Si les tuiles se chevauchent ou tronquent le texte, vérifiez la taille et la configuration des tuiles dans le mode Édition du tableau de bord de l'application Web.
  • Paramètres d'affichage de l'appareil : les paramètres d'accessibilité tels que les tailles de police système personnalisées, le zoom d'affichage ou les outils d'inversion du mode sombre tiers peuvent modifier la façon dont le contenu est affiché. Testez avec les paramètres d'affichage système par défaut.
  • Documentation visuelle : prenez des captures d'écran ou enregistrez votre écran pour montrer clairement la différence de rendu et partagez-la avec votre administrateur ou l'assistance.

Recueillir des informations de diagnostic

Si vous ne parvenez pas à résoudre le problème après avoir suivi les étapes de dépannage, rassemblez les informations suivantes avant de contacter l'assistance :

  1. Informations sur l'instance Looker :
    • URL de l'instance (par exemple, instance_name.looker.com).
    • Version de Looker (dans l'application Web, sélectionnez Aide > À propos).
    • Type d'hébergement de l'instance (hébergée par Looker ou par le client ; Looker (Google Cloud Core) ou Looker (version initiale)).
  2. Informations sur l'application mobile :
    • Application installée : indiquez si vous avez installé l'application mobile Looker ou Looker Mobile (ancienne version).
    • Numéro de version de l'application (en bas du menu Plus ou dans Paramètres de l'application).
    • Magasin d'applications depuis lequel l'application a été installée (App Store d'Apple ou Google Play Store).
  3. Informations sur l'appareil et le système d'exploitation :
    • Fabricant et modèle de l'appareil (par exemple, Google Pixel 8, iPhone 15 Pro).
    • Version du système d'exploitation (par exemple, Android 14, iOS 17.5)
  4. Champ d'application et impact :
    • Le problème affecte-t-il tous les utilisateurs ou uniquement certains comptes utilisateur ?
    • Le problème se produit-il sur tous les appareils mobiles ou uniquement sur certains modèles d'appareils ou certaines versions du système d'exploitation ?
  5. Exemples visuels et journaux :
    • Captures ou enregistrements d'écran montrant le comportement inattendu ou le message d'erreur.
    • Les étapes exactes à suivre pour reproduire le problème.

Contacter l'assistance

Si vous avez vérifié toutes les étapes précédentes et que le problème n'est toujours pas résolu :