Looker(Google Cloud 핵심 서비스)에서 대화형 쿼리를 실행하면 쿼리가 Explore UI 또는 대시보드에서 무기한 실행되는 것처럼 보일 수 있습니다. 하지만 백엔드 데이터베이스 로그에 따르면 쿼리가 20~30초 후에 명시적으로 취소되었습니다.
이 페이지에서는 이 동작이 발생하는 이유와 중간 네트워크 인프라에서 제한 시간 설정을 조정하여 이 문제를 해결하는 방법을 설명합니다. 이 가이드는 Looker(Google Cloud 핵심 서비스)에서 네트워크 라우팅을 관리하고 쿼리 문제를 해결하는 관리자를 대상으로 합니다.
증상
Explore 또는 대시보드에서 대화형 쿼리를 실행하면 다음과 같은 증상이 발생할 수 있습니다.
- Looker 사용자 인터페이스: Looker Explore UI 또는 대시보드 타일이 무기한으로 실행 중(회전) 상태로 유지되고 결과를 반환하거나 오류를 표시하지 않습니다.
- 백엔드 데이터베이스 실행 시간: 백엔드 데이터베이스(예: BigQuery, Snowflake, PostgreSQL)에서 쿼리는 짧은 시간(일반적으로 20~30초) 후에 취소됩니다.
- 백엔드 데이터베이스 쿼리 로그: 백엔드 데이터베이스의 쿼리 기록 또는 감사 로그에 따르면 쿼리를 취소하거나 브라우저 탭을 닫지 않았더라도 사용자가 작업을 명시적으로 취소한 것으로 나타납니다.
원인
이 문제는 Looker의 세션 하트비트 메커니즘과 브라우저와 Looker(Google Cloud 핵심 서비스) 인스턴스 간에 트래픽을 라우팅하는 중간 네트워크 기기에 구성된 제한 시간 설정이 일치하지 않기 때문에 발생합니다.
세션 하트비트 및 쿼리 중단 메커니즘
데이터베이스 리소스 사용량을 효율적으로 관리하기 위해 Looker(Google Cloud 핵심 서비스)는 쿼리 실행 중에 다음 메커니즘을 통해 클라이언트 연결을 모니터링합니다.
- 지속적인 하트비트: Looker UI에서 대화형 쿼리를 실행하면 웹브라우저가 활성 연결을 유지하고 Looker(Google Cloud 핵심 서비스) 인스턴스에 지속적인 하트비트 신호를 전송하여 쿼리 세션을 활성 상태로 유지합니다.
- 중간 연결 제한 시간: 애플리케이션 부하 분산기, 기업 리버스 프록시, 웹 애플리케이션 방화벽(WAF) 또는 VPN 게이트웨이와 같은 중간 네트워크 기기에 유휴 또는 응답 제한 시간 구성이 짧은 경우(예:Google Cloud 애플리케이션 부하 분산기의 기본 30초 백엔드 서비스 제한 시간) 쿼리 런타임이 해당 기준점을 초과하면 기기가 연결을 조기에 닫거나 삭제합니다.
- 쿼리 중단 감지: 중간 연결이 종료되면 Looker(Google Cloud 핵심 서비스)가 브라우저에서 하트비트 신호 수신을 중지합니다. 하트비트 신호가 없는 상태로 약 30초가 지나면 Looker(Google Cloud 핵심 서비스)는 클라이언트 세션에 더 이상 연결할 수 없음을 감지하고 쿼리를 중단된 것으로 식별합니다.
- 데이터베이스 정리: 사용자가 기다리지 않는 쿼리에 불필요한 데이터베이스 컴퓨팅 리소스를 사용하지 않도록 Looker(Google Cloud 핵심 서비스)는 백엔드 데이터베이스에 취소 요청을 자동으로 전송합니다. Looker는 쿼리를 실행한 사용자를 대신하여 취소를 실행하므로 데이터베이스 로그는 사용자가 작업을 취소한 것으로 기록합니다.
- UI에서 무기한 실행 상태: 중간 프록시 또는 게이트웨이가 브라우저와 Looker(Google Cloud 핵심 서비스) 간의 연결을 종료했기 때문에 브라우저가 취소 상태 또는 오류 응답을 수신하지 않습니다. 따라서 Looker Explore UI 또는 대시보드 타일이 실행 중 상태로 유지됩니다.
문제 파악
중간 네트워크 제한 시간으로 인해 쿼리가 취소되었는지 확인하려면 다음 단계를 따르세요.
- 데이터베이스 쿼리 로그 확인: 취소된 쿼리의 백엔드 데이터베이스에서 실행 기록을 검토합니다.
- BigQuery에서Google Cloud 콘솔의 쿼리 기록 페이지로 이동하거나 Google Cloud 콘솔에서 프로젝트의 작업 기록을 확인하고 실패한 작업을 찾습니다. 작업 세부정보를 확인하여 약 20~30초 후에 취소 상태로 쿼리가 취소되었는지 확인합니다.
- Snowflake에서 Snowsight의
QUERY_HISTORY뷰 또는 기록 탭을 검사합니다. 쿼리 상태가FAILED_WITH_ERROR로 표시되는지 또는 약 30초 후에 사용자가 쿼리를 취소했음을 나타내는지 확인합니다. - PostgreSQL에서 쿼리의 타임스탬프와 일치하는
canceling statement due to user request과 같은 메시지의 서버 로그를 검토합니다.
- 쿼리 기간 확인: 데이터베이스 로그에서 취소되기 전 쿼리의 정확한 기간을 확인합니다. 쿼리가 약 30초(또는 프록시나 부하 분산기에 구성된 제한 시간 한도)에 지속적으로 취소되는 경우 중간 네트워크 제한 시간으로 인해 취소가 트리거되었을 수 있습니다.
- 중간 네트워크 인프라 확인: 사용자 브라우저와 Looker(Google Cloud 핵심 서비스) 인스턴스 간의 네트워크 경로에서 리버스 프록시, 부하 분산기 또는 VPN을 식별합니다.
해결 방법
이 문제를 해결하려면 사용자 브라우저와 Looker(Google Cloud 핵심 서비스) 인스턴스 간에 트래픽을 라우팅하는 모든 네트워크 기기에서 유휴 및 응답 제한 시간 설정을 늘립니다. 제한 시간 한도를 가장 오래 실행되는 대화형 쿼리의 예상 기간보다 높게 설정합니다.
애플리케이션 부하 분산기 백엔드 서비스 제한 시간 늘리기
Looker(Google Cloud 핵심 서비스) 인스턴스가 외부 또는 내부 애플리케이션 부하 분산기로 프런트엔드되는 경우 다음 단계를 따르세요.
Google Cloud 콘솔에서 부하 분산 페이지로 이동합니다.
백엔드를 클릭한 다음 Looker(Google Cloud 핵심 서비스) 인스턴스와 연결된 백엔드 서비스의 이름을 클릭합니다.
수정을 클릭합니다.
제한 시간 필드에서 제한 시간 값을 늘립니다. 예를 들어 예상 쿼리 실행 시간에 따라 기본값을 30초에서 300초(5분) 이상으로 변경합니다.
저장을 클릭합니다.
프록시, WAF 또는 VPN 제한 시간 늘리기
사용자가 회사 전달 프록시, 리버스 프록시(예: NGINX 또는 Apache), WAF 또는 VPN 게이트웨이를 통해 Looker(Google Cloud 핵심 서비스)에 액세스하는 경우 다음 단계를 따르세요.
- 프록시 또는 게이트웨이 설정에서 연결, 응답 또는 유휴 제한 시간 구성을 찾습니다. 예를 들면 다음과 같습니다.
- NGINX에서
proxy_read_timeout및proxy_send_timeout지시어를 늘립니다. - Apache에서
TimeOut또는ProxyTimeout지시문을 늘립니다. - 회사 VPN 또는 방화벽 게이트웨이에서 Looker(Google Cloud 핵심 서비스) 도메인에 대한 HTTPS 트래픽의 TCP 세션 유휴 제한 시간을 늘립니다.
- NGINX에서
- 브라우저 하트비트 신호가 중단 없이 Looker(Google Cloud 핵심 서비스)에 도달하도록 프록시를 통해 장기 지속 HTTP 및 WebSocket 연결을 허용합니다.
- 구성 변경사항을 적용하고 프록시 서비스를 다시 시작하거나 새로고침합니다.
해결 방법 확인
부하 분산기 또는 중간 프록시에서 제한 시간 설정을 늘린 후 다음 단계에 따라 쿼리가 성공적으로 완료되는지 확인합니다.
- Looker(Google Cloud 핵심 서비스)에서 이전에 쿼리가 취소된 Explore 또는 대시보드로 이동합니다.
- 이전에 실패한 쿼리를 실행합니다.
- 쿼리가 취소 없이 이전 제한 시간 기준(예: 30초)을 초과하여 실행되고 UI에 결과를 표시하는지 확인합니다.
- 필요한 경우 백엔드 데이터베이스 쿼리 로그를 확인하여 작업이 사용자 취소 상태 없이 성공적으로 완료되었는지 확인합니다.
관련 리소스
- Looker(Google Cloud 핵심 서비스) 네트워킹 문제 해결: 504 시간 초과 오류
- Looker(Google Cloud 핵심 서비스)의 인스턴스 로그 보기
- Looker(Google Cloud 핵심 서비스) 지원 받기