Memecahkan masalah pembatalan kueri yang tidak terduga di Looker (Google Cloud core)

Saat Anda menjalankan kueri interaktif di Looker (Google Cloud core), kueri mungkin tampak berjalan tanpa batas waktu di UI Explore atau di dasbor. Namun, log database backend menunjukkan bahwa kueri dibatalkan secara eksplisit setelah 20 hingga 30 detik.

Halaman ini menjelaskan alasan perilaku ini terjadi dan cara mengatasinya dengan menyesuaikan setelan waktu tunggu pada infrastruktur jaringan perantara Anda. Panduan ini ditujukan untuk administrator yang mengelola pemilihan rute jaringan dan memecahkan masalah kueri di Looker (Google Cloud core).

Gejala

Saat menjalankan kueri interaktif di Explore atau di dasbor, Anda mungkin mengalami gejala berikut:

  • Antarmuka pengguna Looker: UI Explore Looker atau ubin dasbor tetap dalam status Running (berputar) tanpa batas waktu dan tidak pernah menampilkan hasil atau menampilkan error.
  • Waktu eksekusi database backend: Di database backend Anda (seperti BigQuery, Snowflake, atau PostgreSQL), kueri dibatalkan setelah durasi singkat—biasanya 20 hingga 30 detik.
  • Log kueri database backend: Histori kueri atau log audit di database backend Anda menunjukkan bahwa tugas secara eksplisit dibatalkan oleh pengguna, meskipun Anda tidak membatalkan kueri atau menutup tab browser.

Penyebab

Masalah ini terjadi karena ketidakcocokan antara mekanisme heartbeat sesi Looker dan setelan waktu tunggu yang dikonfigurasi pada perangkat jaringan perantara yang merutekan traffic antara browser Anda dan instance Looker (Google Cloud core).

Mekanisme heartbeat sesi dan pengabaian kueri

Untuk mengelola penggunaan resource database secara efisien, Looker (Google Cloud core) memantau konektivitas klien selama eksekusi kueri melalui mekanisme berikut:

  • Heartbeat berkelanjutan: Saat Anda menjalankan kueri interaktif di UI Looker, browser web Anda mempertahankan koneksi aktif dan mengirimkan sinyal heartbeat berkelanjutan ke instance Looker (Google Cloud core) untuk menjaga sesi kueri tetap aktif.
  • Waktu tunggu koneksi perantara: Jika perangkat jaringan perantara—seperti Load Balancer Aplikasi, reverse proxy perusahaan, Web Application Firewall (WAF), atau gateway VPN—memiliki konfigurasi waktu tunggu tidak ada aktivitas atau respons yang singkat (misalnya, waktu tunggu layanan backend default 30 detik di Google Cloud Load Balancer Aplikasi), perangkat akan menutup atau menghentikan koneksi sebelum waktunya saat runtime kueri melebihi batas tersebut.
  • Deteksi pengabaian kueri: Setelah koneksi perantara ditutup, Looker (Google Cloud core) akan berhenti menerima sinyal heartbeat dari browser Anda. Setelah sekitar 30 detik tanpa sinyal heartbeat, Looker (Google Cloud core) mendeteksi bahwa sesi klien tidak lagi dapat dijangkau dan mengidentifikasi kueri sebagai ditinggalkan.
  • Pembersihan database: Untuk menghindari penggunaan resource komputasi database yang tidak perlu pada kueri yang tidak ditunggu oleh pengguna, Looker (Google Cloud core) otomatis mengirimkan permintaan pembatalan ke database backend Anda. Karena Looker mengeluarkan pembatalan atas nama pengguna yang menjalankan kueri, log database mencatat bahwa tugas dibatalkan oleh pengguna.
  • Status berjalan tanpa batas waktu di UI: Karena proxy atau gateway perantara menutup koneksi antara browser Anda dan Looker (Google Cloud core), browser Anda tidak pernah menerima status pembatalan atau respons error. Akibatnya, UI Explore Looker atau ubin dasbor tetap macet dalam status Running.

Mengidentifikasi masalah

