Quando esegui una query interattiva in Looker (Google Cloud core), la query potrebbe sembrare in esecuzione a tempo indeterminato nell'interfaccia utente di Esplora o in una dashboard. Tuttavia, i log del database di backend indicano che la query è stata annullata esplicitamente dopo 20-30 secondi.
Questa pagina spiega perché si verifica questo comportamento e come risolverlo modificando le impostazioni di timeout nell'infrastruttura di rete intermedia. Questa guida è rivolta agli amministratori che gestiscono il routing di rete e risolvono i problemi delle query in Looker (Google Cloud core).
Sintomi
Quando esegui una query interattiva in un'esplorazione o in una dashboard, potresti riscontrare i seguenti sintomi:
- Interfaccia utente di Looker: l'interfaccia utente di Esplora di Looker o il riquadro della dashboard rimane in uno stato In esecuzione (rotazione) a tempo indeterminato e non restituisce mai risultati né visualizza un errore.
- Tempo di esecuzione del database di backend: nel database di backend (ad esempio BigQuery, Snowflake o PostgreSQL), la query viene annullata dopo un breve periodo di tempo, in genere 20-30 secondi.
- Log delle query del database di backend: la cronologia delle query o gli audit log nel database di backend indicano che il job è stato annullato esplicitamente dall'utente, anche se non hai annullato la query o chiuso la scheda del browser.
Causa
Questo problema si verifica a causa di una mancata corrispondenza tra il meccanismo di heartbeat della sessione di Looker e le impostazioni di timeout configurate sui dispositivi di rete intermedi che instradano il traffico tra il browser e l'istanza di Looker (Google Cloud core).
Heartbeat della sessione e meccanismo di abbandono delle query
Per gestire in modo efficiente l'utilizzo delle risorse del database, Looker (Google Cloud core) monitora la connettività dei client durante l'esecuzione delle query tramite il seguente meccanismo:
- Heartbeat continuo: quando esegui una query interattiva nell'interfaccia utente di Looker, il browser web mantiene una connessione attiva e invia segnali di heartbeat continui all'istanza di Looker (Google Cloud core) per mantenere attiva la sessione della query.
- Timeout della connessione intermedia: se un dispositivo di rete intermedio, come un bilanciatore del carico delle applicazioni, un reverse proxy aziendale, un Web Application Firewall (WAF) o un gateway VPN, ha una configurazione di timeout di inattività o di risposta breve (ad esempio, il timeout predefinito del servizio di backend di 30 secondi sui bilanciatori del carico delle applicazioniGoogle Cloud ), il dispositivo chiude o interrompe prematuramente la connessione quando il runtime della query supera questa soglia.
- Rilevamento dell'abbandono delle query: dopo la chiusura della connessione intermedia, Looker (Google Cloud core) smette di ricevere segnali di heartbeat dal tuo browser. Dopo circa 30 secondi senza un segnale di heartbeat, Looker (Google Cloud core) rileva che la sessione client non è più raggiungibile e identifica la query come abbandonata.
- Pulizia del database: per evitare di consumare risorse di calcolo del database non necessarie per query che nessun utente sta aspettando, Looker (Google Cloud core) invia automaticamente una richiesta di annullamento al database di backend. Poiché Looker emette l'annullamento per conto dell'utente che ha eseguito la query, i log del database registrano che il job è stato annullato dall'utente.
- Stato di esecuzione indefinito nell'interfaccia utente: poiché il proxy o il gateway intermedio ha chiuso la connessione tra il browser e Looker (Google Cloud core), il browser non riceve mai lo stato di annullamento o la risposta di errore. Di conseguenza, la UI di Esplora di Looker o il riquadro della dashboard rimangono bloccati nello stato In esecuzione.
Identifica il problema
Per determinare se gli annullamenti delle query sono causati da timeout di rete intermedi, segui questi passaggi:
- Controlla i log delle query del database: esamina la cronologia di esecuzione nel database di backend per la query annullata:
- In BigQuery, vai alla pagina Cronologia query nella consoleGoogle Cloud o controlla la cronologia dei job del progetto nella console Google Cloud e individua il job non riuscito. Controlla i dettagli del job per verificare che la query sia stata annullata dopo circa 20-30 secondi con uno stato di annullamento.
- In Snowflake, controlla la vista
QUERY_HISTORYo la scheda History (Cronologia) in Snowsight. Controlla se lo stato della query mostraFAILED_WITH_ERRORo indica che la query è stata annullata dall'utente dopo circa 30 secondi. - In PostgreSQL, controlla il log del server per verificare la presenza di messaggi come
canceling statement due to user requestche corrispondono al timestamp della query.
- Verifica la durata della query: nei log del database, prendi nota della durata esatta della query prima che venisse annullata. Se la query viene annullata costantemente dopo circa 30 secondi (o intorno al limite di timeout configurato sul proxy o sul bilanciatore del carico), è probabile che l'annullamento sia stato attivato da un timeout di rete intermedio.
- Controlla l'infrastruttura di rete intermedia: identifica eventuali reverse proxy, bilanciatori del carico o VPN nel percorso di rete tra i browser degli utenti e l'istanza di Looker (Google Cloud core).
Risoluzione
Per risolvere il problema, aumenta le impostazioni di timeout di inattività e risposta su tutti i dispositivi di rete che instradano il traffico tra i browser degli utenti e l'istanza di Looker (Google Cloud core). Imposta il limite di timeout su un valore superiore alla durata prevista delle query interattive con il tempo di esecuzione più lungo.
Aumenta il timeout del servizio di backend del bilanciatore del carico delle applicazioni
Se l'istanza di Looker (Google Cloud core) è preceduta da un bilanciatore del carico delle applicazioni esterno o interno, segui questi passaggi:
Nella console Google Cloud , vai alla pagina Bilanciamento del carico:
Fai clic su Backend, quindi sul nome del servizio di backend associato alla tua istanza di Looker (Google Cloud core).
Fai clic su Modifica.
Nel campo Timeout, aumenta il valore di timeout. Ad esempio, modifica il valore predefinito da 30 secondi a 300 secondi (5 minuti) o più, a seconda dei tempi di esecuzione delle query previsti.
Fai clic su Salva.
Aumenta i timeout di proxy, WAF o VPN
Se gli utenti accedono a Looker (Google Cloud core) tramite un proxy di inoltro aziendale, un reverse proxy (come NGINX o Apache), un WAF o un gateway VPN, segui questi passaggi:
- Individua le configurazioni di timeout della connessione, della risposta o di inattività nelle impostazioni del proxy o del gateway, come nei seguenti esempi:
- In NGINX, aumenta le direttive
proxy_read_timeouteproxy_send_timeout. - In Apache, aumenta le istruzioni
TimeOutoProxyTimeout. - Nelle VPN aziendali o nei gateway firewall, aumenta il timeout di inattività della sessione TCP per il traffico HTTPS verso il dominio Looker (Google Cloud core).
- In NGINX, aumenta le direttive
- Consenti connessioni HTTP e WebSocket di lunga durata tramite il proxy in modo che i segnali di heartbeat del browser raggiungano Looker (Google Cloud core) senza interruzioni.
- Applica le modifiche alla configurazione e riavvia o ricarica il servizio di proxy.
Verifica la risoluzione
Dopo aver aumentato le impostazioni di timeout sul bilanciatore del carico o sui proxy intermedi, segui questi passaggi per verificare che le query vengano completate correttamente:
- In Looker (Google Cloud core), vai a un'esplorazione o a una dashboard in cui le query sono state annullate in precedenza.
- Esegui la query che in precedenza non è riuscita.
- Verifica che la query venga eseguita oltre la soglia di timeout precedente (ad esempio 30 secondi) senza annullamento e che i risultati vengano visualizzati nell'interfaccia utente.
- Facoltativamente, controlla i log delle query del database di backend per verificare che il job sia stato completato correttamente senza uno stato di annullamento da parte dell'utente.
Risorse correlate
- Risolvi i problemi di networking di Looker (Google Cloud core): errore di timeout 504
- Visualizza i log delle istanze di Looker (Google Cloud core)
- Ricevi assistenza per Looker (Google Cloud core)