설명

Query Monitor는 워드프레스와 우커머스용 개발자 도구 패널입니다. 데이터베이스 쿼리, PHP 오류, 훅 및 동작, 블록 편집기 블록, 대기열에 추가된 스크립트 및 스타일시트, HTTP API 호출 등을 디버깅할 수 있습니다.

Ajax 호출 디버깅, REST API 호출, 사용자 기능 검사, 블록 테마 및 전체 사이트 편집에 대한 완전한 지원 등 몇 가지 고급 기능이 포함되어 있습니다. 플러그인 또는 테마별로 출력의 범위를 좁힐 수 있는 기능이 포함되어 있어 성능이 좋지 않은 플러그인, 테마 또는 기능을 빠르게 파악할 수 있습니다.

Query Monitor는 해당 쿼리를 담당하는 플러그인, 테마 또는 함수별로 그룹화된 집계 데이터베이스 쿼리를 표시하는 등 유용한 방식으로 정보를 표시하는 데 중점을 둡니다. 현재 페이지의 개요를 보여주는 관리자 도구 표시줄 메뉴가 추가되며, 메뉴 항목을 선택하면 전체 디버깅 정보가 패널에 표시됩니다.

Query Monitor는 최대 3년 전의 워드프레스 버전과 PHP 버전 7.4 이상을 지원합니다.

전체 정보는 Query Monitor 웹사이트를 참조하세요.

다음은 각 페이지 로드에 표시되는 내용에 대한 개요입니다:

느린 쿼리, 중복 쿼리 또는 오류 쿼리에 대한 알림 기능도 포함한 데이터베이스 쿼리. 쿼리 유형(SELECT, UPDATE, DELETE 등), 관련 구성 요소(플러그인, 테마, 워드프레스 코어) 및 호출 함수별로 필터 적용 및 각 유형별로 집계된 결과를 별도의 화면에 제공.
템플릿 파일 이름, 전체 템플릿 계층 구조, 로드되었거나 로드되지 않은 모든 템플릿 부분의 이름(블록 테마 및 클래식 테마의 경우).
관련 원인 구성 요소 및 호출 스택과 함께 보기 좋게 표시되는 PHP 오류 및 관리자 도구 표시줄에 표시되는 경고 메시지.
사이트의 코드에서 “잘못 수행 중” 또는 “사용 중단됨” 기능 사용.
글 콘텐츠 및 전체 사이트 편집(FSE) 내의 블록 및 관련 속성.
일치하는 rewrite 규칙, 연관된 쿼리 문자열 및 쿼리 변수.
대기열에 추가된 스크립트 및 스타일시트와 해당 종속성, 종속성 및 종속성 위반에 대한 경고.
각 텍스트 도메인에 대한 언어 설정 및 로드된 번역 파일(MO 파일 및 JSON 파일).
응답 코드, 담당 구성 요소, 소요 시간, 실패 또는 오류 요청에 대한 알림을 포함한 HTTP API 요청.
사용자 기능 검사 결과 및 기능 검사에 전달된 모든 매개변수.
PHP, 데이터베이스, 워드프레스, 웹 서버에 대한 자세한 정보를 포함한 환경 정보.
is_single(), is_home() 등과 같은 모든 워드프레스 조건부 함수의 값
업데이트된 트랜잭션.
멀티사이트 설치에서 switch_to_blog() 및 restore_current_blog() 사용.

또한

리디렉션이 발생할 때마다 Query Monitor는 호출 스택이 포함된 HTTP 헤더를 추가하므로 자주 사용하는 HTTP 인스펙터 또는 브라우저 개발자 도구를 사용하여 리디렉션을 유발한 원인을 추적할 수 있습니다.
페이지에서 jQuery로 시작된 Ajax 요청의 응답에는 헤더에 다양한 디버깅 정보가 포함됩니다. PHP 오류도 브라우저의 개발자 콘솔에 출력됩니다.
인증된 사용자가 Query Monitor의 출력을 볼 수 있는 권한이 있는 경우 인증된 워드프레스 REST API 요청의 응답에는 헤더에 성능 정보 및 PHP 오류에 대한 개요가 포함됩니다. 봉투에 포함된 REST API 요청은 응답의 qm 속성에 더 많은 디버깅 정보를 포함합니다.

