Comment installer GoAccess Log Analyzer sur Ubuntu 24.04

GoAccess est un analyseur de journaux web en temps réel pour les systèmes de type Unix, y compris Ubuntu. Il fournit un moyen efficace et convivial de visualiser et d’analyser les journaux des serveurs web, prenant en charge divers formats comme les journaux Apache, Nginx et Amazon S3. GoAccess peut être exécuté dans le terminal ou comme une interface web, offrant des rapports dynamiques avec des métriques essentielles telles que le nombre de visiteurs, les détails des requêtes, les emplacements géographiques et les sites référents. Il est apprécié pour sa rapidité, son interactivité et ses informations complètes, ce qui en fait un outil précieux pour les administrateurs système et les développeurs cherchant à surveiller et optimiser les performances des serveurs web sur les systèmes Ubuntu.

Dans ce guide, vous apprendrez à installer GoAccess Log Analyzer sur un serveur Ubuntu 24.04.

Prérequis

Avant de commencer, assurez-vous d’avoir les éléments suivants :

Un serveur Ubuntu 24.04.
Un utilisateur non-root avec des privilèges d’administrateur.
Un serveur web Apache/Nginx installé.

Installation de GoAccess avec APT

GoAccess Log Analyzer peut être installé de deux manières différentes, via le gestionnaire de paquets et manuellement à partir du code source. Dans cette section, vous apprendrez à installer GoAccess sur Ubuntu avec le gestionnaire de paquets APT.

Tout d’abord, exécutez la commande suivante pour ajouter la clé GPG pour le dépôt GoAccess.

wget -O - https://deb.goaccess.io/gnugpg.key | gpg --dearmor | sudo tee /usr/share/keyrings/goaccess.gpg >/dev/null

Ajoutez le dépôt GoAccess pour les distributions basées sur Ubuntu/Debian en utilisant la commande ci-dessous.

echo "deb [signed-by=/usr/share/keyrings/goaccess.gpg arch=$(dpkg --print-architecture)] https://deb.goaccess.io/ $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/goaccess.list

Ensuite, exécutez la commande ‘apt’ suivante pour mettre à jour l’index des paquets Ubuntu et installer le ‘ goaccess ‘. Entrez ‘ Y ‘ pour confirmer l’installation.

sudo apt update && sudo apt install goaccess

add repo update instakk

Après l’installation, localisez le fichier binaire ‘ goaccess ‘ et vérifiez la version de ‘ goaccess ‘ avec ce qui suit :

which goaccess  
goaccess --version

Comme vous pouvez le voir ci-dessous, GoAccess 1.9.3 est installé à ‘ /usr/bin/goaccess ‘.

check goaccess

Installation de GoAccess à partir du code source

Si vous souhaitez construire GoAccess manuellement à partir du code source, vous pouvez utiliser les étapes suivantes :

Avant de compiler GoAccess, exécutez la commande ‘apt’ suivante pour installer les dépendances des paquets.

sudo apt install libncursesw5-dev libgeoip-dev libtokyocabinet-dev build-essential

install deps

Visitez la page de téléchargement de GoAccess, récupérez le lien pour la dernière version, puis téléchargez le code source de GoAccess et extrayez-le avec la commande ‘tar’ ci-dessous.

wget https://tar.goaccess.io/goaccess-1.9.3.tar.gz  
tar -xzvf goaccess-1.9.3.tar.gz

Déplacez-vous dans le répertoire ‘ goaccess- ‘ et configurez votre installation avec ce qui suit. Dans cet exemple, vous activerez le support GeoIP via le fichier de base de données ‘ mmdb* ‘.

cd goaccess-*/  
./configure --enable-utf8 --enable-geoip=mmdb

configure build

Exécutez maintenant la commande ci-dessous pour compiler GoAccess et l’installer sur votre système. Une fois exécuté, GoAccess sera installé à ‘ /usr/local/bin/goaccess ‘ avec le répertoire de configuration par défaut ‘ /usr/local/etc/goaccess ‘.

sudo make && sudo make install

compile install

Exécutez maintenant la commande ci-dessous pour vérifier votre version de GoAccess. Vous pouvez voir ci-dessous que GoAccess 1.9.3 est installé à /usr/local/bin/goaccess.

which goaccess  
goaccess --version

check version

Intégration de GoAccess avec la base de données GeoIP

GoAccess Log Analyzer prend en charge l’intégration GeoIP. Avec cela, vous pouvez afficher le pays d’origine des visiteurs. Dans cette section, vous configurerez GoAccess et l’intégrerez avec le fichier de base de données GeoIP.

Tout d’abord, visitez https://db-ip.com/db/lite.php et récupérez le lien pour le fichier de base de données GeoIP et téléchargez-le en utilisant la commande ‘ wget ‘ ci-dessous.

wget https://download.db-ip.com/free/dbip-country-lite-2024-07.mmdb.gz

Extrayez le fichier de base de données GeoIP dans le répertoire /opt/geoip avec ce qui suit.

gunzip dbip-country-lite-2024-07.mmdb.gz /opt/geoip/

