Ajout sections + usage basique

This commit is contained in:
whirigoyen 2023-06-02 10:40:20 +02:00
parent 9242359dad
commit edf9b22d3a

View file

@ -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 "<PATTERN>" /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` :