Como configurar logs centralizados para depurar uma aplicação em produção imprimir

  • 0

Como configurar logs centralizados para depurar uma aplicação em produção

Oi! Aqui é a Sensei da GeHost 🥋 Hoje vou te ensinar um superpoder de quem cuida de sites e sistemas: os logs centralizados. Parece nome complicado, mas é simples — é basicamente juntar todos os "diários de bordo" da sua aplicação num lugar só, pra você (ou quem for te ajudar) conseguir entender rapidinho o que deu errado quando o site apresenta um comportamento estranho.

Vamos por partes, com calma, do jeitinho que a gente gosta de ensinar por aqui.

O que é um "log", afinal?

Todo sistema (seu site, sua loja, seu app) vai anotando, em segundo plano, tudo que acontece: erros de código, tentativas de acesso, falhas de conexão com o banco de dados, etc. Esses registros ficam guardados em arquivos de texto chamados logs. O problema é que, numa aplicação com vários pontos (PHP, banco de dados, servidor web), esses registros ficam espalhados em vários arquivos diferentes — e é aí que mora a dor de cabeça na hora de investigar um bug.

Dica da Sensei: pense no log como a caixa-preta de um avião. Quando algo dá errado, é ele quem conta a história — então quanto mais organizado ele estiver, mais rápido você acha a causa do problema.

O que significa "centralizar" os logs

Centralizar logs é reunir esses registros espalhados num único lugar (ou numa estrutura organizada de pastas) pra facilitar a consulta. Em vez de caçar arquivo por arquivo quando algo quebra, você olha só num lugar e já entende a linha do tempo do problema.

Passo a passo pra organizar seus logs no cPanel

Passo 1 — Acesse o cPanel da sua hospedagem

Primeiro, entre no seu painel de hospedagem pelo painel.gehost.com.br ou pelo link de acesso ao cPanel que você recebeu por e-mail.

Tela de login do cPanel com campos de usuário e senha

Passo 2 — Entenda onde sua aplicação já guarda logs

Depois de logado, você vai ver o painel principal com várias ferramentas organizadas por categoria (E-mail, Arquivos, Bancos de Dados, etc.).

Painel inicial do cPanel com os grupos de ferramentas

A maioria das aplicações (WordPress, sistemas em PHP, etc.) já gera arquivos de log automaticamente, geralmente com nomes como error_log, debug.log ou dentro de uma pasta chamada /logs na raiz do seu site.

Passo 3 — Localize os arquivos de log pelo Gerenciador de Arquivos

Abra o Gerenciador de Arquivos e navegue até a pasta do seu site (normalmente public_html). Procure por arquivos como:

  • error_log — erros gerais do PHP/servidor
  • debug.log — usado por alguns sistemas (ex.: WordPress, quando o modo debug está ativado)
  • uma pasta /logs ou /wp-content/logs, se sua aplicação tiver uma
Gerenciador de Arquivos do cPanel mostrando a árvore de pastas

Passo 4 — Crie uma pasta única para centralizar (o "quartel-general" dos logs)

  1. Ainda no Gerenciador de Arquivos, crie uma pasta com um nome claro, por exemplo /logs-app, fora do acesso público (nunca dentro de uma pasta que fique exposta publicamente pelo navegador).
  2. Se sua aplicação permitir configurar o caminho onde ela salva os logs (isso costuma ficar num arquivo de configuração, tipo wp-config.php, .env ou um arquivo de settings do seu sistema), aponte todos os logs pra essa mesma pasta.
  3. Assim, sempre que precisar investigar algo, você olha em UM lugar só — muito mais rápido do que caçar arquivo por arquivo.
Dica da Sensei: se você não sabe mexer no código da aplicação pra mudar o caminho dos logs, não se preocupe — nosso suporte técnico pode te ajudar com essa configuração. É um ajuste mais técnico e vale a pena pedir uma mãozinha.

Passo 5 — Organize por data ou por tipo de erro

Se sua aplicação gerar muito log, uma boa prática é separar por data (ex.: erro-2026-08-01.log) ou por tipo (ex.: erros-banco.log, erros-pagamento.log). Isso ajuda MUITO na hora de procurar algo específico depois.

Passo 6 — Rotina de limpeza (não deixe acumular pra sempre)

Arquivos de log crescem com o tempo e podem ocupar espaço em disco desnecessariamente. Vale conferir periodicamente e apagar (ou arquivar) logs antigos que você já não precisa mais consultar. Se quiser automatizar essa limpeza, fale com nosso suporte técnico — dependendo do seu plano, dá pra configurar rotinas automáticas.

E se eu quiser algo mais avançado?

Ferramentas de log centralizado mais sofisticadas (painéis visuais, alertas automáticos, monitoramento em tempo real) geralmente exigem uma configuração mais robusta e personalizada. Se seu projeto está crescendo e você sente que precisa de algo assim, é só chamar a gente — nossa equipe técnica pode avaliar seu cenário e te orientar sobre o melhor caminho para o seu projeto.

Dica da Sensei: logs bons não evitam bugs, mas encurtam MUITO o tempo pra descobrir e corrigir. É um dos hábitos mais valiosos de quem cuida de uma aplicação em produção.

Resumo rapidinho

  1. Entenda onde sua aplicação já grava logs.
  2. Reúna tudo numa pasta única (fora do acesso público).
  3. Organize por data ou tipo de erro.
  4. Limpe periodicamente os arquivos antigos.
  5. Para automações mais avançadas, conte com o nosso suporte técnico.

Ficou com alguma dúvida no meio do caminho? Pode chamar a gente pelo painel a qualquer momento — estamos aqui pra te ajudar a manter sua aplicação saudável e fácil de depurar. 🙌


Esta resposta lhe foi útil?

« Retornar