From 9f6edcca1d926676094fc53cf78fefff4c317dbc Mon Sep 17 00:00:00 2001 From: Gregory Colpart Date: Fri, 28 Jul 2023 17:11:54 +0200 Subject: [PATCH] relecture --- HowtoGoAccess.md | 45 +++++++++++++++++++++++++-------------------- 1 file changed, 25 insertions(+), 20 deletions(-) diff --git a/HowtoGoAccess.md b/HowtoGoAccess.md index 79d5a316..e90faf82 100644 --- a/HowtoGoAccess.md +++ b/HowtoGoAccess.md @@ -4,17 +4,25 @@ title: Howto GoAccess ... * Documentation: +* Statut de cette page : test / bookworm [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 +## Installation ~~~ -# apt install goaccess - -# Sous Debian Buster # apt install goaccess geoip-database + +goaccess -V +GoAccess - 1.7. +For more details visit: https://goaccess.io/ +Copyright (C) 2009-2022 by Gerardo Orellana + +Build configure arguments: + --enable-utf8 + --enable-geoip=mmdb + --with-openssl ~~~ Si besoin d'une version plus récente, l'upstream distribue des paquets Debian avec une version plus récente. @@ -27,6 +35,8 @@ Si besoin d'une version plus récente, l'upstream distribue des paquets Debian a # apt update && apt install goaccess geoip-database ~~~ +## Configuration + Il faut ensuite éditer `/etc/goaccess.conf`, en choisissant le format de log, par exemple : ~~~ @@ -42,7 +52,7 @@ log-format %^ %^ %^ %^ %^ %^ %h:%^ [%d:%t.%^] %^ %^ %^/%^/%^/%L/%^ %s %b %^ %^ % ~~~ -# Utilisation +## Utilisation Raccourcis de base pour naviguer dans l'interface NCurse : @@ -96,14 +106,12 @@ Pour avoir un access de 12h à 16h du 1er Fevrier : ~~~ -# Installer l'interface web de GoAccess (via WebSocket) +## Interface web GoAccess via 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. +On peut créer une unité [systemd](HowtoSystemd) qui lancera GoAccess et sa WebSocket. `/etc/systemd/system/goaccess.service` : @@ -127,8 +135,7 @@ WantedBy=default.target # systemctl start goaccess ~~~ -## Apache -On sert /var/www/goaccess.html via Apache et on proxifie le WebSocket : +On sert ensuite `/var/www/goaccess.html` via [Apache](HowtoApache) et on « proxifie » par la WebSocket : ~~~ @@ -144,22 +151,20 @@ On sert /var/www/goaccess.html via Apache et on proxifie le WebSocket : ~~~ -Notez qu'ainsi Apache fait la terminaison SSL sans que Goaccess ai besoin d'accéder aux certificats. +Notez qu'ainsi Apache fait la terminaison SSL sans que Goaccess accède aux certificats. -## Goaccess - -On indique au client Goaccess (dans le navigateur) d'accéder au WebSocket via l'URL proxifié par Apache. Il est important d'utiliser un nom de domaine et non une adresse IP autrement Apache dirigera la requête vers le Vhost par défaut, ici example.org. +Enfin, nous pouvons indiquer au client Goaccess (dans le navigateur) d'accéder au WebSocket via l'URL proxifié par Apache. Il est important d'utiliser un nom de domaine et non une adresse IP autrement Apache dirigera la requête vers le Vhost par défaut, ici example.com. `/etc/goaccess/goaccess.conf` : ~~~ -ws-url wss://example.org:443/goaccess.ws/ +ws-url wss://example.com:443/goaccess.ws/ ~~~ -# Erreurs +## FAQ -## `Fatal error has occurred` +### `Fatal error has occurred` ~~~ Fatal error has occurred @@ -167,10 +172,10 @@ Error occured at: src/parser.c - parse_log - xxxx No log format was found on your conf file. ~~~ -Si cette erreur survient, il faut modifier le fichier de conf /etc/goaccess.conf pour décommenter les valeurs logformat correspondant. +Si cette erreur survient, il faut modifier le fichier de conf `/etc/goaccess.conf` pour décommenter les valeurs `logformat` correspondantes. -## Géolocalisation manquante +### Géolocalisation manquante Installer le paquet `geoip-database` :