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

Pré-requis :

apt-get install mergelog libgeoip1

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.

Ajouter la section suivante dans votre configuration du serveur apache soit dans un Virtual Host ou dans la configuration principale :

      #
      # 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"
# Plugin: GeoIP
LoadPlugin="geoip GEOIP_STANDARD /usr/share/GeoIP/GeoIP.dat"

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