Imagina este cenário: Você está trabalhando em um projeto de desenvolvimento WordPress e tem uma dúzia ou mais plugins instalados. Entretanto, seu site não está cantarolando do jeito que você gostaria que estivesse. Você eliminou todos os suspeitos habituais: a hospedagem é adequada, não há erros óbvios de JavaScript ou PHP, e não há mais nada claramente errado. Você suspeita que um ou mais plugins que você instalou são os culpados, mas como você descobre qual plugin está causando o problema?

O método usual para identificar um plugin problemático é desativar plugins um a um até que o comportamento que você está tentando resolver pare. No entanto, com o plugin de depuração correto instalado, você pode localizar o problema mais rapidamente e com maior precisão. Este é o tipo de cenário que o Query Monitor foi feito para resolver.

O que é o Query Monitor?

O Query Monitor é um plugin gratuito de depuração e desenvolvimento para WordPress. Você pode usá-lo para identificar e depurar consultas lentas a bancos de dados, chamadas AJAX, solicitações REST API, e muito mais. Além disso, o plugin reporta detalhes do site, como dependências de script e dependentes, ganchos do WordPress que dispararam durante a geração da página, detalhes do ambiente de hospedagem, tags de consulta condicional atendidas pela página atual, e muito mais.

Consulta Monitor WordPress plugin

Consulta Monitor WordPress plugin

O plugin foi desenvolvido por John Blackbourn, um dos principais desenvolvedores de WordPress, que atualmente é um desenvolvedor da Human Made e foi anteriormente empregado pelo WordPress.com VIP – em outras palavras, alguém que realmente conhece WordPress. O Query Monitor foi adicionado ao diretório de plugins do WordPress em 2013 e atualmente possui mais de 10.000 instalações ativas – uma soma impressionante para um plugin de desenvolvimento. A classificação do usuário do plugin de cinco em cinco estrelas ajuda a explicar a sua popularidade entre os desenvolvedores.

O que o Query Monitor faz?

Muita coisa.

Nós não vamos tomar tempo para listar todos os recursos oferecidos pelo Query Monitor, mas se você quiser se aprofundar nos detalhes, dê uma olhada no Query Monitor no GitHub. Em um nível alto, o que o Query Monitor faz é assistir cada transação do WordPress que acontece no servidor, ou entre o servidor e o navegador do visitante, enquanto uma página web do WordPress é gerada. Em seguida, ele anexa um relatório ao rodapé da página web, detalhando todas as informações coletadas. Funciona em todas as páginas, incluindo /wp-admin/ páginas, para que você possa usá-lo para depurar qualquer página do front end ou back end.

O plugin tem o nome de uma característica central: o monitoramento de consultas de banco de dados. Cada consulta é monitorada, cronometrada e ligada de volta à função que a gerou. Como resultado, você pode ordenar as consultas com base no tempo que elas levam para serem processadas e localizar as consultas problemáticas e de carga lenta.

O Query Monitor também rastreia e lista os ganchos do WordPress e o aplicativo de tags condicionais para a página gerada. Como desenvolvedor, você pode usar essas informações para identificar o gancho ou a tag condicional certa para usar ao adicionar novas funcionalidades de plugin ou tema.

O Query Monitor fornece muitas informações adicionais. A melhor maneira de ter um controle sobre tudo o que é gerado pelo Query Monitor é instalá-lo em um local de teste e dar uma olhada nos relatórios.

Como usar o Query Monitor

Instale o Query Monitor usando seu método preferido: ele está no GitHub e também disponível a partir do diretório de plugins do WordPress. Uma vez instalado o plugin, a primeira coisa que você vai notar é que um novo item de menu foi adicionado à barra de administração:

Barra de administração do Query Monitor

Barra de administração do Query Monitor

A etiqueta no novo item exibe algumas métricas:

  • Tempo de geração da página,
  • Pico de utilização da memória PHP,
  • Tempo de consulta da base de dados, e
  • O número total de consultas à base de dados efetuadas.

Passe o mouse sobre a barra de administração e aparecerá um menu suspenso. Todos os dados gerados pelo Query Monitor estão contidos em um único relatório adicionado ao pé da página e dividido em várias seções. Clique em qualquer um dos itens do menu suspenso para ser levado para a seção correspondente do relatório do Query Monitor. Por exemplo, abaixo está uma captura de tela das “consultas” gerais que estão sendo executadas na página.

Consultar Query Monitor

Consultar Query Monitor

Se algum erro PHP ocorrer, ou se alguma consulta demorar muito tempo, itens adicionais serão adicionados ao menu suspenso destacando esses problemas. Clique neles para ver mais detalhes.

Você pode notar que os últimos itens da lista mudam de uma página para a próxima. Estes itens, mostrados em verde, são as etiquetas de consulta condicional satisfeitas pela página atual.

Percorra o relatório inteiro para ver a riqueza de dados gerados pelo Query Monitor. Tente os menus drop down disponíveis para filtrar os dados contidos no relatório, bem como as caixas contendo o símbolo “+”, que podem ser usadas para ver mais dados sobre muitos detalhes reportados.

Se você quiser obter ainda mais dados do Query Monitor, dê uma olhada nas adições do Query Monitor de terceiros para ver se existe um plugin que irá gerar as informações de depuração de que você precisa.

Como ver os dados do Query Monitor como um usuário logado

Quando você visualiza um site do WordPress enquanto está conectado como administrador, o site contém uma barra de administração e scripts adicionais que os visitantes desconectados não vêem. O Query Monitor permite que você veja o site enquanto estiver desconectado e ainda tenha acesso às informações de depuração. No entanto, usar este recurso pela primeira vez pode ser um pouco complicado.

Para visualizar os dados do Query Monitor como um visitante logado fora, siga estes passos:

  • Vá para a área de administração do WordPress enquanto estiver conectado como administrador e clique no item Query Monitor na barra de administração.
  • Percorra a parte inferior dos dados reportados e procure o link que diz Definir cookie de autenticação. Note que você deve estar na área de administração para ver o link. Se você procurar o link em uma página inicial, você não vai encontrá-lo.
  • Clicando nesse link, será adicionado um cookie de autenticação ao seu navegador. Dessa forma, o Query Monitor saberá exibir os resultados dos testes, mesmo que você não esteja logado.
  • Com o cookie de autenticação definido, saia do site ou mude para um perfil de usuário não-administrador usando um plugin como o User Switching.
  • Navegue até a página onde você quer ver as informações de depuração e vá até o final da página. Lá você verá uma versão condensada do relatório Query Monitor. Clique em qualquer item para expandir o relatório.

Resumo

Como desenvolvedor de WordPress, ter as ferramentas certas pode facilitar o seu trabalho. O Query Monitor é uma ferramenta gratuita com o potencial de economizar muito tempo. Você pode usá-lo para:

  • Aponte com precisão as consultas lentas e as funções que as despoletam,
  • Gerar uma lista dos ganchos do WordPress encontrados enquanto o WordPress estava gerando a página,
  • Confirme quais etiquetas condicionais se aplicam à página ou ao post atual,
  • Identificar as relações entre os recursos JavaScript,
  • Dê uma olhada nos detalhes de configuração do servidor, e
  • Muito mais.

Se você tentar o Query Monitor, há uma boa chance de que ele se torne rapidamente uma adição permanente ao seu ambiente de desenvolvimento do WordPress.

Leitura recomendada:

24
Shares