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

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

apt-get update 
apt-get install 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 sinon ils seront par defaut dans /var/lib/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

Notez au passage que vous n'êtes pas obligé de refaire entierement à chaque fois tout ce fichier si vos configurations sont toujours les memes. Ainsi il est en general plus malin de n'ecrire qu un seul fichier de configuration que l'on incluera dans les autres fichiers de configuration de la maniere suivante:

Include awstats.conf.local //par exemple

Editez awstats.domaine.tld.conf avec vi/vim (ou autre éditeur de votre choix : nano, emacs, 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"

LogFormat="..." 

//ici il vous choisir le format de log que vous utiliser sur le fichier de log de votre virtualhost. Il vous faudra faire correspondre le logformat dapache avec celui d awstats (combined, common...)
// attention ce n'esty pas la meme syntaxe de apache a awstats
// pour combined par exemple vous aurez pour apache
//LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\"\"%{User-agent}i\"" combined
// et pour votre fichier de configuration awstats, vous aurez 
LogFormat = "%host %other %logname %time1 %methodurl %code %bytesd %refererquot %uaquot"

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

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

Editez votre crontab :

crontab -e

ajoutez la ligne suivante :

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

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 
rder allow,deny 
Allow from all 
</Directory>

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

/etc/init.d/apache reload

Il suffit de créer un simple lien symbolique :

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

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 ;)