Risoluzione dei problemi relativi all'applicazione mobile Looker

L'applicazione mobile Looker ti consente di accedere ai contenuti di Looker e Data Studio Pro su dispositivi Android e iOS, visualizzare Look e dashboard e collaborare ovunque ti trovi. Se riscontri problemi durante l'utilizzo dell'applicazione mobile, ad esempio problemi di accesso, errori di rendering, arresti anomali dell'applicazione, ritardi nelle prestazioni o discrepanze di visualizzazione, questa guida ti aiuta a risolverli.

Prerequisiti e requisiti di configurazione comuni

Prima di iniziare la risoluzione dei problemi, assicurati che il tuo ambiente e il tuo account soddisfino i prerequisiti per l'utilizzo dell'applicazione mobile Looker:

  • Accesso all'applicazione mobile abilitato:un amministratore di Looker deve abilitare l'accesso all'applicazione mobile per la tua istanza.
  • Autorizzazioni utente:al tuo account utente deve essere assegnata l'autorizzazione Looker mobile_app_access direttamente o tramite un gruppo di utenti.
  • Istanze supportate:l'applicazione mobile Looker supporta le istanze di Looker (Google Cloud core) (IP pubblico o IP privato utilizzando l'accesso ai servizi privati o Private Service Connect accessibile tramite una VPN aziendale) e le istanze di Looker (originale) (ospitate da Looker e ospitate dal cliente).
  • VPN aziendale e liste consentite di IP:se la tua istanza di Looker applica liste consentite di IP, il tuo dispositivo mobile deve connettersi tramite una VPN aziendale con un indirizzo IP statico nella lista consentita di IP dell'istanza.
  • Autenticazione supportata:l'applicazione mobile Looker supporta le credenziali Google OAuth, SAML, LDAP, OpenID Connect ed email e password. L'accesso con codici QR è supportato solo nell'applicazione Looker Mobile (legacy) e richiede l'attivazione dell'SSO incorporato.

Albero di debug

Utilizza il seguente albero decisionale per iniziare a risolvere i problemi dell'applicazione mobile Looker:

Le sezioni seguenti descrivono gli scenari nell'albero in modo più dettagliato.

Identificare l'applicazione mobile installata

Poiché sia l'applicazione mobile Looker sia l'applicazione Looker Mobile (legacy) sono disponibili negli app store, il primo passaggio per la risoluzione dei problemi consiste nel determinare quale applicazione è installata sul tuo dispositivo mobile. Il passaggio iniziale di triage dell'assistenza si basa su questa distinzione per evitare indagini errate o ritardate:

  • Looker:l'attuale applicazione mobile unificata per i contenuti di Looker e Data Studio Pro. Nella schermata Home e negli store delle app, questa app si chiama Looker. Supporta metodi di autenticazione standard (come Google OAuth, SAML, OpenID Connect, LDAP e credenziali email e password) e non supporta l'accesso con codice QR. Questa guida alla risoluzione dei problemi riguarda principalmente questa applicazione.
  • Looker Mobile (legacy): l'applicazione mobile precedente. Nella schermata Home del dispositivo e negli app store, questa app si chiama Looker Mobile (Legacy) (o Looker Mobile). Supporta l'accesso con codice QR ed email e password, ma non supporta Google OAuth, SAML o istanze di Looker (Google Cloud core).

Per determinare quale applicazione è installata sul tuo dispositivo:

  1. Controlla il nome dell'applicazione visualizzato sotto l'icona dell'app nella schermata Home del dispositivo o nell'avvio app.
  2. Nell'applicazione mobile, seleziona Altro nel menu di navigazione in basso oppure apri Impostazioni e individua il nome dell'applicazione e il numero di versione nella parte inferiore del menu.
  3. Controlla l'elenco delle app installate nell'Apple App Store (iOS) o nel Google Play Store (Android).

