5.0 KiB
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.
-
Atualizar os repositórios apt update
-
Instalar o Apache apt install apache2 -y
-
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.
- 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
- 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
- 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
- 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
- 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.