기본적으로 Query Monitor의 출력은 단일 사이트 설치의 경우 관리자에게만 표시되고, 멀티사이트 설치의 경우 슈퍼 관리자에게만 표시됩니다.

이 외에도 로그인하지 않았을 때(또는 관리자가 아닌 다른 사용자로 로그인한 경우) Query Monitor 출력을 볼 수 있도록 인증 쿠키를 설정할 수 있습니다. 자세한 내용은 설정 패널을 참조하세요.

Browser extension

Query Monitor is also available as an optional browser dev tools extension. This is an alternative to using the in-page panel that gets output into the admin toolbar.

Using the browser extension has some advantages over the in-page panel:

The Query Monitor panel doesn’t take up space within the page you are inspecting
The panel can be resized, undocked, and moved around like any other developer tools panel

Information about the Query Monitor browser extension can be found here.

기타 플러그인

개발자를 위한 다른 여러 플러그인을 관리하고 있습니다. 확인해보세요:

User Switching은 워드프레스에서 사용자 계정 간에 즉시 전환할 수 있는 기능입니다.
WP Crontrol을 사용하면 WP-Cron 시스템에서 발생하는 상황을 확인하고 제어할 수 있습니다

감사 인사

이 플러그인과 다른 플러그인들을 유지 관리하는 데 소요하는 시간은 다음으로부터 일부 후원을 받고 있습니다:

개인정보 처리방침

Query Monitor는 기본적으로 비공개이며 항상 비공개로 유지됩니다. 수집한 데이터를 영구적으로 저장하지 않습니다. 제3자에게 데이터를 전송하지 않으며, 제3자 리소스도 포함하지 않습니다. Query Monitor의 전체 개인정보 처리방침은 여기에서 확인할 수 있습니다.

접근성 선언문

Query Monitor는 모든 사용자가 완전히 액세스할 수 있도록 하는 것을 목표로 합니다. Query Monitor의 전체 접근성 정책은 여기에서 확인할 수 있습니다.

스크린샷

FAQ

이 플러그인은 PHP 8에서 작동하나요?

예, 현재 활발하게 테스트 중이며 PHP 8.5까지 작동합니다.

누가 Query Monitor의 결과를 볼 수 있나요?

기본적으로 Query Monitor의 출력은 단일 사이트 설치의 경우 관리자에게만 표시되고, 멀티사이트 설치의 경우 슈퍼 관리자에게만 표시됩니다.

이 외에도 인증 쿠키를 설정하여 로그인하지 않았을 때 또는 일반적으로 Query Monitor의 출력을 볼 수 없는 사용자로 로그인한 경우에도 Query Monitor 출력을 볼 수 있도록 할 수 있습니다. 자세한 내용은 설정 패널을 참조하세요.

Query Monitor 자체가 페이지 생성 시간이나 메모리 사용량에 영향을 주나요?

짧은 답변: 예, 하지만 조금만요.

긴 답변: Query Monitor는 다른 플러그인과 같은 방식으로 워드프레스의 몇 군데에 연결되므로 페이지 생성 시간에 미치는 영향은 미미합니다. 영향은 무시해도 될 정도입니다.

데이터베이스 쿼리 수가 특히 많은(수백 개에 달하는) 페이지에서는 현재 Query Monitor가 원하는 것보다 더 많은 메모리를 사용합니다. 이는 각 쿼리에 대해 스택 추적에 캡처되는 데이터의 양이 많기 때문입니다. 저는 이 문제를 지속적으로 줄이기 위해 노력해 왔고 앞으로도 계속 노력할 것입니다.

장기 실행 요청 중에 Query Monitor가 데이터를 수집하지 못하도록 할 수 있나요?

예, do_action( 'qm/cease' )를 호출하여 Query Monitor가 나머지 페이지 생성 동안 작동을 중단하도록 지시할 수 있습니다. 그러면 Query Monitor는 더 이상의 데이터 수집을 중단하고 지금까지 수집한 데이터를 모두 삭제하며 정보 출력도 건너뜁니다.

매우 많은 수의 데이터베이스 쿼리를 수행하거나, 많은 메모리를 사용하거나, Query Monitor에 신경 쓰지 않아도 되는 장기 실행 작업에 유용합니다. 예시:

사이트 백업 또는 복원
많은 양의 데이터 가져오기 또는 내보내기
보안 검사 실행

