Este guia ajuda a resolver problemas de um erro 404 numa página Web do Looker ou num pedido da API Looker. Normalmente, um erro 404 significa que o recurso pedido não existe ou que o utilizador não tem autorização para aceder ao mesmo.
Árvore de depuração
Use a seguinte árvore de decisão para começar a resolver problemas de um erro 404:
As secções seguintes descrevem os cenários na árvore mais detalhadamente.
Resolução de problemas de um erro 404 no navegador
Se o erro 404 aparecer numa página Web num navegador, siga os passos desta secção. Caso contrário, consulte a secção Erro da API.
Verifique a Consola de JavaScript
Primeiro, verifique a Consola de JavaScript no seu navegador para ver mais informações sobre o erro. Para abrir a consola JavaScript no Google Chrome, siga estes passos:
- Clique no menu de três pontos Mais.
- Selecione Mais ferramentas.
- Clique em Ferramentas para programadores.
- Clique no separador Consola.
Procure o erro 404 na lista de erros e encontre o URL correspondente.
Se o URL que devolve um erro 404 não for um URL do Looker, o erro tem origem num recurso externo. Se o URL do pedido pertencer a uma aplicação personalizada que se liga ao Looker, examine o código e os registos da sua aplicação para resolver o erro. O apoio técnico do Looker para problemas de recursos externos é limitado.
Se o URL for um URL do Looker, avance para a secção seguinte.
Verifique se existem gralhas no URL
Verifique se existem gralhas comuns no URL. Por exemplo:
- Um erro ortográfico comum para uma página de pesquisa é
/look/123. A sintaxe correta é/looks/123. - Um erro ortográfico comum para uma página do painel de controlo é
/dashboard/123. A sintaxe correta é/dashboards/123.
Quando inclui um link para uma análise detalhada, um visual ou um painel de controlo no seu LookML, teste sempre o link primeiro para se certificar de que a sintaxe está correta.
Se encontrar um erro ortográfico num link gerado a partir do seu LookML, corrija-o no LookML. Se encontrar um erro ortográfico num URL gerado pelo Looker (por exemplo, num elemento de navegação da IU), contacte o apoio técnico para pedir que o URL seja corrigido no produto.
Resolução de problemas de um erro 404 na API
Se o erro aparecer como resposta a uma chamada da API Looker, siga os passos nesta secção.
Reveja a documentação do ponto final da API
Procure a documentação do ponto final da API que está a devolver o erro 404. Por exemplo, a página de documentação do ponto final create_sso_embed_url é Criar URL incorporado assinado. Verifique os parâmetros e certifique-se de que está a fornecer os parâmetros corretos à chamada da API.
Certifique-se de que o verbo e o caminho do pedido estão corretos. Por exemplo, o ponto final /api/4.0/embed/sso_url deve ser usado com o verbo POST.
Também pode testar o ponto final da API diretamente na sua instância através do Explorador de APIs.
Verifique as condições de pontos finais necessárias
Alguns pontos finais só estão disponíveis em determinadas condições:
- Alguns pontos finais de projetos do LookML (como
create_project,deploy_to_productionereset_project_to_production) só estão disponíveis no modo de desenvolvimento.- Se necessário, use o ponto final
update_sessioncom o corpo do pedido{"workspace_id": "dev"}para mudar a sua sessão da API para o modo de desenvolvimento.
- Se necessário, use o ponto final
- O ponto final
reset_project_to_productionnão está disponível em ramificações partilhadas. - O ponto final
deploy_ref_to_productionsó está disponível quando o modo de implementação avançado está ativado.
Verifique as definições de webhook
Se o URL do pedido for um webhook de implementação, verifique as definições do webhook.
Se estiver a usar o webhook para implementar um ramo ou uma referência específica, ative o modo de implementação avançado no projeto.
Se um segredo de implementação do webhook estiver ativado no projeto, certifique-se de que inclui o segredo no pedido.
Verifique se existem recursos pedidos
Confirme que todos os recursos referenciados no pedido existem efetivamente na sua instância do Looker.
Verifique se todos os valores no URL e no corpo do pedido (como IDs de pastas ou IDs de painéis de controlo) se referem a recursos válidos e existentes. Por exemplo, para verificar se existe um painel de controlo, navegue para /dashboards/[id] como utilizador administrador. Se um recurso estiver em falta ou for inválido, crie o recurso em falta ou especifique um existente.
Se o recurso existir, mas continuar a receber um erro 404, verifique se o recurso existe no modo de programador. Se o utilizador do Looker tiver a autorização develop, verifique se o utilizador consegue aceder ao recurso quando entra no modo de desenvolvimento. Para chamadas da API, use o ponto final update_session com o corpo do pedido {"workspace_id": "dev"} para mudar a sessão da API para o modo de desenvolvimento.
Se o utilizador não tiver autorização develop, experimente implementar o projeto do LookML na produção e, em seguida, verifique se consegue aceder ao mesmo.
Verifique as autorizações de utilizador e as definições de acesso ao conteúdo
Se os recursos existirem, mas o utilizador continuar a receber um erro 404, verifique as autorizações e o acesso ao conteúdo do utilizador.
Assuma a identidade do utilizador e verifique se existe o erro
Se for administrador, navegue para o painel Administração > Utilizadores e faça-se passar (sudo) pelo utilizador que está a ter o erro 404.
- Se o utilizador for um utilizador de incorporação, verifique se a respetiva credencial de incorporação na página Administração > Utilizadores corresponde ao
external_user_idno URL de início de sessão de incorporação. - Se o utilizador estiver a fazer uma chamada API, use o
login_userponto final para se fazer passar pelo utilizador.
Se o erro 404 for apresentado enquanto se faz a representação do utilizador, mas não quando vê o recurso como administrador, é provável que o utilizador tenha autorizações ou definições de acesso ao conteúdo insuficientes.
Verifique as autorizações necessárias
Verifique as funções do utilizador no painel Administração > Utilizadores e a lista de autorizações no Looker para se certificar de que o utilizador tem as autorizações necessárias em, pelo menos, uma das respetivas funções. Por exemplo, para ver um painel de controlo, um utilizador precisa, pelo menos, das autorizações access data, see_looks e see_user_dashboards. Se o utilizador não tiver as autorizações necessárias, adicione-as a um conjunto de autorizações numa função atribuída a esse utilizador.
Se alguma autorização necessária for específica do modelo, verifique se o modelo LookML está incluído no conjunto de modelos para, pelo menos, uma das funções do utilizador com a autorização necessária. Caso contrário, adicione o modelo ao conjunto de modelos de uma das funções atribuídas ao utilizador.
Verifique se existem autorizações de incorporação válidas
Se o utilizador for um utilizador de incorporação assinado, verifique se a autorização necessária é uma autorização de incorporação válida. Se não for, o utilizador incorporado não pode fazer o pedido com êxito. Por exemplo, não é possível atribuir a autorização see_lookml a utilizadores incorporados.
Verifique as concessões de acesso
Se o conteúdo se basear numa análise detalhada com required_access_grants definido, verifique a definição de access_grant no projeto do LookML. Edite o valor do atributo do utilizador do utilizador para o atributo do utilizador especificado para um dos valores necessários na concessão de acesso.
Verifique o acesso ao conteúdo
Se o recurso pedido estiver armazenado numa pasta, verifique as definições de acesso ao conteúdo nessa pasta. Os Looks, os painéis de controlo e os relatórios do Looker Studio são todos armazenados em pastas.
Revisão final e apoio técnico
Se o erro 404 continuar a ocorrer, reveja os passos de resolução de problemas nesta página. Se continuar a não conseguir resolver o erro 404, contacte o apoio técnico.