Query Monitor is the developer tools panel for WordPress.
Query Monitor is the developer tools panel for WordPress. It enables debugging of database queries, PHP errors, hooks and actions, block editor blocks, enqueued scripts and stylesheets, HTTP API calls, and more.
It includes some advanced features such as debugging of Ajax calls, REST API calls, and user capability checks. It includes the ability to narrow down much of its output by plugin or theme, allowing you to quickly determine poorly performing plugins, themes, or functions.
Query Monitor focuses heavily on presenting its information in a useful manner, for example by showing aggregate database queries grouped by the plugins, themes, or functions that are responsible for them. It adds an admin toolbar menu showing an overview of the current page, with complete debugging information shown in panels once you select a menu item.
For complete information, please see the Query Monitor website.
Here’s an overview of what’s shown for each page load:
SELECT
, UPDATE
, DELETE
, etc), responsible component (plugin, theme, WordPress core), and calling function, and provides separate aggregate views for each.is_single()
, is_home()
, etc.In addition:
qm
property of the response.By default, Query Monitor’s output is only shown to Administrators on single-site installations, and Super Admins on Multisite installations.
In addition to this, you can set an authentication cookie which allows you to view Query Monitor output when you’re not logged in (or if you’re logged in as a non-Administrator). See the Settings panel for details.
I maintain several other plugins for developers. Check them out:
Query Monitor is private by default and always will be. It does not persistently store any of the data that it collects. It does not send data to any third party, nor does it include any third party resources.
Yes, it’s actively tested and working up to PHP 8.2.
By default, Query Monitor’s output is only shown to Administrators on single-site installations, and Super Admins on Multisite installations.
In addition to this, you can set an authentication cookie which allows you to view Query Monitor output when you’re not logged in, or when you’re logged in as a user who cannot usually see Query Monitor’s output. See the Settings panel for details.
Short answer: Yes, but only a little.
Long answer: Query Monitor has a small impact on page generation time because it hooks into WordPress in the same way that other plugins do. The impact is low; typically between 10ms and 100ms depending on the complexity of your site.
Query Monitor’s memory usage typically accounts for around 10% of the total memory used to generate the page.
Yes, if anything calls do_action( 'qm/cease' )
then Query Monitor will cease operating for the remainder of the page generation. It detaches itself from further data collection, discards any data it’s collected so far, and skips the output of its information.
This is useful for long-running operations that perform a very high number of database queries, consume a lot of memory, or otherwise are of no concern to Query Monitor, for example:
A list of add-on plugins for Query Monitor can be found here.
In addition, Query Monitor transparently supports add-ons for the Debug Bar plugin. If you have any Debug Bar add-ons installed, deactivate Debug Bar and the add-ons will show up in Query Monitor’s menu.
Please use the issue tracker on Query Monitor’s GitHub repo as it’s easier to keep track of issues there, rather than on the wordpress.org support forums.
Yes, the Altis Developer Tools are built on top of Query Monitor.
Yes, it’s included as part of the VIP Go platform. However, a user needs to be granted the view_query_monitor
capability to see Query Monitor even if they’re an administrator.
Please note that information about database queries and the environment is somewhat restricted on VIP. This is a platform restriction and not a Query Monitor issue.
You’ll need to hook into the qm/collect/db_objects
filter and add an item to the array containing your wpdb
instance. For example:
add_filter( 'qm/collect/db_objects', function( $objects ) {
$objects['my_db'] = $GLOBALS['my_db'];
return $objects;
} );
Your wpdb
instance will then show up as a separate panel, and the query time and query count will show up separately in the admin toolbar menu. Aggregate information (queries by caller and component) will not be separated.
Yes. You can enable this on the Settings panel.
I am accepting sponsorships via the GitHub Sponsors program and any support you can give will help me maintain this plugin and keep it free for everyone.
In addition, if you like the plugin then I’d love for you to leave a review. Tell all your friends about it too!
posix_getpwuid()
or posix_getgrgid()
doesn’t return an expected value.switch_to_blog()
and restore_current_blog()
on Multisite installationsQM_Data
and QM_Component
classes to make the data collection more structured and reliabledashicons
dependencyshutdown
dispatcher from 0
to PHP_INT_MAX
to ensure as much data as possible is collectedQM_DARK_MODE
constantdb.php
qm/component_type/{$type}
filterQM_VERSION
constantdo_action( 'qm/cease' )
, for example to prevent memory exhaustion during long-running operationsqm/component_context/{$type}
filter to complement qm/component_name/{$type}
and qm/component_dirs
shutdown
hook.qm
property in enveloped REST API responsesQM_HIDE_SELF
constant before it’s definedQM_DB_SYMLINK
constant to prevent the db.php
symlink being put into place.SAVEQUERIES
in the query collector.scope
attributes on table cells.innodb_buffer_pool_size
variable to the mysql environment list.QM_Backtrace
.wp_die()
output.QM_HIDE_SELF
configuration constant.is_favicon()
conditional added in WP 5.4.QM_Util::get_file_dirs()
and get_file_component()
to allow support for non-standard plugin and theme locations.found_formatted
property because this can fire before WPML has initialised its locale proxy. Fixes #485.WP_DEBUG_LOG
, which now accepts a path too.QM_DARK_MODE
.SAVEQUERIES
is defined as false.wpdb
instances.get_template_part
action in WP 5.2.ul
, nav
, and li
styling.ajaxurl
if there are no Debug Bar panels to show.ver
parameter for enqueued scripts and styles.Core
and Non-Core
filter items to the bottom of the list, so plugins and themes takes precedence.