Tutorial: instalar o LogAnalyzer 5.0.1 no Debian com Apache e rsyslog

Este procedimento instala o LogAnalyzer 5.0.1 no Debian 13 “Trixie”, usando:

Apache 2
PHP 8.4
rsyslog
Arquivo local como fonte dos logs
LogAnalyzer acessível pelo navegador

O LogAnalyzer 5.0.1 requer PHP 8.1 ou superior. Documentação oficial

Execute os comandos como root. Caso esteja usando outro usuário administrativo, acrescente sudo.

1. Atualizar os repositórios
apt update

2. Instalar o Apache
apt install apache2 -y


3. Instalar o PHP e suas extensões

Instale o PHP e os módulos necessários:

apt install -y php libapache2-mod-php php-cli php-common php-mysql php-gd php-xml php-mbstring php-curl

Verifique a versão:

php -v

Na instalação original foi identificado PHP 8.4.24:

PHP 8.4.24 (cli)

Reinicie o Apache:

systemctl restart apache2
4. Configurar o arquivo de logs do LogAnalyzer

Crie uma configuração específica para o rsyslog:

vim /etc/rsyslog.d/10-loganalyzer.conf

Adicione:

*.* -/var/log/loganalyzer.log

Essa regra envia mensagens de todas as facilities e prioridades para /var/log/loganalyzer.log. O hífen antes do caminho solicita uma gravação assíncrona, que tende a reduzir operações de disco.

Salve o arquivo e valide a configuração:

rsyslogd -N1

O resultado esperado é semelhante a:

rsyslogd: End of config validation run. Bye.

Se aparecer algum erro, corrija o arquivo antes de reiniciar o serviço.

Reinicie o rsyslog:

systemctl restart rsyslog

Confira:

systemctl status rsyslog

O serviço deve estar:

Active: active (running)
5. Testar a geração dos logs

Acompanhe o arquivo:

tail -f /var/log/loganalyzer.log


logger "TESTE LOGANALYZER"

Confira novamente:

tail -f /var/log/loganalyzer.log

Deve aparecer uma linha parecida com:

ssor-server root[12013]: TESTE LOGANALYZER

Pressione Ctrl+C para sair.

6. Baixar o LogAnalyzer

Entre no diretório temporário:

cd /tmp

Baixe a versão 5.0.1:

wget https://github.com/rsyslog/loganalyzer/archive/refs/tags/v5.0.1.tar.gz

Extraia o pacote:

tar -xzf v5.0.1.tar.gz

Crie o diretório da aplicação:

mkdir -p /var/www/html/loganalyzer

Copie os arquivos públicos:

cp -a /tmp/loganalyzer-5.0.1/src/. /var/www/html/loganalyzer/

A documentação oficial confirma que somente o conteúdo do diretório src precisa ser colocado no servidor web. Guia oficial de instalação

7. Preparar o arquivo de configuração

Crie o arquivo que será preenchido pelo instalador web:

touch /var/www/html/loganalyzer/config.php

Ajuste o proprietário da aplicação:

chown -R root:www-data /var/www/html/loganalyzer

Aplique permissões nos diretórios:

find /var/www/html/loganalyzer -type d -exec chmod 755 {} \;

Aplique permissões nos arquivos:

find /var/www/html/loganalyzer -type f -exec chmod 644 {} \;

Permita temporariamente que o instalador altere config.php:

chown www-data:www-data /var/www/html/loganalyzer/config.php
chmod 660 /var/www/html/loganalyzer/config.php

8. Permitir que o Apache leia os logs

No Debian, o Apache normalmente utiliza o usuário www-data. Adicione esse usuário ao grupo adm, que tradicionalmente possui acesso aos logs do sistema:

usermod -aG adm www-data

Confirme:

id www-data

O grupo adm deverá aparecer:

grupos=33(www-data),4(adm)

Reinicie o Apache para que a associação de grupo seja aplicada:

systemctl restart apache2

Evite conceder permissões amplas como chmod 777 em /var/log. A própria documentação alerta que liberar acesso excessivo aos logs pode criar uma vulnerabilidade. Guia oficial

9. Executar o instalador pelo navegador

Abra:

http://IP_DO_SERVIDOR/loganalyzer/

Caso apareça a mensagem de que o arquivo principal de configuração está ausente, clique no link apresentado para abrir install.php.

No assistente:

Avance pela tela inicial.
Confirme que config.php está gravável.
Defina as opções gerais ou mantenha os valores padrão.
Quando for solicitado criar a primeira fonte, use:
Nome da fonte: Logs do sistema
Tipo da fonte: Diskfile
Tipo da linha: Syslog / Rsyslog
Arquivo Syslog: /var/log/loganalyzer.log
Conclua a instalação.

A fonte Diskfile permite que o LogAnalyzer leia diretamente um arquivo produzido pelo rsyslog, sem exigir banco de dados. Instruções oficiais

10. Proteger a instalação

Depois que o painel estiver funcionando, remova o instalador:

rm /var/www/html/loganalyzer/install.php

Retire a permissão de escrita do Apache sobre config.php:

chown root:www-data /var/www/html/loganalyzer/config.php
chmod 640 /var/www/html/loganalyzer/config.php

Reinicie o Apache:

systemctl restart apache2
11. Validação final

Gere outro evento:

logger "TESTE FINAL LOGANALYZER"

Atualize a página:

http://IP_DO_SERVIDOR/loganalyzer/

A mensagem deverá aparecer na listagem. Se não aparecer, faça estas verificações:

tail -n 20 /var/log/loganalyzer.log
id www-data
systemctl status rsyslog
systemctl status apache2

Também verifique se a fonte configurada no LogAnalyzer aponta exatamente para:

/var/log/loganalyzer.log

Ao final, você terá o LogAnalyzer 5.0.1 lendo e exibindo, por meio do Apache, os eventos registrados pelo rsyslog.