Installation de AWStats

Ceci est une ancienne révision du document !

AWStats permet de visualiser les statistiques liées à un site web, telles que le nombre de visite par jour ou encore l'origine des visiteurs. Il s'agit d'un complément appréciable de tout site web.

<note important>Toute l'installation et la configuration se passe en tant que root. Ce tutoriel a été réalisé sur une version Jessie de Debian sur lequel tourne un serveur apache 2.4.</note>

On commence par mettre à jour ses dépôts apt :

apt-get update

Une fois les bases à jour, on peut installer les paquets nécessaires :

apt-get install awstats libmldbm-perl libnet-xwhois-perl libgeo-ipfree-perl

AWStats est désormais installé, il faut maintenant le paramétrer.

Il va falloir maintenant créer un fichier de configuration pour chaque vHost présent sur le serveur Apache. On commence par se rendre dans le dossier de configuration de AWStats :

cd /etc/awstats/

On duplique le fichier awstats.conf en lui ajoutant l'url de contact du vhost, par exemple pour www.shyrkasystem.com :

cp awstats.conf awstats.www.shyrkasystem.com.conf

Ensuite, il faut éditer le fichier créé :

nano awstats.www.shyrkasystem.com.conf

Dans ce fichier, on va modifier les lignes suivantes pour leur donner ou s'assurer qu'elles ont les valeurs suivantes :
- LogFile="/var/log/apache2/shyrkasystem.com/access.log" ←- On indique ici le chemin exacte du access.log correspondant au site
- LogType=W
- LogFormat=1
- SiteDomain="www.shyrkasystem.com" ←- On indique ici l'url du site
- HostAliases="127.0.0.1 192.168.1.254 https://www.shyrkasystem.com www.shyrkasystem.com" ←- On ajoute les url simples et avec protocole
Une fois les modifications faites, on enregistre et on recommence avec le vHost suivant jusqu'au dernier.

Pour vérifier que les fichiers de configuration sont correct, on peut lancer AWStats en ligne de commande :

/usr/lib/cgi-bin/awstats.pl -config=www.shyrkasystem.com -update

Si tout va bien et après quelques instants, la console affiche un message de ce type :

Update for config "/etc/awstats/awstats.www.shyrkasystem.com.conf"
With data in log file "/var/log/apache/shyrkasystem.com/access.log"...
Phase 1 : First bypass old records, searching new record...
Searching new records from beginning of log file...
Phase 2 : Now process new records (Flush history on disk after 20000 hosts)...
Jumped lines in file: 0
Parsed lines in file: 12345
 Found 0 dropped records,
 Found 0 corrupted records,
 Found 0 old records,
 Found 12345 new qualified records.

Pour visualiser les statistiques depuis une interface web, on va commencer par créer un fichier de configuration Apache :

nano /etc/apache2/sites-available/awstats.conf

Nous le remplissons avec les informations suivantes :

Alias /awstatsclasses "/usr/share/awstats/classes/"
Alias /awstatscss "/usr/share/awstats/css/"
Alias /awstats-icon "/usr/share/awstats/icon/"
 
# ScriptAlias pour Apache 2.4
ScriptAlias /stats /usr/lib/cgi-bin/
 
# mêmes paramètres que dans awstats.*.conf
<Directory /usr/lib/cgi-bin/>
  DirectoryIndex awstats.pl
  UseCanonicalName off
  AllowOverride All
  AuthName "Statistiques awstats"
  AuthType Basic
  Require valid-user
  AuthUserFile /var/www/.password
  Options +ExecCGI
  AllowOverride None
</Directory>

On crée le fichier contenant l'utilisateur et son mot de passe pour l'accès à la page, par exemple pour l'utilisateur nekan :

htpasswd -c /var/www/.password nekan

On renseigne le mot de passe comme demandé et on le confirme en suivant.
Il nous reste plus qu'à activer le site :

a2ensite awstats

Enfin, on recharge le service Apache :

/etc/init.d/apache2 reload

On peut désormais afficher les statistiques du site en ajoutant /stats à la fin de son url, par exemple www.shyrkasystem.com/stats.
Une demande d'authentification apparaît :