215 lines
5.0 KiB
Plaintext
215 lines
5.0 KiB
Plaintext
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. |