Como usar o comando grep pra encontrar rapidamente um erro específico nos logs

Como usar o grep pra encontrar rapidamente um erro específico nos logs

Fala, tudo bem? Aqui é a Sensei da GeHost! 🥋 Se o seu site deu algum erro e você já conseguiu acessar os logs por SSH, mas está se sentindo perdido(a) num arquivo gigantesco cheio de linhas e mais linhas... respira. Hoje eu vou te ensinar um truque que todo bom administrador de servidor usa: o comando grep. Com ele, você acha a "agulha no palheiro" em segundos, sem precisar ler o log inteiro.

💡 O que é o grep? Pense nele como um "Ctrl+F" (aquele buscador de texto) só que dentro do terminal. Você diz uma palavra ou trecho, e ele te devolve só as linhas do arquivo que contêm aquilo — ignorando todo o resto.

Antes de começar: pré-requisitos

• Você precisa ter acesso SSH liberado na sua hospedagem (consulte no painel.gehost.com.br ou com o suporte se você tem esse acesso disponível no seu plano).
• Já ter conseguido conectar no servidor via SSH (se ainda não sabe fazer isso, procure nosso guia de "Como acessar via SSH" aqui na base de conhecimento).
• Saber, mais ou menos, o que você está procurando: uma palavra do erro (ex: "error", "denied", "500"), um horário, ou o nome de um domínio/arquivo.

Passo a passo

1. Conecte-se via SSH na sua hospedagem normalmente, do jeito que você já costuma fazer.
2. Descubra onde está o log que você quer investigar. Em hospedagens cPanel, os logs de erro geralmente ficam numa pasta como logs dentro do seu diretório do domínio, ou você pode acessá-los também pela tela "Métricas" do próprio cPanel. Se tiver dúvida de qual arquivo é o certo, é só perguntar pro nosso suporte que a gente te indica.
3. Rode o grep básico. A estrutura é sempre a mesma:

   grep "o que eu quero procurar" nome_do_arquivo.log

   Por exemplo, se você quer achar tudo que fala sobre "500" (erro de servidor):

   grep "500" error_log

   Pronto! Em vez de milhares de linhas, você só vê as que contêm exatamente esse termo.
4. Busque sem se preocupar com maiúsculas/minúsculas. Às vezes o erro pode estar escrito "Error" ou "error" ou "ERROR". Pra não perder nada, use o parâmetro -i:

   grep -i "error" error_log

5. Veja o "contexto" da linha do erro. Às vezes só a linha do erro não conta a história toda — você quer ver o que aconteceu um pouco antes e um pouco depois. Use -A (depois) e -B (antes), seguido do número de linhas:

   grep -i -A 3 -B 3 "denied" error_log

   Isso mostra 3 linhas antes e 3 linhas depois de cada ocorrência da palavra "denied".
6. Filtre por data ou horário, se você sabe mais ou menos quando o problema aconteceu. Muitos logs começam a linha com a data, então dá pra buscar direto por ela:

   grep "06/Aug/2026" error_log

7. Combine buscas quando quiser refinar ainda mais. Por exemplo, achar linhas com "error" só dentro de um resultado que já tem "500":

   grep "500" error_log | grep -i "error"

   O símbolo | (chamado de "pipe") passa o resultado de uma busca pra dentro da próxima.
8. Se o log for muito grande, você pode combinar o grep com o comando tail pra olhar só as últimas ocorrências, evitando rolar a tela para sempre:

   tail -n 500 error_log | grep -i "error"

   Isso pega só as últimas 500 linhas do log e já filtra o que interessa.

Dicas de ouro da Sensei

🥋 Quanto mais específico for o termo que você busca, melhor o resultado. Em vez de buscar só "error" (que pode aparecer centenas de vezes), tente buscar um trecho da mensagem exata que apareceu na tela do seu site ou aplicação.

🥋 Não sabe o nome exato do arquivo de log? Use ls dentro da pasta de logs pra listar tudo que existe ali antes de rodar o grep.

🥋 Ficou com medo de "estragar" alguma coisa? Pode ficar tranquilo(a): o grep só lê o arquivo, ele nunca apaga nem modifica nada. É uma ferramenta 100% segura de usar.

Não conseguiu achar o que precisava?

Sem problema! Nem sempre é fácil identificar sozinho(a) qual erro é a causa raiz de um problema. Se você já tentou os passos acima e ainda ficou com dúvida, chame nosso suporte e mande o trecho do log que você encontrou — isso já ajuda muito a gente a te dar um diagnóstico rápido e certeiro.

Continue praticando esse comando, ele é um dos mais úteis que existem pra quem cuida de hospedagem no dia a dia. Até o próximo guia! 🥋