Novo Módulo - Visualização e Limpeza Automática de Logs
Patch Notes – Módulo de Visualização e Limpeza Automática de Logs
Descrição da atualização
Foi adicionado ao painel um conjunto de recursos para facilitar o trabalho com os arquivos de log do Magento. Agora é possível:
-
visualizar os logs direto pelo admin, sem precisar acessar o servidor;
-
baixar o arquivo de log;
-
esvaziar o log manualmente;
-
e, principalmente, configurar uma limpeza automática que mantém apenas as últimas linhas, evitando que os logs cresçam demais.
A ideia é dar uma forma simples de manter o var/log organizado e leve, mas sem perder o histórico mais recente.
O que o módulo faz:
Visualizador de Logs
-
Lista todos os arquivos existentes em var/log.
-
Permite abrir o conteúdo diretamente no painel.
-
Mostra apenas as últimas X linhas do arquivo (configurável).
-
Exibe data e tamanho do arquivo.
-
Permite baixar e limpar o log.
Limpeza Automática de Logs (via cron/agendamento)
-
Roda na frequência definida na configuração (ex.: diariamente).
-
Verifica cada arquivo de log.
-
Se o arquivo tiver mais linhas do que o valor configurado, ele é aparado.
-
O módulo mantém apenas as últimas N linhas e descarta o excesso.
-
Arquivos .gz não são mexidos.
Dessa forma, o log nunca fica “enorme” e você sempre tem o trecho mais recente, que é o que importa para debug.
Onde fica:
Grid com os logs
Sistema → Logs do Sistema
- É a tela que lista todos os arquivos da pasta var/log, com opções de visualizar, baixar, esvaziar e ações em massa.
Configurações do módulo
Sistema → Configuração → Desenvolvedor
- Logs do Sistema (quantas linhas mostrar ao visualizar).
- Limpeza Automática de Logs (cron + quantidade de linhas a manter).
Os dois blocos ficam juntos justamente para centralizar tudo relacionado a log.
Configurações disponíveis:
Logs do Sistema
-
Máx. de linhas ao visualizar
-
O que faz: define quantas linhas o painel vai exibir quando você abrir um log.
-
Para que serve: evitar travar o navegador ao abrir um log muito grande.
-
Exemplo: 1000
-
Limpeza Automática de Logs
-
Habilitar
-
Ativa ou desativa o cron de limpeza.
-
Quando desativado, nada é apagado automaticamente.
-
-
Manter últimas N linhas
-
Define o “tamanho” que o log deve ter depois da limpeza.
-
Se o log tiver menos que isso, o módulo não mexe.
-
Se tiver mais, ele remove o excesso e deixa só as últimas N.
-
Exemplo: 2000
-
-
Agendamento (cron)
-
Define quando o Magento vai rodar a limpeza.
-
Exemplo:
-
30 3 * * *→ todo dia às 03:30 -
45 13 * * *→ todo dia às 13:45
-
-
Lembrando: o cron do Magento precisa estar ativo no servidor
-
Como funciona a limpeza:
-
O cron é executado no horário configurado.
-
Ele percorre a pasta var/log.
-
Para cada arquivo:
-
se for um arquivo normal (não .gz),
-
se puder ser lido e escrito,
-
e se tiver MAIS linhas do que o valor configurado,
-
o módulo reescreve o arquivo mantendo só o final (as últimas N linhas).
-
-
Se o arquivo tiver menos linhas do que o configurado, ele não é apagado.
-
Esse método é seguro: o arquivo continua existindo com o mesmo nome, só com menos conteúdo.
Principais vantagens:
-
Evita var/log gigante ocupando espaço.
-
Mantém o trecho útil para debug (parte mais recente).
-
Configuração feita direto no painel.
-
Não precisa acessar SSH para apagar log.
-
Dá pra baixar o log direto da grade.
Observações importantes:
-
A limpeza é por quantidade de linhas, não por data.
-
Se um log costuma registrar linhas muito grandes (por exemplo, JSONs enormes), aumentar o número de linhas pode ser interessante.
-
O cron usa o horário do servidor. Se o servidor estiver em outro fuso, ajuste a expressão ou o horário do próprio servidor.
-
O módulo não mexe em arquivos já compactados (.gz).