Descrição
O Query Monitor é um painel de ferramentas para desenvolvedores do WordPress e WooCommerce. Ele permite a depuração de consultas ao bancos de dados, erros de PHP, ganchos e ações, blocos do editor de blocos, scripts e folhas de estilo enfileirados, chamadas de API HTTP e muito mais.
Ele inclui alguns recursos avançados, como depuração de chamadas Ajax, chamadas de API REST, verificações de capacidade de usuário e suporte completo para temas de bloco e edição completa do site. Possui a capacidade de filtrar grande parte de sua saída por plugin ou tema, permitindo que você identifique rapidamente plugins, temas ou funções com desempenho insatisfatório.
O Query Monitor concentra-se fortemente em apresentar suas informações de maneira útil, por exemplo, mostrando consultas agregadas ao banco de dados agrupadas por plugins, temas ou funções responsáveis por elas. Ele adiciona um menu da barra de ferramentas do administrador mostrando uma visão geral da página atual, com informações completas de depuração mostradas em painéis assim que você seleciona um item de menu.
O Query Monitor é compatível com versões do WordPress de até três anos atrás e a versão do PHP 7.4 ou superior.
Para informações completas, consulte o site do Query Monitor.
Aqui está uma visão geral do que é mostrado para cada carregamento de página:
- Consultas ao banco de dados, incluindo notificações para consultas lentas, duplicadas ou errôneas. Permite filtragem por tipo de consulta (
SELECT,UPDATE,DELETE, etc), componente responsável (plugin, tema, arquivos básicos do WordPress) e função de chamada, e fornece visualizações agregadas separadas para cada um. - O nome de arquivo do modelo, a hierarquia completa do modelo e os nomes de todas as partes do modelo que foram carregadas ou não carregadas (para temas de bloco e temas clássicos).
- Erros de PHP apresentados de forma clara, juntamente com seu componente responsável e pilha de chamadas, além de um aviso visível na barra de ferramentas do administrador.
- Uso da funcionalidades “Fazendo errado” ou “Obsoleto” no código do seu site.
- Blocos e propriedades associadas no conteúdo do post e na edição completa do site (FSE).
- Regras de reescrita correspondentes, strings de consulta associadas e variáveis de consulta.
- Scripts e folhas de estilo enfileirados, juntamente com suas dependências, dependentes e alertas para dependências quebradas.
- Configurações de idioma e arquivos de tradução carregados (arquivos MO e arquivos JSON) para cada domínio de texto.
- Solicitações de API HTTP, com código de resposta, componente responsável e tempo gasto, com alertas para solicitações com falhas ou erros.
- Verificações de capacidade do usuário, juntamente com o resultado e quaisquer parâmetros passados para a verificação de capacidade.
- Informações sobre o ambiente, incluindo informações detalhadas sobre o PHP, o banco de dados, o WordPress e o servidor Web.
- Os valores de todas as funções condicionais do WordPress, como
is_single(),is_home(), etc. - Transientes que foram atualizados.
- Uso do
switch_to_blog()erestore_current_blog()em instalações Multisite.
Além disso:
- Sempre que ocorre um redirecionamento, o Query Monitor adiciona um cabeçalho HTTP contendo a pilha de chamadas, para que você possa usar seu inspetor HTTP favorito ou as ferramentas de desenvolvimento do navegador para rastrear o que acionou o redirecionamento.
- A resposta de qualquer solicitação Ajax iniciada pelo jQuery na página conterá várias informações de depuração em seus cabeçalhos. Erros de PHP também são exibidos no console do desenvolvedor do navegador.
- A resposta de uma solicitação autenticada da API REST do WordPress conterá uma visão geral das informações de desempenho e erros de PHP em seus cabeçalhos, desde que o usuário autenticado tenha permissão para visualizar a saída do Query Monitor. Uma solicitação de API REST encapsulada incluirá ainda mais informações de depuração na propriedade
qmda resposta.
Por padrão, a saída do Query Monitor é mostrada apenas para administradores em instalações de site único e super administradores em instalações multisite.
Além disso, você pode definir um cookie de autenticação que permite visualizar a saída do Query Monitor quando você não estiver conectado (ou se estiver conectado como um não administrador). Consulte o painel de Configurações para detalhes.
Extensão do navegador
O Query Monitor também está disponível como uma extensão opcional, para as ferramentas de desenvolvimento do navegador. Esta é uma alternativa ao uso do painel integrado à página, cujas informações são exibidas na barra de ferramentas administrativa.
O uso da extensão do navegador tem algumas vantagens em relação ao painel na própria página:
- O painel do Query Monitor não ocupa espaço na página que você está inspecionando
- O painel pode ser redimensionado, desacoplado e movido, da mesma forma que qualquer outro painel de ferramentas para desenvolvedores
As informações sobre a extensão do navegador do Query Monitor, podem ser encontradas aqui.
Outros plugins
Mantenho vários outros plugins para desenvolvedores. Confira-os:
- O User Switching oferece alternância instantânea entre contas de usuário no WordPress.
- O WP Crontrol permite visualizar e controlar o que está acontecendo no sistema WP-Cron
Obrigado
O tempo que dedico à manutenção deste plugin e de outros é, em parte, patrocinado por:
Declaração de privacidade
O Query Monitor é privado por padrão e sempre será. Ele não armazena permanentemente nenhum dos dados que coleta. Ele não envia dados a terceiros, nem inclui recursos de terceiros. A declaração de privacidade completa do Query Monitor pode ser encontrada aqui.
Declaração de acessibilidade
O Query Monitor visa ser completamente acessível a todos os seus usuários. A declaração de acessibilidade completa do Query Monitor pode ser encontrada aqui.
Capturas de tela







