Installer et configurer AWStats sur Debian 4.0 Etch

AWStats (pour Advanced Web statistics) est un outil très performant d'analyse de fichiers logs. Il est capable de traiter les logs de vos serveurs HTTP, FTP, SMTP, etc. Je l'aime beaucoup car sa présentation est simple, et ses statistiques pertinentes. Ce guide vous aide à l'installer proprement sur Debian 4.0 Etch.
Installation

En premier lieu, nous installons le paquet d'Awstats:

/usr/bin/apt-get install awstats

Une fois ceci fait, nous mettons en place un script de mise à jour des statistiques conçu pour gérer plusieurs fichiers de configuration d'Awstats:

/bin/cp /usr/share/doc/awstats/examples/awstats-update /etc/cron.hourly/
/bin/chmod +x /etc/cron.hourly/awstats-update

Nous copions le fichier de configuration par défaut d'AwStats afin de conserver un template "sûr":

/bin/cp /etc/awstats/awstats.conf /etc/awstats/awstats.conf.template

Nous activons maintenant de manière globale les plugins intéressants de Awstats. En premier lieu, nous installons les dépendances nécessaires:

/usr/bin/apt-get install libgeo-ipfree-perl libnet-ip-perl libnet-dns-perl liburi-perl

Et nous mettons en place la configuration:

/bin/echo 'LoadPlugin="tooltips"
LoadPlugin="decodeutfkeys"
LoadPlugin="ipv6"
LoadPlugin="geoipfree"' \
| /usr/bin/tee -a /etc/awstats/awstats.conf.local

Enfin, afin que les images d'AWStats soient disponibles, nous configureons notre serveur Web pour les afficher:

/bin/sed -i -e '/<\/VirtualHost>/i\
Alias /awstats-icon /usr/share/awstats/icon\
<Directory "/usr/share/awstats/icon">\
AllowOverride None\
Order allow,deny\
Allow from all\
</Directory>\
' /etc/apache2/sites-available/default

Et nous rechargeons la configuration d'Apache:

/etc/init.d/apache2 reload

Configuration

En premier lieu, je vous conseille de configurer votre serveur HTTP de façon à ce que chaque site que vous hébergez ai ses propres fichiers logs.

Par exemple, pour Apache 2, ajoutez les lignes suivantes dans votre VirtualHost:

ErrorLog /var/log/apache2/howto.landure.fr-error.log
LogLevel warn
CustomLog /var/log/apache2/howto.landure.fr-access.log combined

Remarque: N'oublier pas de remplacer le nom d'hôte de mon site (en gras) par le nom d'hôte du votre.

Une fois ceci fait, nous allons créer notre fichier de configuration AwStats. En premier lieu, renseignez le nom d'hôte de votre site Internet:

SITE_HOSTNAME=howto.landure.fr

Et créez le fichier de configuration d'AwStats adéquat:

cp /etc/awstats/awstats.conf.template /etc/awstats/awstats.$SITE_HOSTNAME.conf

Et modifiez le pour utiliser vos fichiers logs:

/bin/sed -i -e "s/^\(LogFile=\).*/\1\"\/var\/log\/apache2\/$SITE_HOSTNAME-access.log\"/" \
-e "s/^\(SiteDomain=\).*/\1\"$SITE_HOSTNAME\"/" \
-e 's/^\(DefaultFile=\).*/\1"index.php index.html"/' \
-e 's/^\(URLWithQuery=\).*/URLWithQuery=1/' \
/etc/awstats/awstats.$SITE_HOSTNAME.conf

Si votre site récupère beaucoup de traffic depuis des forums, vous pouvez souhaitez voir les URL d'accès complètes. Pour ce faire, utilisez la ligne de commande suivante:

/bin/sed -i -e 's/^\(URLWithQuery=\).*/URLReferrerWithQuery=1/' \
/etc/awstats/awstats.$SITE_HOSTNAME.conf

Nous mettons une première fois à jour nos statistiques:

/etc/cron.hourly/awstats-update

Une fois ceci fait, vos statistiques devrait être accessibles depuis l'URL fournie par la commande:

echo "http://$HOSTNAME/cgi-bin/awstats.pl?config=$SITE_HOSTNAME"