Installation et paramétrage du moteur de statistiques awstats

Ce tutoriel explique comment installer et paramétrer awstats afin de connaître l’audience de votre site.

Avant-propos

Mes données sont organisées de la façon suivante : * le site est dans /home/web/domaine.tld/www * le fichier de log d’accès est /var/log/apache/access.domaine.tld.log * les rapports de stats sont dans /home/web/domaine.tld/stats

Installation de awstats

aptitude update
aptitude install awstats

Création du répertoire de stockage des rapports awstats

Il vous suffit de créer un répertoire stats et de donner des droits sur ce répertoire :

mkdir /home/web/domaine.tld/stats
chmod 777 /home/web/domaine.tld/stats

Dans ce répertoire seront stockés les données d’awstats

Paramétrage de awstats

Rendez vous dans /etc/awstats :

cd /etc/awstats

Copiez le fichier awstats.conf en awstats.domaine.tld.conf (domaine.tld est à adapter selon votre domaine bien sur... ;) )

cp awstats.conf awstats.domaine.tld.conf

Editez awstats.domaine.tld.conf avec vi/vim (ou autre éditeur de votre choix : nano, joe, etc) :

vi awstats.domaine.tld.conf

Dans ce fichier, il vous faut adapter les valeurs suivantes :

LogFile="/var/log/apache/access.log"
devient :
LogFile="/var/log/apache/access.domaine.tld.log"

SiteDomaine=""
devient
SiteDomain="domaine.tld"

HostAliases="localhost 127.0.0.1"
devient :
HostAliases="localhost 127.0.0.1 www.domaine.tld"

DirData="/var/lib/awstats"
devient :
DirData="/home/web/domaine.tld/stats"

URLWithQuery=0
devient :
URLWithQuery=1

Générer votre premier rapport

/usr/lib/cgi-bin/awstats.pl -config=domaine.tld -update

Générer votre rapport tous les matins à 6h (tâche cron)

Editez votre crontab :

crontab -e

ajoutez la ligne suivante :

0 6 * * * /usr/lib/cgi-bin/awstats.pl -config=domaine.tld -update >/dev/null

Mise en place du cgi

Assurez-vous d’avoir la directive suivante dans votre virtual host apache. Au besoin, rajoutez-les :

ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/
<Directory "/usr/lib/cgi-bin">
    AllowOverride None
    Options ExecCGI -MultiViews +SymLinksIfOwnerMatch
    Order allow,deny
    Allow from all
</Directory>

Si vous les avez rajouté, n’oubliez pas de relancer Apache :

/etc/init.d/apache reload

Ajoutez les icones à votre rapport

Il suffit de créer un simple lien symbolique :

ln -s /usr/share/awstats/icon /home/web/domaine.tld/www/awstats-icon

Accédez à vos stats...

Rendez vous sur : http://www.domaine.tld/cgi-bin/awstats.pl?config=domaine.tld

Et voilà...

Si vous avez plusieurs domaines, il vous suffit de répéter les mêmes étapes depuis le début ;)