evolix/wiki
22
0
Fork 0
Code Releases Activity

relecture

Browse source
This commit is contained in:
Gregory Colpart 2023-07-28 17:11:54 +02:00
parent 8d1d76b4c3
commit 9f6edcca1d
1 changed files with 25 additions and 20 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

45
HowtoGoAccess.md
View file

@ -4,17 +4,25 @@ title: Howto GoAccess
...
* Documentation: <https://goaccess.io/man>
* 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 :
~~~
<VirtualHost *:443>
@ -144,22 +151,20 @@ On sert /var/www/goaccess.html via Apache et on proxifie le WebSocket :
</VirtualHost>
~~~
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` :