Como resolver erros 404

Este guia ajuda a resolver um erro 404 em uma página da Web do Looker ou em uma solicitação da API Looker. Um erro 404 geralmente significa que o recurso solicitado não existe ou que o usuário não tem permissão para acessá-lo.

Árvore de depuração

Use o diagrama de decisão a seguir para começar a resolver um erro 404:

As seções a seguir descrevem os cenários na árvore em mais detalhes.

Como resolver um erro 404 no navegador

Se o erro 404 aparecer em uma página da Web em um navegador, siga as etapas desta seção. Caso contrário, consulte a seção Erro de API.

Verificar o console JavaScript

Primeiro, verifique o console JavaScript no seu navegador para mais informações sobre o erro. Para abrir o console JavaScript no Google Chrome, siga estas etapas:

  1. Clique no menu de três pontos Mais.
  2. Selecione Mais ferramentas.
  3. Clique em Ferramentas para Desenvolvedores.
  4. Clique na guia Console.

Procure o erro 404 na lista e encontre o URL correspondente.

Se o URL que retorna um erro 404 não for do Looker, o problema é de um recurso externo. Se o URL da solicitação pertencer a um aplicativo personalizado que se conecta ao Looker, examine o código e os registros do aplicativo para resolver o erro. O suporte do Looker para problemas de recursos externos é limitado.

Se o URL for do Looker, continue para a próxima seção.

Verificar se há erros de digitação no URL

Verifique se há erros de digitação comuns no URL. Exemplo:

  • Um erro de digitação comum para uma página de análise detalhada é /look/123. A sintaxe correta é /looks/123.
  • Um erro de digitação comum para uma página de painel é /dashboard/123. A sintaxe correta é /dashboards/123.

Ao incluir um link para uma análise detalhada, um Look ou um painel na sua LookML, sempre teste o link primeiro para garantir que a sintaxe esteja correta.

Se você encontrar um erro de digitação em um link gerado com base na sua LookML, corrija o erro na LookML. Se você encontrar um erro de digitação em um URL gerado pelo Looker (por exemplo, em um elemento de navegação da UI), entre em contato com o suporte para pedir que o URL seja corrigido no produto.

Solução de problemas de um erro 404 na API

Se o erro aparecer como uma resposta a uma chamada da API Looker, siga as etapas nesta seção.

Consulte a documentação do endpoint de API

Consulte a documentação do endpoint de API que está retornando o erro 404. Por exemplo, a página de documentação do endpoint create_sso_embed_url é Criar URL de incorporação assinado. Verifique os parâmetros e confira se você está fornecendo os corretos para a chamada de API.

Verifique se o verbo e o caminho da solicitação estão corretos. Por exemplo, o endpoint /api/4.0/embed/sso_url precisa ser usado com o verbo POST.

Também é possível testar o endpoint de API diretamente na sua instância usando o API Explorer.

Verificar as condições necessárias do endpoint

Alguns endpoints só estão disponíveis em determinadas condições:

  • Alguns endpoints de projetos do LookML (como create_project, deploy_to_production e reset_project_to_production) estão disponíveis apenas no modo de desenvolvimento.
    • Se necessário, use o endpoint update_session com o corpo da solicitação {"workspace_id": "dev"} para mudar a sessão da API para o modo de desenvolvimento.
  • O endpoint reset_project_to_production não está disponível em ramificações compartilhadas.
  • O endpoint deploy_ref_to_production só fica disponível quando o modo de implantação avançada está ativado.

Verificar as configurações do webhook

Se o URL da solicitação for um webhook de implantação, verifique as configurações dele.

Se você estiver usando o webhook para implantar uma ramificação ou referência específica, ative o Modo de implantação avançado no projeto.

Se um segredo de implantação de webhook estiver ativado no projeto, inclua o segredo na solicitação.

Verificar se os recursos solicitados existem

Confirme se todos os recursos referenciados na solicitação realmente existem na sua instância do Looker.

Verifique se todos os valores no URL e no corpo da solicitação (como IDs de pasta ou painel) se referem a recursos válidos e existentes. Por exemplo, para verificar se um painel existe, navegue até /dashboards/[id] como um usuário administrador. Se um recurso estiver faltando ou for inválido, crie o recurso ausente ou especifique um recurso existente.

Se o recurso existir, mas você ainda receber um erro 404, verifique se ele existe no modo de desenvolvimento. Se o usuário do Looker tiver a permissão develop, verifique se ele consegue acessar o recurso ao entrar no modo de desenvolvimento. Para chamadas de API, use o endpoint update_session com o corpo da solicitação {"workspace_id": "dev"} para mudar a sessão da API para o modo de desenvolvimento.

Se o usuário não tiver a permissão develop, tente implantar o projeto do LookML na produção e verifique se ele pode acessar.

Verificar as permissões do usuário e as configurações de acesso ao conteúdo

Se os recursos existirem, mas o usuário ainda receber um erro 404, verifique as permissões e o acesso ao conteúdo dele.

Fazer a representação do usuário e verificar o erro

Se você for um administrador, acesse o painel Administrador > Usuários e faça a representação (sudo) do usuário que está com o erro 404.

  • Se o usuário for de incorporação, verifique se a credencial de incorporação na página Administrador > Usuários corresponde ao external_user_id no URL de login de incorporação.
  • Se o usuário estiver fazendo uma chamada de API, use o endpoint login_user para representar o usuário.

Se o erro 404 aparecer enquanto você estiver se passando pelo usuário, mas não quando visualizar o recurso como administrador, é provável que o usuário tenha permissões ou configurações de acesso ao conteúdo insuficientes.

Verificar as permissões necessárias

Verifique as funções do usuário no painel Administrador > Usuários e a lista de permissões no Looker para garantir que ele tenha as permissões necessárias em pelo menos uma das funções. Por exemplo, para acessar um painel, o usuário precisa ter pelo menos as permissões access data, see_looks e see_user_dashboards. Se o usuário não tiver as permissões necessárias, adicione-as a um conjunto de permissões em uma função atribuída a ele.

Se alguma permissão obrigatória for específica do modelo, verifique se o modelo LookML está incluído no conjunto de modelos de pelo menos uma das funções do usuário com a permissão necessária. Caso contrário, adicione o modelo ao conjunto de modelos de uma das funções atribuídas ao usuário.

Verificar permissões de incorporação válidas

Se o usuário tiver um embed assinado, verifique se a permissão necessária é uma permissão de embed válida. Caso contrário, o usuário incorporado não poderá fazer a solicitação. Por exemplo, não é possível atribuir a usuários incorporados a permissão see_lookml.

Verificar concessões de acesso

Se o conteúdo for baseado em uma Análise com required_access_grants definido, verifique a definição de access_grant no projeto do LookML. Edite o valor do atributo do usuário para um dos valores obrigatórios na concessão de acesso.

Verificar o acesso ao conteúdo

Se o recurso solicitado estiver armazenado em uma pasta, verifique as configurações de acesso ao conteúdo dela. Looks, dashboards e relatórios do Looker Studio são armazenados em pastas.

Revisão final e suporte

Se o erro 404 ainda ocorrer, consulte as etapas de solução de problemas nesta página. Se ainda não for possível resolver o erro 404, entre em contato com o suporte.