Journalisation - ceketrumdev/Zdefender GitHub Wiki
Journalisation 📝
La journalisation est une composante essentielle de ZDefender, permettant de suivre les événements, les actions prises et les anomalies détectées en temps réel. Cette page décrit les modes de journalisation disponibles, leur configuration et leur utilisation.
Table des matières
- Introduction
- Modes de journalisation
- Configuration de la journalisation
- Exemples de logs
- Dépannage
- Support et assistance
Introduction
La journalisation dans ZDefender est conçue pour être flexible et adaptée aux besoins de l'utilisateur. Elle permet de capturer des informations détaillées sur les événements réseau, les actions de mitigation et les erreurs système. Ces logs peuvent être utilisés pour surveiller le système, analyser les incidents ou auditer les activités.
Si vous rencontrez des problèmes avec la journalisation, consultez la section Dépannage ou ouvrez une discussion sur GitHub.
Modes de journalisation
ZDefender prend en charge deux modes de journalisation principaux :
Mode Fichier
Les logs sont écrits dans un fichier classique. Par défaut, ils sont stockés dans /var/log/zdefender/zdefender.log
.
Avantages :
- Facile à configurer et à consulter.
- Compatible avec la plupart des outils d'analyse de logs (par exemple,
grep
,awk
).
Configuration :
Dans le fichier de configuration (/etc/zdefender/config.json
), définissez :
"log_mode": "File"
Pour plus de détails sur la configuration, consultez la section Configuration.
Mode SystemdJournal
Les logs sont envoyés directement au journal systemd (systemd-journal
). Ce mode est recommandé pour les systèmes modernes qui utilisent systemd
comme gestionnaire de services.
Avantages :
- Intégration native avec
systemd
. - Centralisation des logs système via
journalctl
.
Configuration :
- Compilez ZDefender avec la feature
systemd
activée :cargo build --release --features systemd
- Modifiez le fichier de configuration (
/etc/zdefender/config.json
) :"log_mode": "SystemdJournal"
Pour consulter les logs avec journalctl
:
sudo journalctl -u zdefender
Configuration de la journalisation
La journalisation est configurée via le fichier JSON principal (/etc/zdefender/config.json
). Voici les options pertinentes :
Option | Description | Valeur par défaut |
---|---|---|
log_mode |
Mode de journalisation (File ou SystemdJournal ) |
File |
log_file |
Chemin du fichier de logs (uniquement en mode File ) |
/var/log/zdefender/zdefender.log |
log_level |
Niveau de détail des logs (info , debug , warn , error ) |
info |
Pour recharger la configuration sans redémarrer le service :
zdefender reload
Pour plus d'informations sur la configuration globale, consultez la section Configuration dans le README.
Exemples de logs
Voici quelques exemples typiques de logs générés par ZDefender :
Mode Fichier
Contenu de /var/log/zdefender/zdefender.log
:
[INFO] 2023-10-01T12:00:00 ZDefender démarré sur l'interface eth0
[WARN] 2023-10-01T12:05:30 Attaque SYN Flood détectée depuis 192.168.1.100
[ACTION] 2023-10-01T12:10:00 IP 192.168.1.100 bloquée pour 300 secondes
[DEBUG] 2023-10-01T12:15:00 Seuil de paquets atteint : 1000/s
Mode SystemdJournal
Avec journalctl
:
$ sudo journalctl -u zdefender
Oct 01 12:00:00 hostname zdefender[1234]: [INFO] ZDefender démarré sur l'interface eth0
Oct 01 12:05:30 hostname zdefender[1234]: [WARN] Attaque SYN Flood détectée depuis 192.168.1.100
Oct 01 12:10:00 hostname zdefender[1234]: [ACTION] IP 192.168.1.100 bloquée pour 300 secondes
Dépannage
Problèmes courants
-
Logs manquants en mode Fichier :
- Vérifiez que le répertoire
/var/log/zdefender/
existe et que ZDefender a les permissions nécessaires pour écrire dans ce dossier. - Assurez-vous que l'option
log_mode
est définie surFile
.
- Vérifiez que le répertoire
-
Logs non visibles en mode SystemdJournal :
- Vérifiez que ZDefender a été compilé avec la feature
systemd
activée. - Utilisez
journalctl
pour consulter les logs :sudo journalctl -u zdefender
.
- Vérifiez que ZDefender a été compilé avec la feature
-
Niveau de log incorrect :
- Modifiez l'option
log_level
dans le fichier de configuration pour ajuster le niveau de détail.
- Modifiez l'option
Pour signaler des bugs ou demander de l'aide, consultez la section Support et assistance.
Support et assistance
Si vous rencontrez des problèmes ou avez des questions sur la journalisation, voici quelques ressources utiles :
- Discussions GitHub: Posez vos questions ou partagez vos idées ici.
- Issues GitHub: Signalez des bugs ou demandez des fonctionnalités.
- Documentation complète: Consultez le wiki pour des guides détaillés.