Se hai installato Looker Mobile (legacy), il supporto per questa applicazione termina il 31 gennaio 2027 e l'applicazione verrà rimossa. Google consiglia vivamente di eseguire la migrazione all'applicazione mobile Looker attuale. Per la documentazione e la risoluzione dei problemi relativi all'applicazione precedente, consulta la guida Applicazione mobile Looker (legacy).

Se hai installato l'applicazione mobile Looker, procedi con i passaggi per la risoluzione dei problemi nelle sezioni seguenti.

Verifica se il problema si riproduce al di fuori dell'applicazione mobile

Il primo passaggio per la risoluzione dei problemi consiste nel determinare se il problema è isolato nell'applicazione mobile o se interessa anche l'applicazione web Looker.

Apri un browser web mobile o desktop, accedi alla tua istanza di Looker e prova a eseguire la stessa azione:

  • Riesci ad accedere tramite un browser web? Se non riesci ad accedere da un browser web, il problema non riguarda l'applicazione mobile. Controlla le tue credenziali, la configurazione del provider di identità (IdP) o lo stato dell'account utente.
  • Le query o le dashboard vengono caricate in un browser web? Se il caricamento della dashboard o del look non va a buon fine, viene restituito un errore del database o si verifica un timeout nel browser, il problema deriva dalla query sottostante, dalla connessione al database o dal modello LookML anziché dall'applicazione mobile.
  • Hai l'autorizzazione per accedere ai contenuti? Se non riesci a visualizzare i contenuti nell'interfaccia web, verifica di disporre delle autorizzazioni di accesso appropriate per cartelle, modelli ed esplorazioni.

Se il problema si ripresenta anche in un browser web, risolvilo nell'istanza di Looker.

Se il problema si verifica solo nell'applicazione mobile, vai alla sezione pertinente di questa guida.

Risolvere i problemi di accesso

