Query Monitor

설명

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

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

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

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

자세한 내용은 쿼리 모니터 웹사이트를 참조하세요.

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

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

또한

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

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

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

기타 플러그인

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

  • 사용자 전환은 워드프레스에서 사용자 계정 간에 즉시 전환할 수 있는 기능입니다.
  • WP 크론 컨트롤을 사용하면 WP-Cron 시스템에서 일어나는 일을 보고 제어할 수 있습니다.

Thanks

The time that I spend maintaining this plugin and others is in part sponsored by:

개인정보 처리방침

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

접근성 선언문

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

스크린샷

  • 관리자 도구 모음 메뉴
  • 컴포넌트별 데이터베이스 쿼리 집계
  • 데이터베이스 쿼리
  • Timeline
  • 훅 및 액션
  • HTTP API 요청
  • Logs

FAQ

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

Yes, it’s actively tested and working up to PHP 8.5.

누가 쿼리 모니터의 결과를 볼 수 있나요?

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

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

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

짧은 답변입니다: 예, 하지만 조금만.

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

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

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

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

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

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

쿼리 모니터용 애드온 플러그인이 있나요?

쿼리 모니터용 애드온 플러그인 목록은 여기에서 확인할 수 있습니다.

또한 쿼리 모니터는 디버그 바 플러그인용 애드온을 투명하게 지원합니다. 디버그 바 애드온이 설치되어 있는 경우 디버그 바를 비활성화하면 애드온이 쿼리 모니터의 메뉴에 표시됩니다.

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

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

쿼리 모니터가 이미 호스팅에 포함되어 있나요?

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

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

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

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

You can submit a private security vulnerability report to Query Monitor via the Security tab on the GitHub repo. The GitHub Security Advisory process facilitates private collaboration on security issues. You’ll receive credit for a valid report and a CVE if necessary.

Do not report security issues on the WordPress.org support forums or via email. Thank you.

기부를 받나요?

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

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

후기

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.
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!
2026년 2월 5일 답글 1개
Good. Shows a lot of useful stuff. Note that you will need to add /wp-content/db.php to your gitignore.
모든 466 평가 읽기

기여자 & 개발자

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

기여자

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

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

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

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

변경이력

4.0.6 (11 April 2026)

Version 4 of Query Monitor adds a new timeline view, and switches from rendering its panels server-side in PHP to efficiently rendering them client-side in Preact.

Version 4.0.6 fixes a compatibility issue with the GeneratePress theme.

More information at querymonitor.com/4.

4.0.5 (10 April 2026)

Version 4 of Query Monitor adds a new timeline view, and switches from rendering its panels server-side in PHP to efficiently rendering them client-side in Preact.

Version 4.0.5 fixes the following:

  • Ensures closing script tags within data don’t break the output
  • Adds “Doing it Wrong” data to the timeline view

More information at querymonitor.com/4.

4.0.4 (10 April 2026)

Version 4 of Query Monitor adds a new timeline view, and switches from rendering its panels server-side in PHP to efficiently rendering them client-side in Preact.

Version 4.0.4 fixes the following:

  • Ensures the Scripts panel remains visible when no scripts are enqueued in the header
  • Corrects the display of number formatting in some locales

More information at querymonitor.com/4.

4.0.3 (9 April 2026)

Version 4 of Query Monitor adds a new timeline view, and switches from rendering its panels server-side in PHP to efficiently rendering them client-side in Preact.

Version 4.0.3 fixes the following:

  • Improves compatibility with plugins that perform non-UTF8 queries or make other use of non-UTF8 data
  • Avoids a PHP warning for undefined file and line number in some stack trace frames
  • Simplifies and standardises the format of names used for closure callbacks
  • Improves styling and layout of the timeline view

More information at querymonitor.com/4.

4.0.2 (9 April 2026)

Version 4 of Query Monitor adds a new timeline view, and switches from rendering its panels server-side in PHP to efficiently rendering them client-side in Preact.

Version 4.0.2 fixes the following:

  • Adds further backwards compatibility for third-party plugins that read from the QM data collectors and output their own panels
  • Adds transient updates to the timeline view

More information at querymonitor.com/4.

4.0.1 (7 April 2026)

Version 4 of Query Monitor adds a new timeline view, and switches from rendering its panels server-side in PHP to efficiently rendering them client-side in Preact.

  • Version 4.0.1 fixes a backwards compatibility issue with plugins that register their own menus or sub-menus in Query Monitor.

More information at querymonitor.com/4.

4.0.0 (7 April 2026)

Version 4 of Query Monitor adds a new timeline view, and switches from rendering its panels server-side in PHP to efficiently rendering them client-side in Preact. This new approach provides several benefits:

  • Performance is greatly increased, particularly on sites where a large number of queries are performed, a large number of PHP errors are triggered, or a large amount of data is collected in one of the other panels.
  • Further future enhancements are facilitated, such as displaying client-side metrics, lazy-loading data, showing data from different requests, and more remixing of data into different views.
  • The raw data collected by Query Monitor has been reduced in size and memory usage, and is now exposed to the page as JSON. Take a look at the QueryMonitorData object in your browser console to play around with it.

More information at querymonitor.com/4.

3.20.4 (19 March 2026)

3.20.3 (17 March 2026)

  • Clicking QM in the the admin toolbar a second time will now close the panel
  • Improvements to accessibility of the toggle buttons
  • Failed HTTP API GET requests now show a clickable link

3.20.2 (11 December 2025)

  • 특정 조건 하에서 데이터베이스 쿼리가 수행되지 않을 때 PHP 오류가 발생하지 않도록 방지합니다.

Earlier versions

이전 버전의 변경 로그는 GitHub의 릴리스 페이지를 참조하세요.