Query Monitor용 애드온 플러그인이 있나요?

Query Monitor용 애드온 플러그인 목록은 여기에서 확인할 수 있습니다.

또한 Query Monitor는 Debug Bar 플러그인용 애드온을 투명하게 지원합니다. Debug Bar 애드온이 설치되어 있는 경우 Debug Bar를 비활성화하면 애드온이 Query Monitor의 메뉴에 표시됩니다.

새로운 기능을 제안하거나 버그를 신고하려면 어디로 문의하나요?

WordPress.org 지원 포럼보다는 Query Monitor의 GitHub 리포지토리에 있는 이슈 트래커를 사용하면 이슈를 더 쉽게 추적할 수 있으므로 이슈 트래커를 사용하세요.

Query Monitor가 이미 호스팅에 포함되어 있나요?

일부 웹 호스트는 호스팅 플랫폼의 일부로 Query Monitor를 번들로 제공하므로 직접 설치할 필요가 없습니다. 제가 알고 있는 몇 가지를 소개합니다:

Altis Cloud.
WordPress VIP, 관리자이더라도 사용자에게 view_query_monitor 기능이 부여되어야 합니다. 세부 사항은 워드프레스 VIP 문서를 참조하세요.

스택 추적을 클릭하여 편집기에서 파일을 열 수 있나요?

예. 설정 패널에서 이 기능을 활성화할 수 있습니다.

보안 버그를 신고하려면 어떻게 해야 하나요?

GitHub 리포지토리의 보안 탭을 통해 Query Monitor에 비공개 보안 취약점 보고서를 제출할 수 있습니다. GitHub 보안 권고 프로세스를 통해 보안 문제에 대한 비공개 협업이 가능합니다. 유효한 보고서를 제출하면 크레딧을 받게 되며, 필요한 경우 CVE(공개 취약점)도 부여됩니다.

보안 관련 문제는 WordPress.org 지원 포럼이나 이메일을 통해 보고하지 마세요. 감사합니다.

기부를 받나요?

GitHub 스폰서 프로그램을 통해 후원을 받고 있습니다. 워드프레스로 개발하는 에이전시에서 일하는 경우 공급망에 투자하기 위해 회사에 스폰서십을 요청하세요. 제가 관리하는 도구를 사용하면 회사의 시간과 비용을 절약할 수 있으며 이제 조직 수준에서 GitHub 후원을 할 수 있습니다.

또한 플러그인이 마음에 드신다면 리뷰를 남겨주시면 감사하겠습니다. 주변 지인들에게도 알려주세요!

후기

hupe13 2026년 8월 26일

This is an absolute must have for plugin development.

Andrea Roenning 2026년 7월 7일

This plugin does an excellent job of displaying information that is helpful in troubleshooting while working on WordPress theme and plugin development. I appreciate how PHP errors and deprecation warnings are grouped together and moved away from the published page view. Being able to see transient updates and SQL queries at a glance is so nice.

androidusercu 2026년 5월 23일

Saved my sanity today, (Orderable had been calling on a youtube link and added each page load 5s)

Mehraz Morshed 2026년 4월 20일

I've been using Query Monitor since 2023, and I honestly can't imagine debugging WordPress sites without it anymore. It's not just a plugin, it's a complete developer toolbox that sits in the admin bar. It's lightweight enough to keep running on production sites without noticeable overhead. John Blackbourn has built something truly special here. Five stars isn't enough. Thank you for this masterpiece.

casualadam 2026년 4월 8일

This plugin helped me realize a problem right in front of my eyes this whole time. A fantastic tool for troubleshooting database issues!

dochara 2026년 3월 27일

If you've even the smell of an issue with your site, this will track it down so that you can fix it. An indispensable tool for developers.

모든 469 평가 읽기

기여자 & 개발자

“Query Monitor”(은)는 오픈 소스 소프트웨어입니다. 다음의 사람들이 이 플러그인에 기여하였습니다.

John Blackbourn

“Query Monitor”(이)가 26 개 언어로 번역되었습니다. 기여해 주셔서 번역자님께 감사드립니다.

자국어로 “Query Monitor”(을)를 번역하세요.

개발에 관심이 있으십니까?

코드 탐색하기는, SVN 저장소를 확인하시거나, 개발 기록을 RSS로 구독하세요.