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 a seguinte árvore de decisão para começar a resolver um erro 404:
As seções a seguir descrevem os cenários na árvore com mais detalhes.
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, confira a seção de erros da API.
Verificar o console JavaScript
Primeiro, verifique o console JavaScript no navegador para mais informações sobre o erro. Para abrir o console JavaScript no Google Chrome, siga estas etapas:
- Clique no menu de três pontos Mais.
- Selecione Mais ferramentas.
- Clique em Ferramentas para Desenvolvedores.
- Clique na guia Console.
Procure o erro 404 na lista de erros e encontre o URL correspondente.
Se o URL que retorna um erro 404 não for um URL do Looker, o erro terá origem em 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 do Look é
/look/123. A sintaxe correta é/looks/123. - Um erro de digitação comum para uma página do painel é
/dashboard/123. A sintaxe correta é/dashboards/123.
Ao incluir um link para uma Análise, um Look ou um painel no 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 pelo LookML, corrija o erro no 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 solicitar que o URL seja corrigido no produto.
Resolver um erro 404 na API
Se o erro aparecer como uma resposta a uma chamada de API Looker, siga as etapas desta seção.
Analisar 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 assinada. Verifique os parâmetros e confira se você está fornecendo os parâmetros corretos para a chamada de API.
Confira 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.
Você também pode 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_productionereset_project_to_production) só estão disponíveis no modo de desenvolvimento.- Se necessário, use o
update_sessionendpoint com o corpo da solicitação{"workspace_id": "dev"}para mudar a sessão da API para o modo de desenvolvimento.
- Se necessário, use o
- O endpoint
reset_project_to_productionnão está disponível em ramificações compartilhadas. - O endpoint
deploy_ref_to_productionsó está disponível quando o modo de implantação avançado está ativado.
Verificar as configurações do webhook
Se o URL da solicitação for um webhook de implantação, verifique as configurações do webhook.
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 secret de implantação de webhook estiver ativado no projeto, inclua o secret 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 pastas ou IDs de painéis) se referem a recursos válidos e existentes. Por exemplo, para verificar se um painel existe, acesse /dashboards/[id] como um usuário admin. Se um recurso estiver ausente ou inválido, crie o recurso ausente ou especifique um existente.
Se o recurso existir, mas você ainda receber um erro 404, verifique se o recurso existe no modo de desenvolvimento. Se o usuário do Looker tiver a permissão develop, verifique se ele pode acessar o recurso ao entrar no modo de desenvolvimento. Para chamadas de API, use o update_session endpoint 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 acessá-lo.
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 do usuário e o acesso ao conteúdo.
Representar o usuário e verificar o erro
Se você for um admin, acesse o painel Admin > Usuários e represente (sudo) o usuário que está recebendo o erro 404.
- Se o usuário for um usuário incorporado, verifique se a credencial de incorporação na página Admin > Usuários corresponde ao
external_user_idno URL de login incorporado. - Se o usuário estiver fazendo uma chamada de API, use o
login_userendpoint para representar o usuário.
Se o erro 404 aparecer enquanto você estiver representando o usuário, mas não quando visualizar o recurso como um admin, é 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 os papéis do usuário no painel Admin > Usuários e a lista de permissões no Looker para garantir que o usuário tenha as permissões necessárias em pelo menos um dos papéis. Por exemplo, para visualizar um painel, um usuário precisa de 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 essas permissões a um conjunto de permissões em um papel atribuído a esse usuário.
Se alguma permissão necessária for específica do modelo, verifique se o modelo do LookML está incluído no conjunto de modelos para pelo menos um dos papéis do usuário com a permissão necessária. Caso contrário, adicione o modelo ao conjunto de modelos de um dos papéis atribuídos ao usuário.
Verificar se há permissões de incorporação válidas
Se o usuário for um usuário de incorporação assinada, verifique se a permissão necessária é uma permissão de incorporação válida. Se não for, o usuário incorporado não poderá fazer a solicitação. Por exemplo, os usuários incorporados não podem receber a permissão see_lookml.
Verificar as concessões de acesso
Se o conteúdo for baseado em uma Análise com required_access_grants definida, verifique a definição access_grant no projeto do LookML. Edite o valor do atributo do usuário para o atributo do usuário especificado para um dos valores necessá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 nessa pasta. Looks, painéis e relatórios do Data Studio são armazenados em pastas.
Revisão final e suporte
Se o erro 404 ainda estiver ocorrendo, revise as etapas de solução de problemas nesta página. Se você ainda não conseguir resolver o erro 404, entre em contato com o suporte.