Com o app Looker, você pode acessar seu conteúdo do Looker e do Data Studio Pro em dispositivos Android e iOS, ver Looks e painéis e colaborar em qualquer lugar. Se você tiver problemas ao usar o app, como falhas de login, erros de renderização, falhas de aplicativos, atrasos de desempenho ou discrepâncias de exibição, este guia vai ajudar a resolver esses problemas.
Pré-requisitos e requisitos comuns de configuração
Antes de começar a resolver problemas, verifique se o ambiente e a conta atendem aos pré-requisitos para usar o app Looker para dispositivos móveis:
- Acesso ao aplicativo para dispositivos móveis ativado:um administrador do Looker precisa ativar o acesso ao aplicativo para dispositivos móveis na sua instância.
- Permissões do usuário:sua conta de usuário precisa ter a permissão
mobile_app_accessdo Looker atribuída diretamente ou por um grupo de usuários. - Instâncias compatíveis:o aplicativo móvel do Looker é compatível com instâncias do Looker (Google Cloud Core) (IP público ou IP particular usando o acesso a serviços particulares ou o Private Service Connect acessível por uma VPN corporativa) e do Looker (original) (hospedadas pelo Looker e hospedadas pelo cliente).
- VPN corporativa e listas de permissões de IP:se a instância do Looker aplicar listas de permissões de IP, o dispositivo móvel precisará se conectar por uma VPN corporativa com um endereço IP estático na lista de permissões de IP da instância.
- Autenticação aceita:o aplicativo Looker para dispositivos móveis aceita Google OAuth, SAML, LDAP, OpenID Connect e credenciais de e-mail e senha. O login com QR codes só é compatível com o aplicativo Looker Mobile (legado) e exige que o SSO de incorporação esteja ativado.
Árvore de depuração
Use a árvore de decisão a seguir para começar a resolver problemas do aplicativo móvel do Looker:
As seções a seguir descrevem os cenários na árvore com mais detalhes.
Identificar qual aplicativo para dispositivos móveis está instalado
Como o aplicativo para dispositivos móveis Looker e o aplicativo Looker Mobile (legado) estão disponíveis nas lojas de apps, a primeira etapa de solução de problemas é determinar qual aplicativo está instalado no seu dispositivo móvel. A etapa inicial de triagem do suporte depende dessa distinção para evitar investigações mal encaminhadas ou atrasadas:
- Looker:o aplicativo móvel unificado atual para conteúdo do Looker e do Data Studio Pro. Na tela inicial do dispositivo e nas app stores, o nome do app é Looker. Ele oferece suporte a métodos de autenticação padrão (como Google OAuth, SAML, OpenID Connect, LDAP e credenciais de e-mail e senha), mas não oferece suporte ao login por QR code. Este guia de solução de problemas aborda principalmente esse aplicativo.
- Looker Mobile (legado): o aplicativo móvel mais antigo. Na tela inicial do dispositivo e nas app stores, o nome do app é Looker Mobile (legado) ou Looker Mobile. Ele é compatível com login por QR code e e-mail e senha, mas não com instâncias do Google OAuth, SAML ou Looker (Google Cloud Core).
Para determinar qual aplicativo está instalado no seu dispositivo:
- Verifique o nome do aplicativo exibido abaixo do ícone do app na tela inicial do dispositivo ou no Acesso rápido aos apps.
- No app para dispositivos móveis, selecione Mais no menu de navegação da parte de baixo ou abra Configurações e localize o nome do aplicativo e o número da versão na parte de baixo do menu.
- Verifique a lista de apps instalados na App Store da Apple (iOS) ou na Google Play Store (Android).
Se você tiver o Looker Mobile (legado) instalado, o suporte a esse aplicativo vai terminar em 31 de janeiro de 2027, e ele será removido da lista. O Google recomenda migrar para o aplicativo Looker para dispositivos móveis atual. Para documentação e solução de problemas do aplicativo legado, consulte o guia do Looker Mobile (legado).
Se você tiver o aplicativo móvel Looker instalado, siga as etapas de solução de problemas nas seções a seguir.
Verifique se o problema se reproduz fora do aplicativo para dispositivos móveis
A primeira etapa da solução de problemas é determinar se o problema está isolado no aplicativo para dispositivos móveis ou se também afeta o aplicativo da Web do Looker.
Abra um navegador da Web para computador ou dispositivo móvel, faça login na sua instância do Looker e tente realizar a mesma ação:
- Você consegue fazer login em um navegador da Web? Se você não conseguir fazer login em um navegador da Web, o problema não é específico do aplicativo para dispositivos móveis. Verifique suas credenciais, a configuração do provedor de identidade (IdP) ou o status da conta de usuário.
- As consultas ou os painéis são carregados em um navegador da Web? Se o painel ou o Look não carregar, retornar um erro de banco de dados ou atingir o tempo limite no navegador, o problema será na consulta, na conexão de banco de dados ou no modelo LookML e não no aplicativo para dispositivos móveis.
- Você tem permissão para acessar o conteúdo? Se não for possível ver o conteúdo na interface da Web, verifique se você tem as permissões de acesso adequadas para a pasta, o modelo e a análise detalhada.
Se o problema também ocorrer em um navegador da Web, resolva o problema na sua instância do Looker.
Se o problema ocorrer apenas no aplicativo para dispositivos móveis, acesse a seção relevante deste guia.
Resolver problemas de login
Se você não conseguir fazer login no aplicativo móvel do Looker, investigue as seguintes causas comuns:
- Formato do URL da instância:ao inserir o URL da instância no app para dispositivos móveis, use o formato
instance_name.looker.comou seu domínio personalizado. Não incluahttps://,http://ou barras finais. - Ativação da instância:verifique com o administrador do Looker se o acesso ao aplicativo para dispositivos móveis está ativado em Administrador > Geral > Aplicativo para dispositivos móveis.
- Permissões do usuário:verifique com seu administrador se sua função ou
grupo de usuário inclui a permissão
mobile_app_access. - VPN corporativa e listas de permissões de IP:se a instância aplicar listas de permissões de IP, verifique se o dispositivo móvel está conectado à VPN da organização e se o endereço IP estático do servidor de VPN está na lista de permissões de IP da instância. Para testar, abra o URL da instância em um navegador da Web no mesmo dispositivo móvel enquanto estiver conectado à VPN.
- Configuração de API hospedada pelo cliente:se você usa uma instância do Looker (original) hospedada pelo cliente, verifique se o URL do host da API da instância em Administrador > Plataforma > API corresponde ao nome do host da instância. Além disso, verifique se a rede permite tráfego móvel nas portas 443 ou 19999. Para mais informações, consulte as páginas de documentação Considerações sobre instâncias hospedadas pelo cliente e Solução de problemas da API Looker.
- Login biométrico:se a verificação biométrica (impressão digital ou reconhecimento facial) falhar, faça login usando seu nome de usuário e senha padrão. Você pode reconfigurar a verificação biométrica no menu Configurações do app em Segurança. As biometrias também precisam estar ativadas nas configurações de sistema do dispositivo móvel.
Problemas de login com QR code
O aplicativo unificado do Looker para dispositivos móveis não permite fazer login com um QR code. Use a autenticação padrão (OAuth do Google, SAML, LDAP, OpenID Connect ou e-mail e senha).
Se você estiver usando o aplicativo Looker Mobile (legado) e não conseguir fazer login com um QR code, investigue o seguinte:
- Autenticação de SSO incorporado:na interface da Web do Looker, acesse Administrador > Plataforma > Incorporar e confirme se a Autenticação de SSO incorporado está ativada. Essa configuração ativa a opção de login com QR code.
- Atualize o QR code:eles têm validade. Atualize a página da Web que mostra o QR code e tente ler o código gerado novamente.
- Permissões e visibilidade da câmera:verifique se o aplicativo móvel tem permissão para acessar a câmera do dispositivo e se há iluminação adequada ao ler a tela.
- Login alternativo:se a autenticação por QR code continuar falhando, use credenciais de e-mail e senha para fazer login ou migre para o aplicativo móvel atualizado do Looker.
Resolver problemas de renderização de conteúdo
Se os painéis ou Looks não forem renderizados, mostrarem cards em branco ou mensagens de erro no aplicativo para dispositivos móveis, investigue o seguinte:
- Escopo do problema:determine se a falha de renderização afeta todo o conteúdo ou apenas Looks ou painéis específicos:
- Falha em todo o conteúdo:verifique a conexão de rede do dispositivo móvel, confira se a sessão não expirou e tente sair e fazer login novamente no aplicativo.
- Falhas de conteúdo específico:verifique se o conteúdo usa visualizações personalizadas ou formatos de layout não compatíveis. Verifique também se você tem acesso ao modelo e às análises detalhadas.
- Inspecione as mensagens de erro:se um banner ou bloco de erro aparecer, anote a mensagem específica. Os problemas comuns incluem erros de conexão com o banco de dados, tempos limite de consulta ou referências de campo ausentes.
- Falhas intermitentes x consistentes:se o conteúdo falhar de forma intermitente, o problema pode estar relacionado à carga do banco de dados ou a flutuações temporárias na rede.
- Arrastar para baixo para atualizar:use o gesto de arrastar para baixo para atualizar (puxe para baixo na tela) para recarregar o painel ou executar novas consultas do Look.
Resolver problemas de falhas de aplicativos
Se o app Looker para dispositivos móveis falhar ou fechar inesperadamente, siga estas etapas de solução de problemas:
- Identifique os gatilhos de falha:observe quando a falha ocorre. O app falha imediatamente após a inicialização, ao abrir um painel específico, ao girar o dispositivo entre os modos retrato e paisagem ou após uma interação específica do usuário?
- Atualize o aplicativo:verifique a App Store da Apple ou a Google Play Store para garantir que você esteja usando a versão mais recente do app Looker para dispositivos móveis. As atualizações geralmente incluem melhorias de estabilidade e correções de bugs.
- Atualize o sistema operacional do dispositivo:confira se o dispositivo móvel está executando uma versão compatível do iOS ou Android. Sistemas operacionais desatualizados podem causar problemas de compatibilidade.
- Limpe o cache e reinicie:
- Force o fechamento e abra o app de novo.
- Reinicie o dispositivo móvel.
- No Android, limpe o cache do aplicativo em Configurações > Apps > Looker > Armazenamento > Limpar cache.
- Reinstale o aplicativo:desinstale o app, reinicie o dispositivo e reinstale o aplicativo na app store oficial.
Resolver problemas de performance e latência
Se o app Looker para dispositivos móveis estiver lento, não responder ou demorar muito para carregar o conteúdo, investigue o seguinte:
- Identifique o componente lento:determine se o atraso ocorre ao iniciar o app, navegar por pastas e quadros, carregar listas de conteúdo em cache ou executar consultas para blocos do painel.
- Armazenamento em cache de listas:o aplicativo para dispositivos móveis armazena em cache listas de conteúdo visto recentemente e favorito para acelerar a navegação. A lista é atualizada automaticamente ao iniciar o app, mas você pode puxar para baixo e atualizar manualmente se ela parecer desatualizada.
- Complexidade do painel e contagem de blocos:painéis com muitos blocos ou tipos de visualização complexos exigem muitos recursos de memória e processamento em dispositivos móveis. Teste se painéis menores ou Looks individuais carregam mais rápido.
- Velocidade e latência da rede:as redes móveis podem ter alta latência ou perda de pacotes. Teste se o desempenho melhora quando você se conecta a uma rede Wi-Fi confiável e de alta velocidade.
- Performance da consulta de banco de dados:se os blocos individuais demorarem muito para serem renderizados, verifique a duração da consulta na interface da Web do Looker ou na atividade do sistema. O atraso pode ser causado por consultas de banco de dados de longa duração.
Resolver problemas de exibição e estilo
Se você encontrar defeitos visuais, como elementos desalinhados, ícones quebrados, imagens distorcidas ou padding inesperado, investigue o seguinte:
- Orientação da tela:teste o painel ou o Look nas orientações retrato e paisagem. Alguns dashboards e tabelas complexos são otimizados para visualização em paisagem mais ampla.
- Layout do painel:os painéis compatíveis com dispositivos móveis ajustam dinamicamente as posições dos blocos para telas pequenas. Se os blocos se sobrepuserem ou truncarem o texto, verifique o dimensionamento e a configuração deles no modo de edição do painel no aplicativo da Web.
- Configurações de exibição do dispositivo:as configurações de acessibilidade, como tamanhos de fonte personalizados do sistema, zoom da tela ou ferramentas de inversão do modo escuro de terceiros, podem alterar a forma como o conteúdo é renderizado. Teste com as configurações de exibição padrão do sistema.
- Documentação visual:faça capturas de tela ou gravações de tela que mostrem claramente a discrepância de renderização para compartilhar com seu administrador ou com o suporte.
Coletar informações de diagnóstico
Se você não conseguir resolver o problema depois de seguir as etapas de solução de problemas, reúna as seguintes informações antes de entrar em contato com o suporte:
- Informações da instância do Looker:
- URL da instância (por exemplo,
instance_name.looker.com). - Versão de lançamento do Looker (no aplicativo da Web, selecione Ajuda > Sobre).
- Tipo de hospedagem da instância (hospedada pelo Looker ou pelo cliente; Looker (Google Cloud Core) ou Looker (original)).
- URL da instância (por exemplo,
- Informações do aplicativo para dispositivos móveis:
- Qual app está instalado:especifique se você instalou o app Looker para dispositivos móveis ou o Looker Mobile (legado).
- Número da versão do aplicativo (encontrado na parte de baixo do menu Mais no app ou em Configurações).
- Loja de apps em que o aplicativo foi instalado (App Store da Apple ou Google Play Store).
- Detalhes do dispositivo e do sistema operacional:
- Fabricante e modelo do dispositivo (por exemplo, Google Pixel 8, iPhone 15 Pro).
- Versão do sistema operacional (por exemplo, Android 14, iOS 17.5).
- Escopo e impacto:
- O problema afeta todos os usuários ou apenas contas de usuário específicas?
- O problema ocorre em todos os dispositivos móveis ou apenas em modelos ou versões de sistema operacional específicos?
- Exemplos visuais e registros:
- Capturas ou gravações de tela mostrando o comportamento inesperado ou a mensagem de erro.
- Etapas exatas para reproduzir o problema.
Entrar em contato com o suporte
Se você verificou todas as etapas anteriores e o problema ainda não foi resolvido:
- Entre em contato com o suporte e forneça as informações de diagnóstico coletadas na seção anterior.