ZikossWiki

AWSTATS est un outil de génération de statistiques Web accessible en ligne.

Ce tutoriel, validé sous Debian 5, décrit l'installation d'awstats pour plusieurs sites avec accès restreint

Pour installer awstats lancer les commandes suivantes :

cd /usr/local
wget http://prdownloads.sourceforge.net/awstats/awstats-6.95.tar.gz
tar xzf awstats-6.95.tar.gz
mv awstats-6.95 awstats

Il faut lancer le scripts de configuration :

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

• Ne pas valider la configuration automatique d'apache, nous le feront manuellement.
• Indiquer le nom du premier site web pour créer le premier fichier de configuration, ex : www.monsite1.com
• Indiquer l'emplacement des fichiers de configuration des sites : /etc/awstats

Se référer au tutoriel apache pour une configuration optimisée.

Par exemple pour un Virtual Host dédié aux statistiques créer un fichier avec la configuration suivante :

<VirtualHost *:80>
      ServerName stat.domaine.com

      ServerAdmin webmaster@localhost

      #
      # Directives to allow use of AWStats as a CGI
      #
      Alias /awstatsclasses "/usr/local/awstats/wwwroot/classes/"
      Alias /awstatscss "/usr/local/awstats/wwwroot/css/"
      Alias /awstatsicons "/usr/local/awstats/wwwroot/icon/"
      ScriptAlias /awstats/ "/usr/local/awstats/wwwroot/cgi-bin/"

      #
      # This is to permit URL access to scripts/files in AWStats directory.
      #
      <Directory "/usr/local/awstats/wwwroot">
              Options None
              AllowOverride AuthConfig
              #AllowOverride None
              Order allow,deny
              Allow from all
      </Directory>

</VirtualHost>

Sinon contentez vous de la configuration suivante :

      #
      # Directives to allow use of AWStats as a CGI
      #
      Alias /awstatsclasses "/usr/local/awstats/wwwroot/classes/"
      Alias /awstatscss "/usr/local/awstats/wwwroot/css/"
      Alias /awstatsicons "/usr/local/awstats/wwwroot/icon/"
      ScriptAlias /awstats/ "/usr/local/awstats/wwwroot/cgi-bin/"

      #
      # This is to permit URL access to scripts/files in AWStats directory.
      #
      <Directory "/usr/local/awstats/wwwroot">
              Options None
              AllowOverride AuthConfig
              #AllowOverride None
              Order allow,deny
              Allow from all
      </Directory>

Créer maintenant le fichier d'authentification /usr/local/awstats/wwwroot/.htaccess“ et insérer les lignes suivantes :

AuthUserFile "/usr/local/awstats/.htpasswd"
AuthName "Acces Restreint"
AuthType Basic
require valid-user

Créer le fichier mot de passe avec un premier compte adimstat en lançant la commande suivante :

htpasswd -c /usr/local/awstats/.htpasswd adminstat

Dans la précédente étape, le script de configuration d'AWStats a créer le premier fichier de configuration, ex : /etc/awstats/awstats.www.monsite1.com.conf.

Editer ce fichier pour paramétrer les statistiques du site www.monsite1.com. Les valeurs qui nécessitent une attention sont décrites ci-dessous :

# zmergelog est un outil qui permet de consolider les fichiers log compressés et non compressés
LogFile="zmergelog /var/log/apache2/access_www.monsite1.com.log* |"
# Vous pouvez sinon simplement indiquer le nom exacte du fichier log pour un rapport quotidien
LogFile="/var/log/apache2/access_www.site1.com.log"

# Indiquer ici le nom du site et ses Alias
SiteDomain="www.monsite1.com"
HostAliases="monsite1.com www.monsite1.com"

# Répertoire de stockage des rapports statistiques, qu'il faudra créer
DirData="/var/lib/awstats"

# Pour indiquer que l'accès au rapport statistique nécessite une authentification.
# 0=accès libre
# 1=accès restreint par mot de passe
AllowAccessFromWebToAuthenticatedUsersOnly=1
# Liste des utilisateurs autoriser à consulter le rapport. ici user_site1 et adminstat sont autorisé. Attention l'utilisateur doit figurer aussi dans .htpasswd
AllowAccessFromWebToFollowingAuthenticatedUsers="user_site1 adminstat"

Créer le répertoire de stockage des rapports statistiques :

mkdir /var/lib/awstats

Créer l'utilisateur autorisé à consulter le rapport :

htpasswd /usr/local/awstats/.htpasswd user_site1

Suivre la même procédure pour les autres sites en modifiant les paramètres.

Pour générer les statistiques du site défini dans le fichier de configuration /etc/awstats/awstats.www.monsite1.com.conf lancer

perl /usr/local/awstats/wwwroot/cgi-bin/awstats.pl -config=www.monsite1.com -update

A planifier pour chaque site dans crontab à la fréquence que vous souhaitez.

Dans le navigateur les statistiques du site www.site2.com sont consultables à l'adresse :

http://stats.serveur.com/awstats/awstats.pl?config=www.monsite1.com