From f01ae790a77f927ae9684435361d953458a1e67a Mon Sep 17 00:00:00 2001
From: "tiago.ferreira" <tiago.ferreira@fatecourinhos.edu.br>
Date: Wed, 23 Sep 2026 00:32:31 +0000
Subject: [PATCH] Atualizar loganalyzer.md

---
 loganalyzer.md | 215 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 215 insertions(+)

diff --git a/loganalyzer.md b/loganalyzer.md
index e69de29..65bc499 100644
--- a/loganalyzer.md
+++ b/loganalyzer.md
@@ -0,0 +1,215 @@
+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.
\ No newline at end of file