슬로우 쿼리

슬로우 쿼리 화면에서 DB 파라미터에 설정된 기준 시간을 초과한 느린 SQL을 모니터링하고 확인할 수 있습니다. PostgreSQL은 슬로우 쿼리를 로그 파일로 기록하지만, 이를 확인하려면 DB 서버에 터미널로 접속하여 텍스트 로그를 직접 읽어야 합니다. 슬로우 쿼리 로그를 실시간으로 수집하여 시각적인 차트와 목록으로 제공합니다.

Slow Query 차트에서 느린 쿼리의 발생 시점과 수행 시간을 시각적으로 파악할 수 있습니다.
Slow Query List에서 개별 쿼리의 상세 정보를 확인하고, 실행 계획(Plan)을 조회할 수 있습니다.
실시간(Live) 모드와 과거 시간 조회를 모두 지원합니다.

노트

슬로우 쿼리 수집을 위해 추가 에이전트가 필요합니다. 온프레미스 환경은 XOS 에이전트, 클라우드(AWS RDS 등) 환경은 DBXC 에이전트를 설치해야 합니다.

팁

슬로우 쿼리 차트는 대시보드의 SQL Elapse Map 차트와 유사하지만, 다음과 같은 차이가 있습니다.

표 | 슬로우 쿼리 차트와 SQL Elapse Map 차트의 차이점

구분	슬로우 쿼리	SQL Elapse Map
데이터 소스	DB가 남기는 슬로우 쿼리 로그	에이전트가 5초 간격으로 수집하는 액티브 세션
수행 시간 정확도	DB가 기록한 실제 수행 시간으로 정확함	5초 간격 수집으로 최대 5초의 오차 발생 가능
수집 대상	설정 기준 시간(`log_min_duration_statement`)을 초과한 쿼리만	수집 시점에 실행 중인 모든 액티브 세션

사전 설정

이 화면에 데이터를 표시하려면 DB 설정, DBX Agent 설정, 환경에 따라 XOS Agent 또는 DBXC Agent 설정이 필요합니다.

DB 설정

postgresql.conf에서 슬로우 쿼리 기준 시간을 설정합니다. 변경 후 PostgreSQL 재시작 또는 pg_reload_conf() 실행이 필요합니다.

postgresql.conf
log_min_duration_statement = 500

파라미터	설명
`log_min_duration_statement`	설정값(밀리초)을 초과하는 SQL을 로그에 기록합니다. 예: `500`이면 500ms 이상 소요되는 SQL이 기록됩니다.

DBX Agent 설정

whatap.conf에 다음 설정을 추가합니다.

whatap.conf
slow_query_log=ON

설정 항목	타입	기본값	설명
`slow_query_log`	String	`OFF`	슬로우 쿼리 로그 수집 활성화

OS 에이전트 설정

슬로우 쿼리 로그를 수집하려면 DB 운영 환경에 맞는 에이전트가 필요합니다.

환경	필요 에이전트	주요 설정	참고. 설정 안내
온프레미스(Linux, Windows)	XOS 에이전트	없음 (자동 인식 실패 시 `slow_query=`에 로그 파일 경로 직접 지정)	XOS 에이전트 설정
클라우드(AWS RDS, NCP 등)	DBXC 에이전트	`slow_query: true` (config.yaml 인스턴스별 설정)	DBXC 에이전트 설정