Untuk menentukan apakah pembatalan kueri Anda disebabkan oleh waktu tunggu jaringan perantara, ikuti langkah-langkah berikut:

  1. Periksa log kueri database: Tinjau histori eksekusi di database backend Anda untuk kueri yang dibatalkan:
    • Di BigQuery, buka halaman Query history di konsolGoogle Cloud atau periksa histori tugas project di konsol Google Cloud dan temukan tugas yang gagal. Periksa detail tugas untuk mengonfirmasi bahwa kueri dibatalkan setelah sekitar 20 hingga 30 detik dengan status pembatalan.
    • Di Snowflake, periksa tampilan QUERY_HISTORY atau tab History di Snowsight. Periksa apakah status kueri menampilkan FAILED_WITH_ERROR atau menunjukkan bahwa kueri dibatalkan oleh pengguna setelah sekitar 30 detik.
    • Di PostgreSQL, tinjau log server untuk menemukan pesan seperti canceling statement due to user request yang cocok dengan stempel waktu kueri Anda.
  2. Verifikasi durasi kueri: Di log database, catat durasi persis kueri sebelum dibatalkan. Jika kueri terus-menerus dibatalkan sekitar 30 detik (atau sekitar batas waktu tunggu yang dikonfigurasi pada proxy atau load balancer Anda), waktu tunggu jaringan perantara kemungkinan memicu pembatalan.
  3. Periksa infrastruktur jaringan perantara: Identifikasi reverse proxy, load balancer, atau VPN apa pun di jalur jaringan antara browser pengguna Anda dan instance Looker (Google Cloud core).

Resolusi

Untuk mengatasi masalah ini, tingkatkan setelan waktu tunggu tidak ada aktivitas dan respons di semua perangkat jaringan yang merutekan traffic antara browser pengguna dan instance Looker (Google Cloud core). Tetapkan batas waktu tunggu lebih tinggi dari durasi yang diharapkan dari kueri interaktif yang berjalan paling lama.

Meningkatkan waktu tunggu layanan backend Load Balancer Aplikasi

Jika instance Looker (Google Cloud core) Anda dihadapkan oleh Load Balancer Aplikasi eksternal atau internal, ikuti langkah-langkah berikut:

  1. Di konsol Google Cloud , buka halaman Load balancing:

    Buka Load balancing

  2. Klik Backends, lalu klik nama layanan backend yang terkait dengan instance Looker (Google Cloud core) Anda.

  3. Klik Edit.

  4. Di kolom Timeout, tingkatkan nilai waktu tunggu. Misalnya, ubah nilai default dari 30 detik menjadi 300 detik (5 menit) atau lebih tinggi, bergantung pada waktu eksekusi kueri yang Anda harapkan.

  5. Klik Simpan.

Meningkatkan waktu tunggu proxy, WAF, atau VPN

Jika pengguna Anda mengakses Looker (Google Cloud core) melalui proxy penerusan perusahaan, reverse proxy (seperti NGINX atau Apache), WAF, atau gateway VPN, ikuti langkah-langkah berikut:

  1. Temukan konfigurasi waktu tunggu koneksi, respons, atau tidak ada aktivitas di setelan proxy atau gateway Anda, seperti contoh berikut:
    • Di NGINX, tingkatkan perintah proxy_read_timeout dan proxy_send_timeout.
    • Di Apache, tingkatkan perintah TimeOut atau ProxyTimeout.
    • Di VPN perusahaan atau gateway firewall, tingkatkan waktu tunggu tidak ada aktivitas sesi TCP untuk traffic HTTPS ke domain Looker (Google Cloud core).
  2. Izinkan koneksi HTTP dan WebSocket yang berjalan lama melalui proxy agar sinyal heartbeat browser mencapai Looker (Google Cloud core) tanpa gangguan.
  3. Terapkan perubahan konfigurasi dan mulai ulang atau muat ulang layanan proxy.

Memastikan masalah telah teratasi

Setelah meningkatkan setelan waktu tunggu di load balancer atau proxy perantara, ikuti langkah-langkah berikut untuk memverifikasi bahwa kueri berhasil diselesaikan:

  1. Di Looker (Google Cloud core), buka Explore atau dasbor tempat kueri sebelumnya dibatalkan.
  2. Jalankan kueri yang sebelumnya gagal.
  3. Pastikan kueri dijalankan melewati batas waktu tunggu sebelumnya (seperti 30 detik) tanpa pembatalan dan menampilkan hasil di UI.
  4. Secara opsional, periksa log kueri database backend Anda untuk mengonfirmasi bahwa tugas berhasil diselesaikan tanpa status pembatalan pengguna.