Perguntas frequentes
Esse plugin funciona com o PHP 8?
Sim, ele foi testado ativamente e está funcionando até o PHP 8.5.
Quem pode ver o resultado do Query Monitor?
Por padrão, a saída do Query Monitor é mostrada apenas para administradores em instalações de site único e super administradores em instalações multisite.
Além disso, você pode definir um cookie de autenticação que permite visualizar a saída do Query Monitor quando você não estiver conectado ou quando estiver conectado como um usuário que normalmente não pode ver a saída do Query Monitor. Consulte o painel de Configurações para mais detalhes.
O Query Monitor em si afeta o tempo de geração da página ou no uso de memória?
Resposta curta: Sim, mas só um pouco.
Resposta longa: O Query Monitor tem um pequeno impacto no tempo de geração da página porque se conecta a alguns recursos do WordPress da mesma forma que outros plugins. O impacto é insignificante.
Em páginas que têm um número especialmente alto de consultas ao banco de dados (na casa de centenas), o Query Monitor atualmente usa mais memória do que eu gostaria. Isso se deve à quantidade de dados que é capturada no rastreamento de pilha para cada consulta. Tenho trabalhado e continuarei trabalhando para reduzir isso continuamente.
Posso impedir que o Query Monitor colete dados durante solicitações de longa duração?
Sim, você pode chamar
do_action( 'qm/cease' )para instruir o Query Monitor a parar de operar durante o restante da geração da página. Ele se desvinculará da coleta de dados adicionais, descartará todos os dados coletados até o momento e ignorará a saída de suas informações.Isso é útil para operações de longa duração que executam um número muito alto de consultas ao banco de dados, consomem muita memória ou não são de interesse do Query Monitor, por exemplo:
- Fazendo backup ou restaurando seu site
- Importação ou exportação de uma grande quantidade de dados
- Executando varreduras de segurança
Existem plugins complementares para o Query Monitor?
Uma lista de plugins complementares para o Query Monitor pode ser encontrada aqui.
Além disso, o Query Monitor oferece suporte transparente a complementos para o plugin Debug Bar. Se você tiver algum complemento do Debug Bar instalado, desative o Debug Bar e os complementos serão mostrados no menu do Query Monitor.
Onde posso sugerir um novo recurso ou relatar um erro?
Use o rastreador de problemas no repositório GitHub do Query Monitor, pois é mais fácil acompanhar os problemas lá do que nos fóruns de suporte do wordpress.org.
O Query Monitor já está incluído na minha hospedagem?
Algumas hospedagens incluem o Query Monitor como parte da sua plataforma de hospedagem, o que significa que você não precisa instalá-lo manualmente. Aqui estão algumas que eu conheço:
- Altis Cloud.
- WordPress VIP, embora os usuários precisem receber a permissão para o recurso
view_query_monitormesmo que sejam administradores. Veja a documentação do WordPress VIP para mais detalhes.
Posso clicar nos rastreamentos de pilha para abrir o arquivo em meu editor?
Sim, você pode ativar isso no painel de Configurações.
Como posso relatar um erro de segurança?
Você pode enviar um relatório privado sobre vulnerabilidades de segurança ao Query Monitor através da aba Segurança no repositório do GitHub. O processo de Alerta de Segurança do GitHub facilita a colaboração privada em questões de segurança. Você irá receber crédito por um relatório válido e um CVE, se necessário.
Não relate problemas de segurança nos fóruns de suporte do WordPress.org nem por e-mail. Agradecemos.
Você aceita doações?
Estou aceitando patrocínios pelo programa GitHub Sponsors. Se você trabalha em uma agência que desenvolve com o WordPress, peça à sua empresa para patrocinar a fim de investir em sua cadeia de suprimentos. As ferramentas que mantenho provavelmente economizam tempo e dinheiro para sua empresa, e o patrocínio no GitHub agora pode ser feito em nível organizacional.
Além disso, se você gostar do plugin, adoraria que você deixasse uma avaliação. Conte a todos os seus amigos sobre ele também!
Avaliações
Colaboradores e desenvolvedores
“Query Monitor” é um programa de código aberto. As seguintes pessoas contribuíram para este plugin.
ColaboradoresQuery Monitor” foi traduzido para 26 localidades. Agradecemos aos tradutores por suas contribuições.
Traduzir o “Query Monitor” para seu idioma.
Interessado no desenvolvimento?
Navegue pelo código, consulte o repositório SVN ou assine o registro de desenvolvimento por RSS.
Registro de alterações
4.0.7 (20 de junho de 2026)
- Confirmada a compatibilidade com o WordPress 7.0
- Melhora o menu da barra administrativa
- Mostra consultas ao banco de dados na linha do tempo, mesmo quando o arquivo “db.php” não está disponível
- Adiciona mais destaque para erros relacionados a dependências de JavaScript e CSS enfileiradas
- Adiciona certa compatibilidade com versões anteriores do navegador Chrome
4.0.6 (11 de abril de 2026)
A versão 4 do Query Monitor adiciona uma nova visualização de linha do tempo e muda da renderização dos painéis no servidor em PHP, para uma renderização eficiente no cliente em Preact.
A versão 4.0.6 corrige um problema de compatibilidade com o tema GeneratePress.
Mais informações em querymonitor.com/4.
4.0.5 (10 de abril de 2026)
A versão 4 do Query Monitor adiciona uma nova visualização de linha do tempo e muda da renderização dos painéis no servidor em PHP, para uma renderização eficiente no cliente em Preact.
A versão 4.0.5 corrige o seguinte:
- Garante que as tags de script de fechamento dentro dos dados não quebrem a exibição
- Adiciona os dados de “Fazendo errado” à visualização da linha do tempo
Mais informações em querymonitor.com/4.
4.0.4 (10 de abril de 2026)
A versão 4 do Query Monitor adiciona uma nova visualização de linha do tempo e muda da renderização dos painéis no servidor em PHP, para uma renderização eficiente no cliente em Preact.
A versão 4.0.4 corrige o seguinte:
- Garante que o painel “Scripts” permaneça visível quando não houver scripts na fila do cabeçalho
- Corrige a exibição da formatação de números em algumas localizações
Mais informações em querymonitor.com/4.
4.0.3 (9 de abril de 2026)
A versão 4 do Query Monitor adiciona uma nova visualização de linha do tempo e muda da renderização dos painéis no servidor em PHP, para uma renderização eficiente no cliente em Preact.
A versão 4.0.3 corrige o seguinte:
- Melhora a compatibilidade com plugins que realizam consultas não UTF-8 ou usam dados não UTF-8 de outras formas
- Evita um alerta de PHP para arquivo e número de linha indefinidos em alguns frames de rastreamento de pilha
- Simplifica e padroniza o formato dos nomes usados para callbacks de fechamento
- Melhora o estilo e o layout da visualização da linha do tempo
Mais informações em querymonitor.com/4.
4.0.2 (9 de abril de 2026)
A versão 4 do Query Monitor adiciona uma nova visualização de linha do tempo e muda da renderização dos painéis no servidor em PHP, para uma renderização eficiente no cliente em Preact.
A versão 4.0.2 corrige o seguinte:
- Adiciona maior compatibilidade com versões anteriores para plugins de terceiros, que leem os coletores de dados QM e exibem seus próprios painéis
- Adiciona atualizações temporárias à visualização da linha do tempo
Mais informações em querymonitor.com/4.
4.0.1 (7 de abril de 2026)
A versão 4 do Query Monitor adiciona uma nova visualização de linha do tempo e muda da renderização dos painéis no servidor em PHP, para uma renderização eficiente no cliente em Preact.
- A versão 4.0.1 corrige um problema de compatibilidade com versões anteriores em relação a plugins que registram seus próprios menus ou submenus no Query Monitor.
Mais informações em querymonitor.com/4.
4.0.0 (7 de abril de 2026)
A versão 4 do Query Monitor adiciona uma nova visualização de linha do tempo e muda da renderização dos painéis no servidor em PHP, para uma renderização eficiente no cliente em Preact. Essa nova abordagem oferece várias vantagens:
- O desempenho é significativamente melhorado, especialmente em sites onde é realizado um grande número de consultas, ocorrem muitos erros de PHP ou é coletada uma grande quantidade de dados em um dos outros painéis.
- Isso facilita futuras melhorias, como a exibição de métricas no cliente, o carregamento tardio de dados, a exibição de dados de diferentes solicitações e uma maior flexibilidade na reorganização dos dados em diferentes visualizações.
- Os dados brutos coletados pelo Query Monitor tiveram seu tamanho e consumo de memória reduzidos e agora são exibidos na página em formato JSON. Confira o objeto
QueryMonitorDatano console do seu navegador para experimentar.
Mais informações em querymonitor.com/4.
3.20.4 (19 de março de 2026)
- Esta é uma versão de segurança, que corrige uma vulnerabilidade de XSS refletido no painel de solicitações. Todos os detalhes no comunicado de segurança.
3.20.3 (17 de março de 2026)
- Ao clicar em QM na barra de ferramentas administrativas pela segunda vez, o painel será fechado
- Melhorias na acessibilidade dos botões de alternância
- Agora, as solicitações GET da API HTTP com falha mostram um link clicável
Versões anteriores
Para acessar o registro de alterações das versões anteriores, consulte a página de versões no GitHub.
