A tela Logs do Servidor mostra os logs do sistema, dos serviços e de cada domínio sem precisar de SSH. Você pode filtrar, buscar no arquivo inteiro, baixar e acompanhar as linhas novas ao vivo.
Acesse pelo menu Monitoramento > Logs.
Escolher a fonte
No campo Fonte, as opções são agrupadas assim:
| Grupo | Exemplos |
|---|---|
| Arquivos do sistema | apache-access, apache-error, nginx-access, nginx-error, syslog, auth, ftp, log do painel e um log por versão de PHP-FPM instalada. |
| Journal (systemd) | Journal do sistema todo, autenticação (SSH/sudo/PAM), painel e kernel. |
| Dominios | Cada domínio do servidor. |
Arquivos que não existem no servidor aparecem como "(nao existe)" e não podem ser escolhidos.
Dica: no Debian 13 não há
syslognemauth.logpor padrão. Use as opções do grupo Journal (systemd) para ver esses registros.
Ao escolher um domínio, aparece a opção Tipo:
- Error: erros do servidor web e do PHP daquele site;
- Access: cada requisição recebida.
Os logs de domínio ficam na pasta de logs da conta, fora da home, por exemplo /var/log/minicp/users/usuario/exemplo.com.br-error.log. Na mesma pasta ficam o slowlog do PHP-FPM (fpm-slow.log), os logs das apps Node.js e dos serviços do cliente. A pasta é do root, com grupo do usuário: o cliente lê esses arquivos pelos atalhos em /home/usuario/logs/, mas não consegue apagá-los nem gravar neles.
Em Linhas, escolha quantas linhas finais carregar: 100, 200, 500, 1000, 2000 ou 5000.
Ler e filtrar
As linhas aparecem em um terminal escuro, com cores:
- linhas de erro com borda vermelha (error, fatal, failed, denied, exception...);
- linhas de aviso com borda amarela (warning, notice, timeout, refused...);
- no access log, o código HTTP colorido: 2xx verde, 3xx azul, 4xx amarelo e 5xx vermelho.
Use os botões do topo do terminal:
| Botão | Função |
|---|---|
| Todas / Erros / Avisos | Mostra só as linhas daquele nível, com a contagem. |
| Quebrar linhas | Liga ou desliga a quebra de linhas longas. |
| Seguir o final | Rola sozinho para as linhas novas. |
| Copiar | Copia as linhas visíveis. |
| Baixar | Baixa o arquivo de log completo. |
| Atualizar | Recarrega as linhas. |
| Limpar tela | Esvazia a tela (não apaga o log). |
| Tela cheia | Abre o terminal em tela cheia. Esc sai. |
No rodapé aparecem o caminho do arquivo, o tamanho, a data de modificação e quantas linhas estão visíveis.
Buscar
O campo Buscar tem dois usos:
- Digitar: filtra na hora as linhas já carregadas na tela.
- Digitar e apertar Enter: busca o texto no arquivo inteiro (maiúsculas e minúsculas tanto faz) e mostra as últimas linhas que contêm o termo, até o limite de Linhas.
Quando a busca no arquivo está ativa, aparece o aviso "Mostrando as ultimas N linhas do arquivo que contem..." e um botão para limpar a busca.
Dica: tecle
/em qualquer lugar da tela para ir direto ao campo de busca.
Exemplos úteis:
- um IP, para ver tudo o que ele acessou;
PHP Fatal, no log de erro de um domínio;" 500, no access log, para achar respostas com erro.
Acompanhar ao vivo
- Escolha a fonte.
- Clique em Live.
O indicador LIVE fica piscando e as linhas novas entram no fim da tela, destacadas por um instante. Os filtros de nível e o filtro de texto continuam valendo para as linhas novas. Em access logs, o topo do terminal mostra a contagem de respostas por classe (2xx, 3xx, 4xx, 5xx).
Clique de novo no botão para parar.
Atenção: a tela guarda no máximo 5000 linhas. Em logs com muito movimento, as mais antigas saem da tela. Para análise longa, use Baixar.
Rotação e envio para fora
A rotação dos logs das contas (/var/log/minicp/users/*/*.log) e dos logs do painel é configurada em Configuracoes, aba Logs, quadro Rotacao de Logs (logrotate): frequência, quantas rotações manter, tamanho máximo e compressão. O botão Forcar rotacao agora aplica na hora.
No mesmo lugar, Log Remoto (rsyslog) encaminha os logs para um servidor central de logs (syslog ou SIEM), por TCP ou UDP.