Configuration de la journalisation dans HAProxy
Il existe différents cas où vous pouvez utiliser HAProxy dans votre infrastructure. Que vous l'utilisiez comme équilibreur de charge pour votre serveur Web ou votre conteneurisation, vous devez comprendre comment fonctionne la journalisation et quelles étapes suivre pour la configurer. Sans une méthode propre de journalisation des erreurs, le dépannage de HAProxy sera une tâche difficile.
Heureusement, vous pouvez configurer la journalisation pour vous aider à détecter, surveiller et dépanner HAProxy pour une intégration et un service fluides. Il existe différents outils de journalisation que vous pouvez utiliser, mais ce guide se concentre sur l'outil Rsyslog pour gérer les messages syslog.
Voici comment configurer la journalisation dans HAProxy :
Étape 1 : Assurez-vous que Rsyslog est installé
Ce didacticiel utilise l'outil de journalisation Rsyslog pour HAProxy. Par conséquent, assurez-vous qu’il est installé sur votre système. Vérifiez-le en vérifiant sa version.
Les derniers systèmes Linux sont livrés avec Rsyslog préinstallé. Si vous ne l'avez pas installé, exécutez la commande suivante :
$ sudo apt installer rsyslog
Étape 2 : Modifier le fichier de configuration HAProxy
Une fois que Rsyslog est disponible sur votre système, l'étape suivante consiste à accéder au fichier de configuration HAProxy et à définir la manière dont nous souhaitons que notre journalisation soit gérée. Le fichier de configuration se trouve dans « /etc/haproxy/haproxy.cfg ». Ouvrez-le avec un éditeur de votre choix.
sudo nano /etc/haproxy/haproxy.cfgDans la section globale, c'est là que nous spécifions comment nous voulons que la journalisation HAProxy se produise. Si vous disposez d'un serveur Syslog qui écoute sur un port donné, tel que le port UDP 514, vous pouvez lui envoyer les journaux via la fonction « local0 » avec la ligne suivante :
Alternativement, vous pouvez choisir d'envoyer les journaux vers le socket « /dev/log » et d'y accéder à l'aide de Rsyslog. Pour cela, ajoutez la ligne suivante à votre fichier de configuration :
Notez que le mot-clé « log » doit être inclus car il donne les directives pour envoyer les journaux au serveur ou socket syslog spécifié. Encore une fois, si vous souhaitez spécifier un niveau de sécurité donné pour les logs, ajoutez son nom à la fin de l'instruction comme nous l'avons fait pour le niveau de sécurité des notifications.
Il existe plusieurs niveaux de sécurité que vous pouvez enregistrer. Si vous ne spécifiez pas le type de niveau de sécurité comme nous l'avons fait avec la première ligne de la déclaration, le fichier journal contiendra tous les messages de journal partagés par HAProxy et peut être volumineux en fonction des messages enregistrés. Par conséquent, pensez à être précis sur ce que vous souhaitez enregistrer sur votre serveur ou socket Syslog.
Dans la section « Valeurs par défaut », assurez-vous d'avoir la ligne suivante :
L'instruction garantit que toutes les sections proxy suivantes du fichier de configuration, telles que le backend, enregistreront les messages en utilisant les critères que vous avez spécifiés dans la section globale. Cependant, vous pouvez choisir d'utiliser des critères de journal spécifiques pour chaque proxy afin de capturer le type de niveau de sécurité que vous ciblez. Une fois que vous avez spécifié le serveur ou le socket Syslog à utiliser, enregistrez les modifications et quittez le fichier.
Étape 3 : Modifier le fichier de configuration Rsyslog
Dans le fichier de configuration rsyslog, nous devons indiquer à rsyslog où enregistrer les journaux HAProxy. Dans ce cas, nous souhaitons enregistrer les journaux généraux et les journaux de niveau notification. Par conséquent, ouvrez le fichier de configuration et ajoutez les instructions suivantes en bas :
Enregistrez les modifications et quittez le fichier. Rsyslog enverra les messages de journal à l'un des fichiers journaux que vous avez précédemment spécifiés en fonction du type de message de journal généré.
Étape 4 : Redémarrez les services
Vous devez ensuite redémarrer les services HAProxy et rsyslog. Exécutez les commandes suivantes en utilisant « systemctl » :
$ sudo systemctl redémarrer rsyslog.service$ sudo systemctl redémarrer haproxy.service
Étape 5 : tester la journalisation
Vos journaux HAProxy sont maintenant configurés. L'étape restante consiste à vérifier que la journalisation fonctionne. Pour le tester, nous utilisons la commande « tail » pour afficher les dernières lignes de notre fichier log en temps réel.
Remarquez comment nous spécifions le même chemin que celui que nous avons spécifié plus tôt dans le fichier de configuration « rsyslog ».
Le résultat donné confirme que nous avons configuré avec succès notre journalisation HAProxy. N'hésitez pas à modifier les fichiers de configuration pour les adapter au type de journaux que vous souhaitez capturer.
Conclusion
HAProxy a diverses applications. Quelle que soit la manière dont vous choisissez de l'utiliser, la journalisation est essentielle pour prévenir les erreurs et aider à résoudre les problèmes. Nous avons appris les étapes de configuration de la journalisation HAProxy, de la modification des fichiers de configuration à la spécification de l'emplacement de stockage des journaux jusqu'au test du fonctionnement de la journalisation. J'espère que vous pouvez maintenant configurer la journalisation HAProxy pour votre cas.