Como registrar as requisições HTTP de saída do WordPress ?

Procédure

Quando um site WordPress comunica com um serviço externo, efetua um pedido HTTP. Estas comunicações são utilizadas, nomeadamente, para procurar atualizações, contactar uma API ou sincronizar uma extensão.

A extensão Log HTTP Requests permite registar estes pedidos para identificar um erro ou uma comunicação anormalmente lenta.

Antes de começar

Deve dispor de uma conta WordPress autorizada a instalar e ativar extensões.

Deve também poder reproduzir a ação a analisar, por exemplo o envio de um formulário, uma sincronização, uma pesquisa de atualizações ou a ligação a um serviço externo.

Instalar a extensão Log HTTP Requests

1. Inicie sessão no painel de controlo do seu site WordPress.
2. No menu à esquerda, clique em Extensões, depois em Adicionar uma extensão.
   
3. Procure a extensão Log HTTP Requests utilizando o campo de pesquisa.
   
4. Verifique se a extensão apresentada tem mesmo esse nome e, em seguida, clique em Instalar agora.
5. Quando a instalação terminar, clique em Ativar.

O registo dos novos pedidos HTTP começa assim que a extensão é ativada.

Exibir os pedidos registados

No menu à esquerda do WordPress, clique em Ferramentas, depois em Log HTTP Requests.

A tabela apresenta as principais informações sobre cada comunicação:

• URL : o endereço do serviço contactado;
• Status : o código de resposta HTTP devolvido pelo serviço;
• Runtime : a duração da comunicação, expressa em segundos;
• Date Added : a data e a hora em que o pedido foi registado.

Clique numa linha para exibir os detalhes do pedido enviado e da resposta recebida.

A interface também disponibiliza os botões Refresh para atualizar a lista e Clear log para eliminar as entradas registadas.

Reproduzir o problema a analisar

Para identificar um pedido específico:

1. Abra a página Ferramentas > Log HTTP Requests.
2. Pode clicar em Clear log para começar com uma lista vazia. Execute esta ação apenas se já não precisar das entradas existentes.
3. Volte ao seu site e reproduza a ação em causa: envie o formulário, reinicie a sincronização ou utilize a funcionalidade que apresenta problemas.
4. Regresse a Ferramentas > Log HTTP Requests, depois clique em Refresh.
5. Identifique a nova entrada com base na sua data, hora e endereço do serviço contactado.

Um código entre 200 e 299 indica geralmente que o servidor remoto respondeu corretamente. Um código que comece por 4 ou 5 indica geralmente um pedido recusado ou um erro encontrado pelo serviço remoto.

Um tempo de execução elevado pode indicar uma comunicação lenta. No entanto, não existe uma duração máxima válida em todas as situações: o resultado deve ser comparado com o funcionamento habitual do serviço em causa.

Verificar se o registo funciona

Depois de reproduzir a ação a analisar e atualizar o registo, deve aparecer uma nova linha com o endereço do serviço contactado, o respetivo código de resposta e a duração da comunicação.

Quando o diagnóstico terminar, clique em Clear log se quiser eliminar as entradas registadas. Pode então desativar e remover a extensão se já não precisar dela.

Problemas frequentes

Não vejo o botão « Adicionar uma extensão »

A sua conta WordPress provavelmente não dispõe das autorizações necessárias. Inicie sessão com uma conta de administrador.

Numa rede WordPress multisite, a instalação de extensões pode estar reservada ao superadministrador da rede.

Não encontro a extensão no menu « Definições »

A extensão está acessível em Ferramentas > Log HTTP Requests e não no menu Definições.

Nenhum novo pedido aparece

Verifique se a extensão está devidamente ativada e, em seguida, reproduza novamente a ação antes de clicar em Refresh.

Algumas comunicações não passam pela API HTTP do WordPress. Nesse caso, não podem ser registadas por esta extensão.

O registo contém demasiados pedidos

Clique em Clear log, reproduza apenas a ação a analisar e, em seguida, clique imediatamente em Refresh. Assim, poderá identificar mais facilmente a comunicação pretendida.

O estado indica 200, mas a funcionalidade não funciona

O código 200 confirma que o servidor remoto respondeu, mas a sua resposta pode ainda assim conter um erro próprio do serviço ou da aplicação.

Clique na linha em causa e consulte a secção Response para examinar o conteúdo da resposta.