Como usar o comando grep para encontrar erros em arquivos de log Print

Como usar o comando grep para encontrar erros em arquivos de log (SSH & Avançado)

Olá, viajante do servidor! 🌟 Seja bem-vindo ao nosso guia do Sensei da GeHost, onde aprendemos juntos a dominar o mundo do servidor com calma, clareza e um toque de humanidade.

Hoje vamos aprender um dos comandos mais poderosos do terminal: grep. Ele é como um detector de erros invisíveis — capaz de vasculhar arquivos de log e te mostrar exatamente onde algo deu errado, mesmo que pareça um texto sem sentido.

Se você já se perguntou: "Por que meu site está com falhas?", "Onde estão os erros do sistema?" ou "Como saber o que deu pau no meu sistema?", o grep é sua resposta.

Dica do Sensei: Antes de tudo, certifique-se de ter acesso via SSH ao seu servidor. Se não tiver, entre em contato com o suporte da GeHost pelo painel (painel.gehost.com.br) — vamos te ajudar a habilitar esse acesso com segurança.

Passo a passo: Encontrando erros com grep

Vamos aprender com calma, como se fosse um ritual. Cada comando é uma ferramenta, e você é o mestre.

1. Conecte-se ao servidor via SSH (usando um cliente como PuTTY, Terminal (macOS/Linux) ou o terminal integrado do painel).

2. Localize o arquivo de log que deseja analisar. Arquivos de log geralmente estão em:

   • /home/SEU_USUARIO/logs/ (ou public_html/logs/ se for específico do seu site)
   • /var/log/ (logs do sistema — geralmente só acessíveis com privilégios elevados)
   • Arquivos com extensão como .log, .error, access.log, error.log

   Use o comando ls para listar os arquivos e descobrir o nome exato.

3. Use o grep para procurar palavras-chave que indicam erro. Por exemplo:

   grep "error" /home/seu_usuario/logs/error.log

   Isso vai mostrar todas as linhas do arquivo error.log que contêm a palavra error.

4. Busque por erros mais específicos com palavras como failed, denied, timeout, 404, 500, etc.

   Exemplo:

   grep "failed" /home/seu_usuario/logs/access.log

   Isso ajuda a encontrar tentativas de acesso negadas — como tentativas de login inválidas.

5. Use a opção -i para ignorar maiúsculas/minúsculas — muito útil, pois erros podem aparecer como Error, ERROR ou error.

   Exemplo:

   grep -i "error" /home/seu_usuario/logs/*.log

   Isso procura por error em todos os arquivos de log da pasta, sem diferenciar letras.

6. Use -n para ver o número da linha — ajuda a localizar exatamente onde o erro ocorreu.

   Exemplo:

   grep -in "500" /home/seu_usuario/logs/error.log

   Resultado: 123: [2025-04-05 14:22:11] PHP Fatal error: 500 Internal Server Error

   Pronto! Você sabe que o erro está na linha 123.

7. Combine com tail para ver os últimos registros — útil para ver erros recentes.

   Exemplo:

   tail -n 50 /home/seu_usuario/logs/error.log | grep -i "error"

   Isso mostra as últimas 50 linhas do arquivo e filtra apenas as que têm "error".

Exemplo prático: Encontrar erros de PHP

Imagine que seu site está com um erro 500. Vamos procurar:

grep -in "PHP" /home/seu_usuario/logs/error.log | grep -i "error"

Resultado:

142: [2025-04-05 13:45:22] PHP Fatal error: Uncaught Error: Call to undefined function my_function() in /home/seu_usuario/public_html/index.php on line 45

Pronto! Agora você sabe que o problema está na linha 45 do arquivo index.php, tentando chamar uma função que não existe. É só corrigir o código!

Dicas do Sensei para não se perder

• Use o less para navegar em arquivos grandes: less /home/seu_usuario/logs/error.log — depois use /error para procurar (pressione n para ir para o próximo).
• Evite comandos muito largos — se tiver muitos arquivos, use grep -r "error" /home/seu_usuario/logs/ para procurar recursivamente.
• Não altere arquivos de log diretamente — eles são históricos. Se precisar, faça backup antes.

Quer ir além?

Se você quer se tornar um verdadeiro mestre do servidor, experimente combinar grep com outros comandos como awk, sed ou sort. Mas não se apresse — cada mestre começa com um passo.

Se tiver dúvidas, não hesite em entrar em contato com o suporte da GeHost. Estamos aqui para te ajudar, com respeito, paciência e um toque de carinho.

Seu plano está no painel? Acesse agora e veja seus recursos. Lembre-se: você não está sozinho nesta jornada.

Nota do Sensei: Este guia foi criado com carinho pela G e Soluções e Eventos LTDA (CNPJ: 46.647.904/0001-04), marca Entexp, com o propósito de ensinar com verdade e ética. Se precisar de ajuda com faturas, dados fiscais ou suporte, consulte sua conta no painel ou entre em contato com nosso time.