슬로우 쿼리

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

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초의 오차 발생 가능
수집 대상	설정 기준 시간(`long_query_time`)을 초과한 쿼리만	수집 시점에 실행 중인 모든 액티브 세션

사전 설정

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

DB 설정

my.cnf(또는 my.ini)에서 슬로우 쿼리 관련 파라미터를 설정합니다. 변경 후 MySQL 재시작이 필요합니다.

slow_query_log = 1
long_query_time = 3
log_output = FILE

파라미터	설명
`slow_query_log`	슬로우 쿼리 로그 활성화 여부. `1`이면 활성화됩니다.
`long_query_time`	설정값(초)을 초과하는 SQL을 로그에 기록합니다. 예: `3`이면 3초 이상 소요되는 SQL이 기록됩니다.
`log_output`	로그 저장 방식. `FILE`이면 파일로, `TABLE`이면 `mysql.slow_log` 테이블에 기록합니다.

노트

log_output=TABLE로 설정한 경우 모니터링 계정에 조회 권한을 부여해야 합니다. 단, TABLE 모드는 슬로우 쿼리 발생량이 많을 경우 DB 성능에 영향을 줄 수 있으므로 주의가 필요합니다.

GRANT SELECT ON mysql.slow_log TO whatap;

DBX Agent 설정

whatap.conf에서 slow_query_log 옵션은 기본값이 ON이므로 별도 설정이 필요하지 않습니다.

slow_query_log=ON

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

OS 에이전트 설정

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

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