Como usar arquivos de log do WordPress para melhorar seu site

Os arquivos de log do WordPress são um dos aspectos mais importantes de todo o ecossistema WP, do qual você talvez nunca tenha ouvido falar. Ou pelo menos, pode nunca ter pensado. Os arquivos de log são essencialmente registros de tudo o que o seu site e servidor fez ao longo de sua vida (ou um período de tempo específico). Infelizmente, muitas pessoas consideram os arquivos de log difíceis de entender e usar. Queremos romper esse equívoco e mostrar a você como usar os arquivos de log do WordPress e o que esse conhecimento pode fazer para melhorar o seu site.

Inscreva-se no nosso canal no Youtube

O que você pode fazer com arquivos de log do WordPress?

O uso de arquivos de log do WordPress difere dependendo da sua função. Um usuário encontrará coisas úteis diferentes do que um administrador acharia, um desenvolvedor e assim por diante. Mas há várias coisas que esses mesmos arquivos de log fazem e muitos dos propósitos podem se sobrepor.

• encontrando erros
• ajuda na solução de problemas
• auditoria de segurança
• avaliando os padrões de acessibilidade
• monitorar a experiência do usuário e a jornada do cliente
• rastrear a atividade do usuário
• verificar o desempenho do plugin
• explorar temas

E muito mais. Além disso, existem muitos tipos diferentes de arquivos de log. Alguns são específicos do próprio WordPress, enquanto outros podem ser gerados por plug-ins individuais. Vejamos alguns deles em particular para ver o que você pode esperar.

Arquivos de log de depuração do WordPress

Estranhamente, o próprio arquivo de log padrão do WordPress está desabilitado para novas instalações do WP. Você tem que entrar no arquivo wp-config.php e habilitá-lo manualmente. Os logs de depuração são desabilitados por padrão porque registrar tudo o que a instalação do WP faz consome alguns dos recursos do servidor. Em vez de administrar o site, ele registra como o administra.

Recomendamos que você habilite o registro apenas por um curto período, conforme surgirem problemas para corrigi-los. A menos que você esteja trabalhando em um ambiente de desenvolvimento, é claro.

Agora, você pode habilitar os logs de várias maneiras. Via FTP usando um programa como o FileZilla e editando o arquivo em um editor de código. Por cPanel, ou mesmo por meio de um plugin como o WP File Manager. Independentemente disso, o processo é simples. Você encontrará o arquivo wp-config.php no diretório raiz de sua instalação e adicionará duas linhas de código a ele.

• define ('WP_DEBUG', verdadeiro);
• define ('WP_DEBUG_LOG', verdadeiro);

Etapa 1: Encontrar wp-config.php

Onde quer que esteja seu diretório raiz, conecte-se a ele. Provavelmente estará em /public_html/example.com/ (a parte .com pode ou não estar lá).

Etapa 2: Editando wp-config.php

Uma vez lá, abra-o no editor de sua escolha. Sublime Text, VS Code e Atom são escolhas populares. Role até encontrar a linha que diz / * Isso é tudo, pare de editar! Feliz blogging. * / Uma vez lá, cole as duas linhas de código acima diretamente acima dele. Você pode até ter um marcado como falso já no arquivo.

A linha superior permite que a depuração ocorra, enquanto a segunda gera o próprio arquivo de log. Nesse formato, o snippet salva o arquivo de log do WordPress em wp-content / debug.log , mas você pode substituir true por um caminho relativo entre aspas simples para especificar um local diferente. Por exemplo, define ('WP_DEBUG_LOG', '/tmp/wp-errors.log'); conforme especificado na entrada do WordPress Codex nos logs de depuração.

Etapa 3: Encontrar, ler e compreender o arquivo de registro

Esteja ciente de que seu arquivo de log pode não aparecer imediatamente. Não é um registro em tempo real das atividades do servidor, mas um registro dos erros que ocorrem nele. É por isso que recomendamos anteriormente que você o habilite apenas quando algo estiver errado. Portanto, se o arquivo debug.log ainda não existir, dê um tempo. Alguma coisa vai quebrar, eventualmente.

Quando você finalmente obtém o arquivo debug.log , pode abri-lo no gerenciador de arquivos ou no editor de código de sua escolha. Mas você verá algo semelhante a isso.

Para um usuário típico do WordPress, isso se parece com gobbledygook. Para um desenvolvedor, no entanto, eles veriam os problemas do PHP em alguns plug-ins sendo incapazes de executar certas tarefas.

Etapa 4: Obtenha ajuda

Como dissemos acima, a maioria dos usuários do WP não tem ideia do que fazer com esses erros. No entanto, quando o seu site não está tendo um desempenho ideal, você precisa corrigir isso. É quando você precisa encontrar alguém para ajudá-lo.

Você tem algumas opções neste caminho específico, a mais óbvia das quais é fazer o download de todo o arquivo debug.log e enviá-lo via Slack ou e-mail para o administrador do sistema. Na maioria das vezes, essa é a melhor escolha. Mesmo se você for um desenvolvedor e tiver esse log, provavelmente o enviará para cima na cadeia (ou talvez para baixo, se for um desenvolvedor sênior e delegar tarefas).

Mas se você não faz parte de uma equipe, provavelmente também precisará pegar o arquivo e enviá-lo para algum lugar. Mas onde? Stack Overflow. Ou talvez ainda mais especificamente, WordPress Stack Exchange (o subfórum do SO baseado em WP). Se você não conseguir uma resposta no Stack Overflow ou Stack Exchange sobre seu problema de tecnologia, você deve comprar um bilhete de loteria. Porque essas são algumas chances malucas.

Além disso, você pode enviar os logs de depuração para os desenvolvedores do plug-in diretamente ou até mesmo postar nos fóruns de ajuda oficiais do WordPress em WordPress.org. Embora os problemas possam ser com plug-ins individuais, os logs são do WP e as pessoas provavelmente já se depararam com esses problemas específicos antes.

Além disso, existem páginas de suporte a plugins na página de repositório de cada plug-in.

Eles o levam ao fórum de suporte direto em WP.org para esse plug-in específico.

Usando esses fóruns, você pode obter ajuda individualizada para seus problemas.

Empacotando

Como você pode ver, os logs de erros do WordPress são incrivelmente densos. Eles podem ser intimidantes e até mesmo configurá-los (além de usar um plug-in) pode ser assustador para algumas pessoas. Mas se você mantiver a depuração limitada a um ambiente de desenvolvimento ou desligá-lo depois de obter os logs em um servidor público, eles são uma ferramenta fantástica de solução de problemas para ver o que está errado nos bastidores do seu site. Portanto, da próxima vez que seus usuários tiverem um problema, ou até mesmo sua equipe tiver um problema com o back-end do site não funcionando como esperado, os arquivos de log do WordPress podem ser uma linha de defesa fantástica.

Que tipo de situação o monitoramento de arquivos de log do WordPress você conseguiu corrigir ou evitar?

Imagem de destaque do artigo por fatmawati achmad zaenuri / shutterstock.com