Quando você executa uma consulta interativa no Looker (Google Cloud Core), ela pode parecer ser executada indefinidamente na interface de Análise ou em um painel. No entanto, os registros do banco de dados de back-end indicam que a consulta foi explicitamente cancelada após 20 a 30 segundos.
Nesta página, explicamos por que esse comportamento ocorre e como resolvê-lo ajustando as configurações de tempo limite na infraestrutura de rede intermediária. Este guia é destinado a administradores que gerenciam o roteamento de rede e resolvem problemas de consultas no Looker (Google Cloud Core).
Sintomas
Ao executar uma consulta interativa em uma Análise ou em um painel, você pode observar os seguintes sintomas:
- Interface do usuário do Looker: a interface do usuário do Looker Explore ou o bloco do painel permanece em um estado Em execução (girando) indefinidamente e nunca retorna resultados nem exibe um erro.
- Tempo de execução do banco de dados de back-end: no banco de dados de back-end (como BigQuery, Snowflake ou PostgreSQL), a consulta é cancelada após um curto período, normalmente de 20 a 30 segundos.
- Registros de consulta do banco de dados de back-end: o histórico de consultas ou os registros de auditoria no seu banco de dados de back-end indicam que o job foi explicitamente cancelado pelo usuário, mesmo que você não tenha cancelado a consulta ou fechado a guia do navegador.
Causa
Esse problema ocorre devido a uma incompatibilidade entre o mecanismo de heartbeat da sessão do Looker e as configurações de tempo limite definidas em dispositivos de rede intermediários que roteiam o tráfego entre seu navegador e a instância do Looker (Google Cloud Core).
Sinal de funcionamento da sessão e mecanismo de abandono de consulta
Para gerenciar o uso de recursos do banco de dados de maneira eficiente, o Looker (Google Cloud Core) monitora a conectividade do cliente durante a execução da consulta usando o seguinte mecanismo:
- Heartbeat contínuo: quando você executa uma consulta interativa na interface do Looker, seu navegador da Web mantém uma conexão ativa e envia sinais de heartbeat contínuos para a instância do Looker (Google Cloud Core) para manter a sessão de consulta ativa.
- Tempo limite de conexão intermediária: se um dispositivo de rede intermediário, como um balanceador de carga de aplicativo, um proxy reverso corporativo, um firewall de aplicativos da Web (WAF) ou um gateway de VPN, tiver uma configuração de tempo limite de resposta ou inatividade curta (por exemplo, o tempo limite padrão de 30 segundos do serviço de back-end em balanceadores de carga de aplicativo doGoogle Cloud ), o dispositivo vai fechar ou encerrar a conexão prematuramente quando o ambiente de execução da consulta exceder esse limite.
- Detecção de abandono de consulta: depois que a conexão intermediária é fechada, o Looker (Google Cloud Core) para de receber sinais de heartbeat do seu navegador. Após aproximadamente 30 segundos sem um sinal de heartbeat, o Looker (Google Cloud Core) detecta que a sessão do cliente não está mais acessível e identifica a consulta como abandonada.
- Limpeza do banco de dados: para evitar o consumo desnecessário de recursos de computação do banco de dados em consultas que nenhum usuário está aguardando, o Looker (Google Cloud Core) envia automaticamente uma solicitação de cancelamento ao banco de dados de back-end. Como o Looker emite o cancelamento em nome do usuário que executou a consulta, os registros do banco de dados registram que o job foi cancelado pelo usuário.
- Estado de execução indefinido na interface: como o proxy ou gateway intermediário fechou a conexão entre o navegador e o Looker (Google Cloud Core), o navegador nunca recebe o status de cancelamento ou a resposta de erro. Como resultado, a interface do Looker Explore ou o bloco do painel permanece no estado Em execução.
Identificar o problema
Para determinar se os cancelamentos de consulta são causados por tempos limite de rede intermediários, siga estas etapas:
- Verifique os registros de consulta do banco de dados: analise o histórico de execução no banco de dados de back-end para a consulta cancelada:
- No BigQuery, acesse a página Histórico de consultas no console do Google Cloud ou verifique o histórico de jobs do projeto no console do Google Cloud e localize o job com falha. Verifique os detalhes do job para confirmar se a consulta foi cancelada após aproximadamente 20 a 30 segundos com um status de cancelamento.
- No Snowflake, inspecione a visualização
QUERY_HISTORYou a guia Histórico no Snowsight. Verifique se o status da consulta mostraFAILED_WITH_ERRORou indica que a consulta foi cancelada pelo usuário após cerca de 30 segundos. - No PostgreSQL, revise o registro do servidor em busca de mensagens como
canceling statement due to user requestque correspondam ao carimbo de data/hora da sua consulta.
- Verifique a duração da consulta: nos registros do banco de dados, observe a duração exata da consulta antes de ser cancelada. Se a consulta for cancelada de forma consistente em cerca de 30 segundos (ou em torno do limite de tempo limite configurado no proxy ou balanceador de carga), é provável que um tempo limite de rede intermediário tenha acionado o cancelamento.
- Verifique a infraestrutura de rede intermediária: identifique proxies reversos, balanceadores de carga ou VPNs no caminho de rede entre os navegadores dos usuários e a instância do Looker (Google Cloud Core).
Resolução
Para resolver esse problema, aumente as configurações de tempo limite de inatividade e resposta em todos os dispositivos de rede que roteiam o tráfego entre os navegadores dos usuários e a instância do Looker (Google Cloud Core). Defina o limite de tempo limite como um valor maior que a duração esperada das consultas interativas mais longas.
Aumentar o tempo limite do serviço de back-end do balanceador de carga de aplicativo
Se a instância do Looker (Google Cloud Core) estiver protegida por um balanceador de carga de aplicativo externo ou interno, siga estas etapas:
No console do Google Cloud , acesse a página Balanceamento de carga:
Clique em Back-ends e, em seguida, no nome do serviço de back-end associado à sua instância do Looker (Google Cloud Core).
Clique em Editar.
No campo Tempo limite, aumente o valor do tempo limite. Por exemplo, mude o valor padrão de 30 segundos para 300 segundos (5 minutos) ou mais, dependendo dos tempos de execução de consulta esperados.
Clique em Salvar.
Aumentar os tempos limite de proxy, WAF ou VPN
Se os usuários acessarem o Looker (Google Cloud Core) por um proxy de encaminhamento corporativo, proxy reverso (como NGINX ou Apache), WAF ou gateway de VPN, siga estas etapas:
- Localize as configurações de conexão, resposta ou tempo limite de inatividade nas
configurações de proxy ou gateway, como nos exemplos a seguir:
- No NGINX, aumente as diretivas
proxy_read_timeouteproxy_send_timeout. - No Apache, aumente as diretivas
TimeOutouProxyTimeout. - Em VPNs corporativas ou gateways de firewall, aumente o tempo limite de inatividade da sessão TCP para o tráfego HTTPS para o domínio do Looker (Google Cloud Core).
- No NGINX, aumente as diretivas
- Permita conexões HTTP e WebSocket de longa duração pelo proxy para que os sinais de heartbeat do navegador cheguem ao Looker (Google Cloud Core) sem interrupção.
- Aplique as alterações de configuração e reinicie ou recarregue o serviço de proxy.
Verificar a resolução
Depois de aumentar as configurações de tempo limite no balanceador de carga ou nos proxies intermediários, siga estas etapas para verificar se as consultas foram concluídas:
- No Looker (Google Cloud Core), acesse uma Análise ou um painel em que as consultas foram canceladas anteriormente.
- Execute a consulta que falhou anteriormente.
- Verifique se a consulta é executada além do limite de tempo limite anterior (como 30 segundos) sem cancelamento e exibe os resultados na UI.
- Se quiser, verifique os registros de consulta do banco de dados de back-end para confirmar se o job foi concluído sem um status de cancelamento do usuário.
Recursos relacionados
- Resolver problemas de rede do Looker (Google Cloud Core): erro de tempo limite 504
- Ver registros de instância do Looker (Google Cloud Core)
- Receber suporte para o Looker (Google Cloud Core)