From edf9b22d3af4b41aca72081514087ba170465345 Mon Sep 17 00:00:00 2001 From: whirigoyen Date: Fri, 2 Jun 2023 10:40:20 +0200 Subject: [PATCH] Ajout sections + usage basique --- HowtoGoAccess.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/HowtoGoAccess.md b/HowtoGoAccess.md index 4a1280df..6bbdea74 100644 --- a/HowtoGoAccess.md +++ b/HowtoGoAccess.md @@ -7,6 +7,9 @@ title: Howto GoAccess [GoAccess](https://goaccess.io) est un outil pour analyser facilement des logs Apache ou Nginx (et d'autres formats) : générer rapidement une page de rapport HTML, stats ncurses et même surveillance temps réel. + +# Installation et configuration + ~~~ # apt install goaccess ~~~ @@ -35,6 +38,20 @@ Pour HAProxy, le `log-format` est le suivant : log-format %^ %^ %^ %^ %^ %^ %h:%^ [%d:%t.%^] %^ %^ %^/%^/%^/%L/%^ %s %b %^ %^ %^ %^ %^ {%v|%u} "%m %U %H" ~~~ + +# Utilisation + +~~~ +# goaccess /var/log/apache2/access.log +~~~ + +Si on veut cibler un fenêtre temporelle particulière ou accélérer le traitement, on filtrera avec grep dans un fichier temporaire : + +~~~ +# grep "" /var/log/apache2/access.log > goaccess.tmp +# goaccess access.log +~~~ + Pour générer un rapport HTML (un seul fichier, les styles sont inline) : avec GoAccess 0.8.3 : @@ -62,10 +79,14 @@ Pour avoir un access de 12h à 16h du 1er Fevrier : # goaccess -f goaccess.tmp -a -o html ~~~ + # Interface web + WebSocket + Pour avoir le suivi en temps réel dans un navigateur, il faut servir le fichier HTML généré par Goaccess ainsi que l'exécuter en tant que démon pour recevoir les données en temps réel via sa WebSocket. + ## Systemd + On peut créer une unité systemd qui lancera GoAccess et sa WebSocket. `/etc/systemd/system/goaccess.service` :