Se non riesci ad accedere all'applicazione mobile Looker, esamina le seguenti cause comuni:

  • Formato dell'URL dell'istanza:quando inserisci l'URL dell'istanza nell'app mobile, utilizza il formato instance_name.looker.com o il tuo dominio personalizzato. Non includere https://, http:// o barre finali.
  • Attivazione dell'istanza: verifica con l'amministratore di Looker che l'accesso all'applicazione mobile sia attivato in Amministrazione > Generale > Applicazione mobile.
  • Autorizzazioni utente:verifica con l'amministratore che il tuo ruolo utente o gruppo includa l'autorizzazione mobile_app_access.
  • VPN aziendale e liste consentite di IP:se la tua istanza applica liste consentite di IP, assicurati che il tuo dispositivo mobile sia connesso alla VPN della tua organizzazione e che l'indirizzo IP statico del server VPN sia presente nella lista consentita di IP dell'istanza. Per verificare, apri l'URL dell'istanza in un browser web sullo stesso dispositivo mobile mentre è connesso alla VPN.
  • Configurazione API ospitata dal cliente:se utilizzi un'istanza di Looker (originale) ospitata dal cliente, verifica che l'URL dell'API host in Amministrazione > Piattaforma > API corrisponda al nome host dell'istanza. Inoltre, verifica che la tua rete consenta il traffico da dispositivi mobili sulla porta 443 o sulla porta 19999. Per saperne di più, consulta le pagine della documentazione Considerazioni per le istanze ospitate dal cliente e Risoluzione dei problemi dell'API Looker.
  • Accesso biometrico:se la verifica biometrica (riconoscimento dell'impronta o del volto) non riesce, accedi utilizzando il nome utente e la password standard. Puoi riconfigurare la verifica biometrica nel menu Impostazioni dell'app in Sicurezza. Tieni presente che la biometria deve essere attivata anche nelle impostazioni di sistema del tuo dispositivo mobile.

Problemi di accesso con codice QR

L'applicazione mobile Looker unificata non supporta l'accesso con un codice QR. Utilizza invece l'autenticazione standard (Google OAuth, SAML, LDAP, OpenID Connect o email e password).

Se utilizzi l'applicazione mobile Looker (legacy) e non riesci ad accedere con un codice QR, verifica quanto segue:

  • Autenticazione SSO incorporata:nell'interfaccia web di Looker, vai ad Amministrazione > Piattaforma > Incorpora e verifica che l'autenticazione SSO incorporata sia attivata. Questa impostazione attiva l'opzione di accesso con codice QR.
  • Aggiorna il codice QR: i codici QR sono sensibili al tempo. Aggiorna la pagina web che mostra il codice QR, quindi prova a scansionare il codice QR appena generato.
  • Autorizzazioni fotocamera e visibilità: assicurati che l'applicazione mobile habia l'autorizzazione per accedere alla fotocamera del dispositivo e che l'illuminazione sia adeguata quando scansioni lo schermo.
  • Accesso alternativo:se l'autenticazione tramite codice QR continua a non funzionare, utilizza le credenziali di accesso tramite email e password oppure esegui la migrazione all'applicazione mobile Looker aggiornata.

Risolvere i problemi di rendering dei contenuti

Se i dashboard o i Look non vengono visualizzati, mostrano schede vuote o messaggi di errore nell'applicazione mobile, esamina quanto segue:

  • Ambito del problema:determina se l'errore di rendering riguarda tutti i contenuti o solo Look o dashboard specifici:
    • Tutti i contenuti non vengono riprodotti: controlla la connessione di rete del dispositivo mobile, verifica che la sessione non sia scaduta e prova a uscire e accedere di nuovo all'applicazione.
    • Errori relativi a contenuti specifici:controlla se i contenuti utilizzano visualizzazioni personalizzate o formati di layout non supportati. Verifica anche di avere accesso al modello e alle esplorazioni sottostanti.
  • Esamina i messaggi di errore:se viene visualizzato un banner di errore o un errore del riquadro, annota il messaggio specifico. I problemi comuni includono errori di connessione al database, timeout delle query o riferimenti ai campi mancanti.
  • Errori intermittenti e coerenti: se i contenuti non vengono caricati in modo intermittente, il problema potrebbe essere correlato al carico del database o a fluttuazioni temporanee della rete.
  • Tira giù per aggiornare:utilizza il gesto di trascinamento verso il basso sullo schermo per ricaricare la dashboard o Look ed eseguire nuove query.

Risolvere i problemi di arresto anomalo delle applicazioni

Se l'applicazione mobile Looker ha un arresto anomalo o si chiude inaspettatamente, segui questi passaggi per la risoluzione dei problemi:

  • Identifica i trigger di arresto anomalo: annota quando si verifica l'arresto anomalo. L'app si arresta immediatamente all'avvio, all'apertura di una dashboard specifica, quando si ruota il dispositivo tra la modalità verticale e la modalità Orizzontale o dopo una specifica interazione utente?
  • Aggiorna l'applicazione: controlla l'Apple App Store o il Google Play Store per assicurarti di utilizzare l'ultima versione dell'app mobile Looker. Gli aggiornamenti includono spesso miglioramenti della stabilità e correzioni di bug.
  • Aggiorna il sistema operativo del dispositivo:assicurati che sul tuo dispositivo mobile sia in esecuzione una versione supportata di iOS o Android. I sistemi operativi obsoleti possono causare problemi di compatibilità.
  • Svuota la cache e riavvia:
    • Forza la chiusura dell'applicazione e riaprila.
    • Riavvia il dispositivo mobile.
    • Su Android, svuota la cache dell'applicazione in Impostazioni > App > Looker > Spazio di archiviazione > Svuota cache.
  • Reinstalla l'applicazione:disinstalla l'app, riavvia il dispositivo e reinstalla l'applicazione dallo store ufficiale.

Risolvi i problemi di prestazioni e latenza

Se l'applicazione mobile Looker è lenta, non risponde o impiega molto tempo per caricare i contenuti, esamina quanto segue:

  • Identifica il componente lento:determina se il ritardo si verifica durante l'avvio dell'app, la navigazione tra cartelle e bacheche, il caricamento di elenchi di contenuti memorizzati nella cache o l'esecuzione di query per i riquadri della dashboard.
  • Memorizzazione nella cache degli elenchi:l'applicazione mobile memorizza nella cache gli elenchi dei contenuti visualizzati di recente e preferiti per velocizzare la navigazione. L'elenco si aggiorna automaticamente all'avvio dell'app, ma puoi trascinarlo verso il basso per aggiornarlo manualmente se sembra obsoleto.
  • Complessità della dashboard e numero di riquadri:le dashboard con molti riquadri o tipi di visualizzazione complessi richiedono una notevole quantità di memoria e risorse di elaborazione sui dispositivi mobili. Verifica se i Look o le dashboard più piccoli vengono caricati più rapidamente.
  • Velocità e latenza della rete:le reti mobile potrebbero riscontrare latenza elevata o perdita di pacchetti. Verifica se le prestazioni migliorano quando il dispositivo è connesso a una rete Wi-Fi affidabile e ad alta velocità.
  • Rendimento delle query del database:se il rendering dei singoli riquadri richiede molto tempo, controlla la durata della query nell'interfaccia web di Looker o nell'attività di sistema. Il ritardo potrebbe essere dovuto a query di database a lunga esecuzione.

Risolvere i problemi di visualizzazione e stile

Se riscontri difetti visivi, come elementi disallineati, icone rotte, immagini distorte o spaziatura imprevista, esamina quanto segue:

  • Orientamento dello schermo:prova il cruscotto o Look sia in orientamento verticale che orizzontale. Alcune dashboard e tabelle complesse sono ottimizzate per una visualizzazione orizzontale più ampia.
  • Layout della dashboard:le dashboard ottimizzate per il mobile regolano dinamicamente le posizioni dei riquadri per gli schermi piccoli. Se i riquadri si sovrappongono o troncano il testo, verifica le dimensioni e la configurazione dei riquadri nella modalità di modifica della dashboard nell'applicazione web.
  • Impostazioni di visualizzazione del dispositivo:le impostazioni di accessibilità, come le dimensioni dei caratteri di sistema personalizzate, lo zoom del display o gli strumenti di inversione della modalità Buio di terze parti, possono alterare il rendering dei contenuti. Esegui il test con le impostazioni di visualizzazione del sistema predefinite.
  • Documentazione visiva:acquisisci screenshot o registrazioni dello schermo che mostrino chiaramente la discrepanza di rendering da condividere con l'amministratore o con l'assistenza.

Raccogliere informazioni diagnostiche

Se non riesci a risolvere il problema dopo aver seguito i passaggi per la risoluzione dei problemi, raccogli le seguenti informazioni prima di contattare l'assistenza:

  1. Informazioni sull'istanza Looker:
    • URL istanza (ad esempio, instance_name.looker.com).
    • Versione di rilascio di Looker (nell'applicazione web, seleziona Guida > Informazioni).
    • Tipo di hosting dell'istanza (ospitata da Looker o dal cliente; Looker (Google Cloud core) o Looker (originale)).
  2. Informazioni sull'applicazione mobile:
    • Quale app è installata: specifica se hai installato l'app mobile Looker o Looker Mobile (legacy).
    • Numero di versione dell'applicazione (disponibile in fondo al menu Altro dell'app o in Impostazioni).
    • Store da cui è stata installata l'applicazione (Apple App Store o Google Play Store).
  3. Dettagli del dispositivo e del sistema operativo:
    • Produttore e modello del dispositivo (ad esempio Google Pixel 8, iPhone 15 Pro).
    • Versione del sistema operativo (ad esempio, Android 14, iOS 17.5).
  4. Ambito e impatto:
    • Il problema interessa tutti gli utenti o solo account utente specifici?
    • Il problema si verifica su tutti i dispositivi mobili o solo su modelli o versioni del sistema operativo specifici?
  5. Esempi visivi e log:
    • Screenshot o registrazioni dello schermo che mostrano il comportamento imprevisto o il messaggio di errore.
    • I passaggi esatti per riprodurre il problema.

Contatta l'assistenza

Se hai verificato tutti i passaggi precedenti e il problema non è ancora stato risolto: