AWStats

AWStats est un utilitaire qui permet d'afficher sous forme graphique les historiques de fréquentation. Il est sous licence GPL.

Prérequis

Pour mon installation j'ai utilisé :

- Un serveur avec une Debian v4 (Etch) et apache2 installé dessus. - Un site web … bein ouai c'est le minimum ;) - Awstats v6.8 (La dernière version stable au moment ou j'ai écrit ces lignes.) - Un nom de domaine

Installation

Pour commencer, créer un dossier où l'utilisateur aura accès en écriture (chmod 755 ) pour créer une base de données. Je l'ai mis dans : /home/user/awstatsdt

J'avais dans un premier temps nommé le dossier awstats_data mais j'ai eu un message d'erreur me disant que le dossier n'existe pas ou qu'il y a un problème de droit. Je pense que le nom devait être trop long. A confirmer. De plus, le problème est peut être réglé dans les versions suivantes.

1. Il faut télécharger le fichier awstats-6.8.tgz ou awstats-6.8.zip et le décompresser. On obtient un dossier qui se nomme awstats-6.8 2. Renomer le dossier awstats et le copier dans le répertoire /usr/local/. Je l'avais mis ailleurs au départ mais lors de l'installation, un message d'avertissement m'a indiqué que je ne l'avais pas mis à l'endroit “standard”. L'endroit standard étant /usr/local/ 3. Il faut ensuite créer le fichier de configuration. Pour cela, lancer le script de configuration.

perl /usr/local/awstats/tools/awstats_configure.pl

4. La permière question que nous pose le scripte, est où se trouve le fichier de configuration de apache. J'utilise apache 2 le fichier se trouve donc chez moi : /etc/apache2/apache2.conf

5. La question suivante nous demande si vous voulez créer le fichier de configuration. En précisant que c'est obligatoire dans le cas d'une première installation …. répondre y.

6. Ensuite on vous demande de donner le nom de votre site ou de votre profile. Pour mon site ( www.monsite.fr ) j'ai mis monsite. Important puisque le nom du fichier de configuration va donner un truc genre awstats.monsite.conf.

7. On vous demande ensuite ou doit se trouver le fichier de configuration. Pour le laisser à l'emplacement par defaut, tapez juste sur entrer.

Le fichier de conf est donc maintenant créé. Nous allons devoir l'éditer pour modifier plusieurs paramètres.

Perso j'utilise vi …

8. Ca donne :

vi /etc/awstats/awstats.monsite.conf

rapplez vous : remplacez monsite par le nom que vous avez donné en 6

9. les lignes qui vont être à modifier sont:

LogFile="/var/log/apache2/access.log"
LogType=W
LogFormat=1
SiteDomain="www.monsite.fr"
HostAliases="127.0.0.1 localhost"
DirData="/home/marc/awstatsdt"

DirData : C'est dans ce dossier (celuis que l'on a créé au début) que se trouvera la base de donnée qui serra utilisé pour générer le rapport.

10. On a maintenant un fichier de conf prêt à fonctionner. On va donc créer notre base de données Pour cela, lancer la ligne de commande

perl /usr/local/awstats/wwwroot/cgi-bin/awstats.pl -config=monsite -update

Cette commande est a utiliser pour créer la base mais aussi pour la mettre a jour plus tard.

Normalement cette commande devrais vous donner un retour comme ca:

Update for config "/etc/awstats/awstats.monsite.conf"
With data in log file "/var/log/apache2/apache2.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 20000000 hosts)...
Jumped lines in file: 0
Parsed lines in file: 651651631582302
ï¿½Found 52 dropped records,
ï¿½Found 0 corrupted records,
ï¿½Found 0 old records,
ï¿½Found 205602650565055026501 new qualified records.

Bon ok j'ai un peu triché sur les chiffres mais dans le principe ca doit etre ca :p

Notre base est donc maintenant créé on va pouvoir générer notre rapport. On utilise pour ca une autre ligne de commande. J'ai créé un dossier stats dans le dossier racine de mon site web et j'y redirige le rapport. J'ai fait ca pour pouvoir consulter le rapport depuis n'importe ou. A vous de voir ou vous le voulez :

perl /usr/local/awstats/wwwroot/cgi-bin/awstats.pl -config=monsite -output -staticlinks > /home/marc/Site_web/stats/awstats.monsite.html

si la page se créé bien, on va pouvoir créer les pages spéciales individuelles:

perl /usr/local/awstats/wwwroot/cgi-bin/awstats.pl -config=monsite -output=alldomains -staticlinks > /home/marc/Site_web/stats/awstats.monsite.alldomains.html
perl /usr/local/awstats/wwwroot/cgi-bin/awstats.pl -config=monsite -output=allhosts -staticlinks > /home/marc/Site_web/stats/awstats.monsite.allhosts.html
perl /usr/local/awstats/wwwroot/cgi-bin/awstats.pl -config=monsite -output=lasthosts -staticlinks > /home/marc/Site_web/stats/awstats.monsite.lasthosts.html
perl /usr/local/awstats/wwwroot/cgi-bin/awstats.pl -config=monsite -output=unknownip -staticlinks > /home/marc/Site_web/stats/awstats.monsite.unknownip.html
perl /usr/local/awstats/wwwroot/cgi-bin/awstats.pl -config=monsite -output=alllogins -staticlinks > /home/marc/Site_web/stats/awstats.monsite.alllogins.html
perl /usr/local/awstats/wwwroot/cgi-bin/awstats.pl -config=monsite -output=lastlogins -staticlinks > /home/marc/Site_web/stats/awstats.monsite.lastlogins.html
perl /usr/local/awstats/wwwroot/cgi-bin/awstats.pl -config=monsite -output=allrobots -staticlinks > /home/marc/Site_web/stats/awstats.monsite.allrobots.html
perl /usr/local/awstats/wwwroot/cgi-bin/awstats.pl -config=monsite -output=lastrobots -staticlinks > /home/marc/Site_web/stats/awstats.monsite.lastrobots.html
perl /usr/local/awstats/wwwroot/cgi-bin/awstats.pl -config=monsite -output=urldetail -staticlinks > /home/marc/Site_web/stats/awstats.monsite.urldetail.html
perl /usr/local/awstats/wwwroot/cgi-bin/awstats.pl -config=monsite -output=urlentry -staticlinks > /home/marc/Site_web/stats/awstats.monsite.urlentry.html
perl /usr/local/awstats/wwwroot/cgi-bin/awstats.pl -config=monsite -output=urlexit -staticlinks > /home/marc/Site_web/stats/awstats.monsite.urlexit.html
perl /usr/local/awstats/wwwroot/cgi-bin/awstats.pl -config=monsite -output=browserdetail -staticlinks > /home/marc/Site_web/stats/awstats.monsite.browserdetail.html
perl /usr/local/awstats/wwwroot/cgi-bin/awstats.pl -config=monsite -output=osdetail -staticlinks > /home/marc/Site_web/stats/awstats.monsite.osdetail.html
perl /usr/local/awstats/wwwroot/cgi-bin/awstats.pl -config=monsite -output=unknownbrowser -staticlinks > /home/marc/Site_web/stats/awstats.monsite.unknownbrowser.html
perl /usr/local/awstats/wwwroot/cgi-bin/awstats.pl -config=monsite -output=unknownos -staticlinks > /home/marc/Site_web/stats/awstats.monsite.unknownos.html
perl /usr/local/awstats/wwwroot/cgi-bin/awstats.pl -config=monsite -output=refererse -staticlinks > /home/marc/Site_web/stats/awstats.monsite.refererse.html
perl /usr/local/awstats/wwwroot/cgi-bin/awstats.pl -config=monsite -output=refererpages -staticlinks > /home/marc/Site_web/stats/awstats.monsite.refererpages.html
perl /usr/local/awstats/wwwroot/cgi-bin/awstats.pl -config=monsite -output=keyphrases -staticlinks > /home/marc/Site_web/stats/awstats.monsite.keyphrases.html
perl /usr/local/awstats/wwwroot/cgi-bin/awstats.pl -config=monsite -output=keywords -staticlinks > /home/marc/Site_web/stats/awstats.monsite.keywords.html
perl /usr/local/awstats/wwwroot/cgi-bin/awstats.pl -config=monsite -output=errors404 -staticlinks > /home/marc/Site_web/stats/awstats.monsite.errors404.html

Ensuite l'idée est de mettre tout ca dans un script shell pour pouvoir automatiser le tout. C'est à dire la mise à jour de la base de données et la mise à jour du rapport.

Il ne reste plus qu'a ajouter a votre contab la ligne suivante:

0 2 * * * /le/chemain/de/votre/script.sh > /dev/null

cela lancera la mise à jours tous les jours à 2 heures.

voila il ne vous reste plus qu'a ouvrir le fichier awstats.monsite.html pour contempler les statistiques de visite de votre site.