Ensuite, exécutez la commande ‘ goaccess ‘ ci-dessous pour localiser le répertoire de configuration par défaut. Si vous installez via APT, votre répertoire GoAccess sera situé dans le répertoire ‘/etc/goaccess’. Si vous compilez à partir du code source, votre répertoire GoAccess est situé dans le répertoire ‘ /usr/local/etc/goaccess ‘.

goaccess --dcf

Ouvrez maintenant le fichier de configuration GoAccess ‘ /usr/local/etc/goaccess/goaccess.conf ‘ avec la commande de l’éditeur ‘ nano ‘ suivante.

sudo nano /usr/local/etc/goaccess/goaccess.conf

Décommentez les lignes ‘time-format’ et ‘ date-format ‘ comme suit :

# Le format de temps suivant fonctionne avec n'importe lequel des  
# formats de journaux Apache/NGINX ci-dessous.  
#  
time-format %H:%M:%S  
  
# Le format de date suivant fonctionne avec n'importe lequel des  
# formats de journaux Apache/NGINX ci-dessous.  
#  
date-format %d/%b/%Y

Sur l’option ‘log-format’, changez-la en ‘ COMBINED ‘ pour les journaux Nginx/Apache courants.

log-format COMBINED  
  
or  
log-format VCOMBINED  
log-format %v:%^ %h %^[%d:%t %^] "%r" %s %b "%R" "%u"

Décommentez l’option ‘ geoip ‘ et ajoutez le chemin du fichier de base de données GeoIP.

geoip-database /home/geoip/dbip-country-lite-2021-10.mmdb

Lorsque vous avez terminé, enregistrez le fichier et quittez l’éditeur.

Analyse des journaux Apache/Nginx avec GoAccess

Maintenant que vous avez configuré GoAccess et l’avez intégré avec GeoIP. Dans l’étape suivante, vous apprendrez à analyser les fichiers journaux avec GoAccess.

Pour analyser les journaux avec GoAccess, exécutez la commande ‘ goaccess ‘ ci-dessous.

goaccess access.log

Vous pouvez voir une sortie comme suit :

Visiteurs uniques par jour : listes de visiteurs uniques par jour.
Fichiers demandés (URLs) : fichiers les plus demandés - pour les fichiers non statiques.
Demandes statiques : listes des demandes pour des fichiers statiques tels que des images, CSS et JavaScript.
URLs non trouvées (404) : pages d’erreurs 404 non trouvées.
Noms d’hôtes et IP des visiteurs : listes des noms d’hôtes et adresses IP des visiteurs. Vous pouvez développer pour obtenir des informations telles que le pays, la ville et le rDNS.
Systèmes d’exploitation : afficher les systèmes d’exploitation des visiteurs.
Navigateurs : afficher les navigateurs web des visiteurs.
Distribution temporelle : afficher des rapports horaires pour les visiteurs uniques, le nombre de hits et la bande passante consommée.
Hôtes virtuels : afficher les journaux des hôtes virtuels. Actif uniquement lorsque vous activez VCOMBINED ou ‘%s’ sur l’option ‘log-format’.
URLs référentes : afficher les référents des visiteurs.

Vous pouvez également utiliser les touches suivantes pour naviguer dans GoAccess :

TAB pour avancer entre les sections ou SHIFT+TAB pour reculer.
F5 pour rafraîchir le tableau de bord goaccess.
j pour faire défiler vers le bas et k pour faire défiler vers le haut.
/ pour rechercher un motif, puis tapez n pour avancer.
q pour quitter le tableau de bord.
F1 ou h pour afficher l’aide.

Ci-dessous, vous pouvez voir le tableau de bord GoAccess par défaut :

check logs

Avec l’intégration GeoIP, vous verrez la section ‘ Géolocalisation ‘ comme suit :

geoip

Génération de rapports avec GoAccess

Dans cette section, vous générerez des rapports de journaux au format HTML, JSON et CSV en utilisant GoAccess Log Analyzer. Vous configurerez également un analyseur de journaux en temps réel.

Pour générer des rapports HTML pour GoAccess, incluez l’option ‘-o’ suivie de ‘filename.html’ comme suit :

goaccess access.log -o access-log.html

Utilisez maintenant votre navigateur web et accédez au fichier ‘ access-log.html ‘. Vous verrez le rapport GoAccess suivant :

exported

En plus de cela, vous pouvez également générer des rapports de journaux au format JSON et CSV. Utilisez la commande ‘goaccess’ ci-dessous.

goaccess access.log -a -d -o access.json  
goaccess access.log --no-csv-summary -o access.csv

Ensuite, vous pouvez également configurer la surveillance des journaux en temps réel avec la commande ‘ goaccess ‘ suivante.

goaccess access.log -o /var/www/html/reports.html --real-time-html

Accédez maintenant à la page ‘reports.html’ à l’aide d’un navigateur web et vous verrez les rapports en temps réel générés par GoAccess.

real time via websocket

Conclusion

Félicitations ! Vous avez terminé l’installation de GoAccess Log Analyzer sur un serveur Ubuntu 24.04. Vous avez appris à installer GoAccess avec APT et à partir du code source. Ensuite, vous avez appris à analyser des fichiers journaux avec GoAccess, générant des rapports de journaux dans plusieurs formats comme HTML, JSON et CSV. Enfin, vous avez effectué un analyseur de journaux en temps réel avec GoAccess.