본문으로 건너뛰기

Query Monitor 플러그인은 무엇이며 어떻게 활용하나요?

💡 요약 정리
  • 페이지 속도와 트래픽, DB 쿼리, 오류 등 핵심 성능 지표를 관리자 패널에서 한눈에 확인할 수 있습니다.
  • 상단 요약 패널을 클릭하면 하단에 상세 리포트가 열리고, 탭(Overview, Queries, Logs 등)별로 원인 분석이 가능합니다.
  • DB 쿼리 지연, PHP 오류 위치, HTTP API 호출, 리다이렉션 원인, 스크립트/스타일 로딩 위치까지 꼼꼼히 점검할 수 있습니다.
  • 일반 사용자도 속도·트래픽 확인이 쉽고, 개발자는 훅(Hook), 함수 호출 등 심층 정보를 확인할 수 있습니다.
  • Logs 기능은 기본 비활성화이며, 공식 로깅 가이드로 필요한 영역만 선택적으로 기록할 수 있습니다.

1. 플러그인 소개 및 주요 기능

Query Monitor 플러그인은 사이트 접속 응답 시간과 트래픽 정보를 요약하여 보여주는 성능/오류 진단 도구입니다. 응답이 지연되는 구간, 오류 발생 위치, 시스템 정보를 워드프레스 관리자 패널에서 쉽게 점검할 수 있습니다.

기본 제공 기능은 다음과 같습니다.

  • 브라우저 상단에 접근한 페이지에 소요된 시간과 발생한 트래픽을 표시합니다.
  • 접근 시 발생한 DB 쿼리 정보를 확인할 수 있습니다.
  • PHP 오류 발생 여부를 알려주고 문제 위치를 제공합니다.
  • 사용된 스크립트(JavaScript, CSS 등)를 나열하여 보여줍니다.
  • 페이지 접근 시 발생한 HTTP API 정보를 제공합니다.
  • 워드프레스 코어 함수와 Hook 정보를 제공합니다.
  • 리다이렉션(30x) 발생 시 특정 HTTP 헤더를 추가해 원인을 확인할 수 있도록 합니다.
  • 서버 시스템 정보와 워드프레스 전역 설정값을 제공합니다.

관리자 인증 후 상단 패널에 소요 시간과 트래픽량이 출력됩니다. 해당 패널을 클릭하면 브라우저 하단에 상세 리포트 패널이 열립니다.

Query Monitor 상단 요약 패널 예시
  • 상단 패널에서 요약 수치를 보고, 클릭하여 하단 상세 정보 패널을 열 수 있습니다.

2. Overview

페이지 로드에 소요된 시간, 메모리 사용량, 발생한 쿼리 개수, HTTP API 요청 개수, 캐싱 처리 비율 등을 요약해서 보여줍니다.

Overview 탭 요약 정보 화면
  • 핵심 지표를 한 화면에서 확인하여 병목 구간을 빠르게 파악합니다.

3. Queries

사용된 모든 DB 쿼리 정보를 보여줍니다. 코어, 플러그인 등 발생 위치와 쿼리 실행 시간 등 상세 정보를 제공합니다. 실제 조회된 rows 개수와 어떤 함수로 쿼리가 발생했는지도 확인할 수 있습니다.

Queries 탭 상세 정보 화면
  • 성능 저하의 주요 원인인 느린 쿼리, 중복 쿼리, 특정 플러그인 쿼리를 빠르게 식별할 수 있습니다.

하위 분류

  1. Duplicate queries
    • 중복으로 실행된 쿼리를 보여줍니다. 특정 요청으로 인해 반복 실행된 쿼리를 확인합니다.
  2. Queries by Caller
    • 쿼리를 호출한 요청 값과 함수 정보로 분류해 보여줍니다.
  3. Queries by Component
    • 코어/플러그인 등 발생 컴포넌트별로 분류해 보여줍니다.

4. Logs

Logs는 기본 비활성화입니다. 필요한 로깅 영역을 직접 지정해 활성화할 수 있습니다. 설정 방법은 아래 공식 문서를 참고하세요.

Logs 탭 설정 안내 화면
  • 필요한 변수나 구간만 선별해 로깅하면 분석이 더 쉬워집니다.

5. Request

접속 시 발생한 요청/응답 헤더 정보와 사용된 Hook 정보를 요약해 보여줍니다.

Request 탭 요청·응답 헤더 및 Hook 사용 정보
  • 요청-응답의 흐름과 적용된 Hook을 한눈에 파악해 문제 지점을 빠르게 찾습니다.

세부 항목

  1. request headers
    • 요청 헤더 정보
  2. response headers
    • 응답 헤더 정보
  3. Hook in Use
    • 사용된 Hook 정보와 Hook이 정의된 위치

6. Template

사용 중인 테마, 템플릿 파일 구조, 클래스 정보를 확인할 수 있습니다.

Template 탭 테마 및 템플릿 구조 정보
  • 테마 파일 경로와 로딩된 템플릿을 확인해 레이아웃 문제를 진단합니다.

7. Scripts

사용된 JavaScript의 로딩 위치(header, body, footer 등)와 연관된 컴포넌트 정보를 보여줍니다.

Scripts 탭 스크립트 로딩 위치 정보
  • 스크립트의 위치와 의존성을 확인해 렌더링 지연 원인을 점검합니다.

8. Styles

사용된 스타일시트 목록과 페이지 내 적용 위치, 소스 파일 정보를 제공합니다.

Styles 탭 스타일시트 적용 정보
  • 불필요한 CSS 로딩이나 중복 선언을 확인해 최적화에 활용합니다.

9. HTTP API Calls

페이지에 사용된 HTTP API 요청 내역을 보여줍니다. 외부 또는 내부로 발생한 API 요청 정보를 바로 확인할 수 있습니다.

HTTP API Calls 탭 요청 내역
  • 외부 연동 지연, 타임아웃, 오류 응답 등의 원인을 파악할 수 있습니다.

10. Environment

서비스와 연관된 서버 설정값을 출력합니다.

Environment 탭 서버 환경 설정 정보
  • PHP, 데이터베이스, 서버 자원 등의 설정 상태를 확인해 환경 문제를 점검합니다.

참고: 워드프레스 hook, filter, action에 대한 기술/가이드는 아래 문서를 참고하세요.