Pular para o conteúdo
Documentação

Logs

Central de logs do miniProxy - visualizar ao vivo o acesso HTTP, o WAF, o painel e os proxies TCP, baixar arquivos e definir por quantos dias guardar cada log.

R Regis Manze 20/11/2026 4 min de leitura

A tela Logs reúne todos os logs gerados pelo servidor em um lugar só: você acompanha ao vivo, filtra, baixa os arquivos (inclusive os antigos compactados em .gz) e define por quanto tempo cada log é guardado. Ela fica em Sistema > Logs.

Visualizar um log

No cartão Visualizador:

  1. Escolha a fonte na lista:
Fonte O que mostra
HAProxy - Acesso HTTP Log de acesso do HAProxy (/var/log/haproxy.log): cada requisição com status, tempos, backend e domínio. Se o arquivo não existir ou estiver vazio, o painel lê o journal do serviço haproxy.
TCP - <nome> Um item por proxy TCP, quando a separação de logs TCP está ativa.
WAF Coraza - matches Regras do WAF que casaram (/var/log/coraza-spoa/).
WAF Coraza - auditoria Log de auditoria do WAF, com a requisição completa das transações que casaram regra.
Painel miniProxy Journal do serviço haproxy-admin (erros e mensagens do painel).
HAProxy - servico (systemd) Journal do serviço haproxy: inícios, reloads, avisos e erros de configuração.
  1. Digite um trecho em filtrar... para mostrar só as linhas que o contêm (sem diferenciar maiúsculas). Exemplos: o domínio loja.exemplo.com.br, um IP 203.0.113.10 ou status=503.
  2. Escolha quantas linhas ler: 100, 200, 500 ou 1000.
  3. Marque ao vivo para atualizar a cada 4 segundos, ou use o botão de recarregar para atualizar uma vez.

Dica: para ver o acesso de um domínio só, abra a tela do domínio: o cartão Ultimas requisicoes já filtra pelo host e tem a opção so 4xx/5xx.

Logs de portas TCP

Por padrão, os proxies criados em Portas TCP registram no mesmo haproxy.log do tráfego HTTP. O cartão Logs de portas TCP permite separar cada porta em um arquivo próprio em /var/log/haproxy-tcp/:

  • Inativa: clique em Ativar separacao de logs TCP e confirme. O painel ajusta os proxies TCP no haproxy.cfg, cria a regra do rsyslog e a rotação, valida e recarrega o HAProxy e o rsyslog. Cada proxy passa a aparecer como TCP - <nome> no visualizador.
  • Ativa: clique em Desativar separacao para os proxies voltarem a registrar no haproxy.log. Os arquivos já gerados são mantidos.

Atenção: a separação depende do rsyslog. Em servidores que só usam o journald, o cartão avisa que o rsyslog não está instalado; nesse caso os logs TCP aparecem na fonte HAProxy - servico (systemd).

Arquivos, download e retenção

Abaixo do visualizador há um cartão por grupo de logs:

  • HAProxy - Acesso HTTP
  • WAF (Coraza) - match + auditoria
  • Proxies TCP (por porta) (quando a separação está ou já esteve ativa)

O título mostra quantos arquivos existem e o espaço total ocupado. A tabela lista cada Arquivo com o Tamanho e um botão para baixar, inclusive os rotacionados (.1, .2.gz...).

Definir a retenção

  1. Em cada grupo, ajuste guardar N dias (de 1 a 365).
  2. Marque comprimir para compactar os arquivos antigos em .gz (economiza bastante disco).
  3. Clique em Salvar retencao. O painel valida o arquivo do logrotate antes de gravar e mostra Retencao salva: ....

Grupos sem configuração de rotação aparecem como sem logrotate e não podem ser ajustados por aqui.

Rotacionar agora

O botão Rotacionar agora força a rotação do grupo na hora: o arquivo atual é renomeado (e compactado, se comprimir estiver marcado) e um novo é iniciado. Útil quando o disco está enchendo.

Atenção: logs apagados pela retenção não podem ser recuperados. Se você precisa de histórico longo para auditoria, baixe os arquivos antes ou aumente o número de dias.

Veja também

Copiar para usar com IA

Este artigo foi útil?

Que bom! O que ajudou mais? O que faltou nesta página?

Opcional — seu voto já foi registrado.

Obrigado pelo seu feedback!