Nous allons voir dans ce tuto comment envoyer des logs à un serveurs rsyslog.
Tout d’abord qu’est ce que syslog ?
1. Qu’est ce Syslog ?
Syslog est un protocole réseau fonctionnant sur le port UDP 514 (pour les logs distants). Il permet de journaliser les événements passés sur le système. Plus précisément il va recevoir les messages de la part des démons. Ces messages sont envoyés avec deux autres informations :
- La catégorie du message
- La gravité du message
Listes des catégories :
La gravité est divisée en 8 niveaux :
2. Configuration du serveur rsyslog
Contexte : nous avons deux machines, une machine de type serveur qui se nomme Librenms ( je réutilise cette machine pour les logs qui a aussi comme fonction un serveur de supervision que j’aurai l’occasion de vous présenter plus tard 😉 ) et une machine cliente LAMP que l’on configurera dans la partie 3.
Nous allons éditer le fichier « /etc/rsyslog.conf »
root@librenms:~# vim /etc/rsyslog.conf
Nous allons décommenter ces 2 lignes (en bleu) pour activer la réception des logs sur le port UDP 514 :
# provides UDP syslog reception
#module(load="imudp")
#input(type="imudp" port="514")
J’enregistre le fichier de conf sur VIM « :wq » 🙂 .
Je restart le service rsyslog.
root@librenms:~# systemctl restart rsyslog.service
3. Configuration de la machine cliente
Dans la machine distante j’édite le fichier de configuration de rsyslog :
root@LAMP:~# vim /etc/rsyslog.conf
Je me dirige vers la section « RULES » :
Et rajouter cette ligne :
*.info @192.168.1.219
192.168.1.219 représente mon serveur rsyslog (LIBRENMS) qui va recevoir les logs distant de mon serveur LAMP.
*.info : « * » tout types de logs et « info » le niveau de logs transmis. C’est à dire tout les logs de niveau 6 est en dessous donc : info, notice, warn, err, crit, alert & emergency.
Je restart mon service sur la machine cliente :
root@LAMP:~# systemctl restart rsyslog.service
Si je redémarre mon serveur Apache sur la machine LAMP je verrais les logs sur le syslog de librenms :
root@LAMP:~# systemctl restart apache2.service
Sur Librenms :
root@librenms:~# tail -f /var/log/syslog
Mar 7 14:56:40 LAMP systemd[1]: Stopped The Apache HTTP Server.
Mar 7 14:56:40 LAMP systemd[1]: Starting The Apache HTTP Server...
On voit bien que la machine est identifiée (surlignée en bleu).
Cependant, mélanger les logs LAMP avec les logs système de librenms, c’est pas très propre et, en plus de cela, si on a plusieurs clients ça va être difficilement gérable. De ce fait nous allons classifier les logs en fonctions des hôtes et par dates comme cela il y aura une meilleure organisation.
4. Classifier les logs par hôte distant.
Nous allons retourner sur le serveur (Librenms) et nous allons créer un template qui va faire en sorte de créer un dossier par client. J’édite donc le fichier de configuration de rsyslog :
root@librenms:~# vim /etc/rsyslog.conf
Dans les RULES je rajoute la règle suivante:
$template syslogclients,"/var/log/syslogclients/%hostname%/%$now%.log"
*.* ?syslogclients
Expliquons ces lignes :
$template syslogclients : le nom de mon template pour toutes les machines distantes qui enverrons des logs vers moi.
/var/log/syslogclients/%hostname%/%$now%.log : le chemin répertoriant les logs de ces machines qui seront classifier par noms de machine (à l’aide des dossiers) et dans chacun de ces dossier la date.
%hostname% : pour le nom de l’hôte
%$now%.log : pour la date
Pour les propriétés si vous souhaitez les modifier je vous invite à lire la doc rsyslog : https://www.rsyslog.com/doc/master/configuration/properties.html
*.* ?syslogclients : cela veur dire que nous acceptons pour ce templates tous les logs entrants.
Maintenant si je fait des actions sur mon client « LAMP » :
root@LAMP:~# systemctl restart apache2.service
root@LAMP:~# systemctl restart apache2.service
root@LAMP:~# logger -p user.info "TEST LOG SUR LIBRENMS"
root@LAMP:~# systemctl restart mariadb.service
Remarque : logger permet d’entrer un message dans le système de log.
Je vais sur mon serveur rsyslog :
Je vois qu’un dossier portant le nom de ma machine est bien créé, ainsi qu’un fichier de log avec comme nom la date. Celui-ci se trouve dans mon dossier LAMP :
Et si je regarde son contenu je vois bien les logs de ma machine LAMP :
root@librenms:/var/log/syslogclients/LAMP# cat 2021-03-07.log
Mar 7 15:11:15 LAMP systemd[1]: Stopping The Apache HTTP Server...
Mar 7 15:11:15 LAMP systemd[1]: apache2.service: Succeeded.
Mar 7 15:11:15 LAMP systemd[1]: Stopped The Apache HTTP Server.
Mar 7 15:11:15 LAMP systemd[1]: Starting The Apache HTTP Server...
Mar 7 15:11:15 LAMP systemd[1]: Started The Apache HTTP Server.
Mar 7 15:17:01 LAMP CRON[1816]: pam_unix(cron:session): session opened for user root by (uid=0)
Mar 7 15:17:01 LAMP CRON[1817]: (root) CMD ( cd / && run-parts --report /etc/cron.hourly)
Mar 7 15:17:01 LAMP CRON[1816]: pam_unix(cron:session): session closed for user root
Mar 7 15:19:10 LAMP root: TEST LOG SUR LIBRENMS
Mar 7 15:19:16 LAMP systemd[1]: Stopping MariaDB 10.3.27 database server...
Mar 7 15:19:17 LAMP systemd[1]: mariadb.service: Succeeded.
Mar 7 15:19:17 LAMP systemd[1]: Stopped MariaDB 10.3.27 database server.
Mar 7 15:19:17 LAMP systemd[1]: Starting MariaDB 10.3.27 database server...
Mar 7 15:19:17 LAMP mysqld[1888]: 2021-03-07 15:19:17 0 [Note] /usr/sbin/mysqld (mysqld 10.3.27-MariaDB-0+deb10u1) starting as process 1888 ...
Mar 7 15:19:17 LAMP mysqld[1888]: 2021-03-07 15:19:17 0 [Warning] Could not increase number of max_open_files to more than 16384 (request: 32183)
Mar 7 15:19:17 LAMP systemd[1]: Started MariaDB 10.3.27 database server.
Mar 7 15:19:17 LAMP /etc/mysql/debian-start[1923]: Upgrading MySQL tables if necessary.
Mar 7 15:19:17 LAMP /etc/mysql/debian-start[1926]: /usr/bin/mysql_upgrade: the '--basedir' option is always ignored
Mar 7 15:19:17 LAMP /etc/mysql/debian-start[1926]: Looking for 'mysql' as: /usr/bin/mysql
Mar 7 15:19:17 LAMP /etc/mysql/debian-start[1926]: Looking for 'mysqlcheck' as: /usr/bin/mysqlcheck
Mar 7 15:19:17 LAMP /etc/mysql/debian-start[1926]: This installation of MySQL is already upgraded to 10.3.27-MariaDB, use --force if you still need to run mysql_upgrade
Mar 7 15:19:17 LAMP /etc/mysql/debian-start[1934]: Checking for insecure root accounts.
Mar 7 15:19:17 LAMP /etc/mysql/debian-start[1938]: Triggering myisam-recover for all MyISAM tables and aria-recover for all Aria tables
Mar 7 15:23:50 LAMP kernel: [ 5472.807720] audit: type=1400 audit(1615127030.428:7): apparmor="DENIED" operation="capable" profile="/usr/bin/man" pid=1979 comm="man" capability=1 capname="dac_override"
Mar 7 15:25:15 LAMP root: TEST LOG SUR LIBRENMS 111111
C’est terminé avec ce tuto vous êtes maintenant capable de centraliser vos logs avec rsyslog 😀 .