Cette section a pour but de vous apprenndre à utiliser
W3Perl. En premier lieu, il faut vérifier que tout les
pré-requis
sont bien là. Un manuel d'installation est disponible pour
chaque plateforme. Il est possible d'installer le logiciel sans acces
telnet (par FTP) ou sans acces aux CGI. Une interface d'administration
par le Web permet de gérer ses statistiques bien que tous les
scripts
soient controlables par la ligne de commande. Pour une installation
facile, une version en RPM pour Linux et un .exe pour Windows est
disponible.
Les fichiers de configuration doivent être soigneusement
paramétrés pour bien correspondre à vos choix et
à votre serveur.
Il est possible de lancer W3Perl soit par l'interface web d'administration
ou soit par une crontab.
ne mélangez pas
les deux car des problèmes de privilège lié
à l'utilisateur web
ne permettrait pas de mettre à jour les fichiers de sortie.
W3Perl fournit les statistiques suivantes :
Pages,
Serveurs,
Pays,
Repertoires,
Téléchargements,
Heures,
Jours,
Semaines,
Mois,
Références,
Navigateurs,
Trafic,
Moteur de recherche,
Erreurs,
Scripts
... mais aussi
Temps réel,
Sessions,
Virus,
Traduction d'URL ...
Enfin, quelques informations sur l'évolution future des
prochaines versions est disponible.
Pour utiliser W3Perl, il n'est pas nécessaire d'installer
de nombreux logiciels tiers ou des modules Perl. Ce logiciel
fonctionne de manière autonome.
Comme W3Perl est écrit en Perl, il est indispensable d'avoir
ce langugage installé sur votre machine. Ce n'est pas un
problème pour les utilisateurs d'unix car Perl est toujours
installé par défaut. Pour Windows, il faut installer
ActivePerl, le portage de Perl pour Windows.
W3Perl utilise le logiciel Fly pour générer ses graphes.
C'est un petit logiciel qui permet d'utiliser la librairie gd à
partir de Perl. W3Perl est basé sur la version 1.6.5 qui
supporte le format Gif, support oté des dernières versions.
Si celui-ci n'est pas installé, W3Perl
fonctionnera mais sans aucun graphe en sortie.
Il est possible d'installer des modules Perl optionels. Le module DBI
permette de se connecter à une base de donné si vous utilisez un CMS
tel que SPIP. Le module GeoIP permet de localiser des adresses IP dans
un pays lorsque la résolution DNS ne marche pas.
Si vos fichiers de log sont compressés, W3Perl a besoin
d'un outil pour les décompresser à la volée.
Installer W3Perl est relativement facile. Il vous est possible de
choisir entre une version RPM ou la version tarball.
La version RPM est disponible pour les utilisateurs de Mandriva. Si
vous désirez générer votre propre RPM pour votre
distribution favorite, les sources SRPM sont
disponibles. N'hésitez à m'envoyer vos contributions
si vous voulez en faire profitez à d'autres.
Pour installer W3Perl à partir de la version Tarball, il faut
en premier lieu décompresser le fichier au niveau de la racine
de votre serveur web (ou votre repertoire personnel). Ensuite, il faut
editer le script nommé install.pl pour modifier le chemin de
Perl, celui de vos cgi (si présent) et celui du répertoire
d'installation de w3perl. Lancez le script. Vous pouvez desormais
utiliser l'interface web pour gérer vos fichiers de
configuration. Certains fichiers de configuration
prédéfinis sont disponibles, vous pouvez vous en servir
comme exemples.
Une fois que tout est terminé, vous pouvez soit lancer les
stats à partir de l'interface web ou à partir de la
ligne de commande avec le script cron-w3perl.pl. Pour mettre à
jour
automatiquement vos statistiques, il est conseillé de se servir
d'une crontab pour lancer de manière incrémentale ce script.
Plus de détails sont fournis dans la documentation.
L'installeur pour Windows a été grandement
simplifié.
Grace à l'outil NSIS, installer W3Perl consiste desormais
à lancer un exécutable.
L'installeur vérifie d'abord que le language Perl est bien
présent sur votre machine ainsi qu'un serveur IIS.
Ensuite, il installe les scripts en créant un répertoire
virtuel au sein de votre arborescence Web. Les droits du
répertoire sont ensuite modifiés pour permettre
l'exécution de scripts. En dernier lieu, l'installeur
associe au sein du serveur IIS, l'extension .pl avec les scripts Perl.
Une fois terminé, votre navigateur préféré
est ouvert avec la page d'administration de W3Perl. Un fichier de
configuration par défaut pour IIS est fourni qui vous permet
de lancer directement le calcul des statistiques.
Beaucoup de choses peuvent encore être améliorés
comme la possibilité de déetecter plusieurs serveurs IIS
ou Apache ainsi que la possibilité de choisir sur quels
serveurs W3Perl doit être installe. D'autres raffinements comme
la génération du fichier de configuration en fonction
des Metadata d'IIS ou du fichier de configuration d'Apache.
Je n'ai pas installé W3Perl sur un Macintosh depuis un bon
moment. Certaines personnes l'ont fait plus récemment donc
une petite aide est disponible. Si vous désirez ajouter des
commentaires pour mettre à jour la documentation,
n'hésitez pas !
Les fichiers de configuration sont le moyen de personnaliser vos
statistiques. Cela inclus la manière dont les résultats
seront générés, quels types de stats seront
produites, l'affichage et les filtres utilisés. Une interface
web d'administration est disponible pour vous aider à
gérer ses fichiers de configuration. Il est possible d'en
créer un nouveau, d'utiliser un template ou de modifier un
fichier déjà présent. Malheureusement, les
personnes sans acces aux cgi ne peuvent pas utilisé cet aide.
Il faut dans ce cas utiliser son éditeur
préféré et se servir d'un fichier d'exemple pour
fabriquer le sien.
Certains fichiers de configuration prédéfinis sont
fournis. Ils sont prêts à l'emploi, libre à vous
de les modifier pour votre propre utilisation.
Pour créer un fichier de configuration, il faut d'abord
définir quelques données essentielles (fichiers de log, type de
serveur, fichiers compressés ou pas, nom des fichiers...)
Ensuite viennent les filtres à appliquer (répertoire,
sites à exclure, les seuils d'affichage...
Et enfin, comment les stats seront affichées, dans quelles
langues...
Il est possible de choisir quel niveau de précision le logiciel va générer.
Si juste un rapide coup d'oeil vous suffit, le plus bas niveau vous contentera.
Un seul fichier HTML est produit qui résume l'activité
de votre serveur avec quelques grands chiffres comme le nombre de
hits, de pages vues, de machines...
Si vous désirez avoir des statistiques sur l'évolution
temporelle de la fréquentation de votre site Web, le niveau 2
est un minimum. Evidemment, la calcul est un peu plus long.
Pour en savoir encore plus, le niveau 3 contentera la majorité
d'entre vous. C'est la valeur par défaut qui permet de se faire
une bonne idée de la fréquentation de son site Web.
Enfin pour les plus exigeants, ... et si vous n'êtes pas trop
pressés, choississez le niveau 4 qui donne des statistiques
tres complètes mais assurez vous que votre disque dur n'est
pas trop plein auparavant.
Etant donné que les fichiers de log sont la matière
première de W3Perl, il faut choisir avec soin le type et le format
de fichier que l'on utilise sinon on risque fort de s'arrêter tres vite.
Malheureusement, il y a beaucoup de format parmi lesquels choisir !
Les fichiers de configuration fournis utilise les valeurs par
défaut. Avec IIS, il s'agit du format W3C (qui est en fait
un format tres minimaliste), avec Apache, il s'agit du CLF (Common Log
File) qui est un peu plus riche mais qui manque toute même des
informations tres utiles comme les références, les navigateurs.
Mon conseil serait de passer au format ECLF (Extended Common Log File)
qui permet d'extraire des informations tres interessantes sur les
visiteurs de votre site Web.
Si vous utilisez un format non standard, W3Perl est capable de le lire
car il est possible de définir son propre format en utilisant
une liste de mot-clé. Il n'y a donc pas de limite concernant le
format des fichiers de log que W3Perl peut utilisé.
Le format associé au serveur FTP et Squid ont été
ajouté récemment.
Votre serveur Web peut ne produire qu'un seul fichier de
log mais la plupart des serveurs désormais coupent leurs fichiers de
log régulièrement pour éviter que celui-ci ne devienne
trop gros. W3Perl est capable de gérer ces fichiers
découpés quotidiennement ou mensuellement (ils peuvent
être compréssés également).
Le nom des fichiers de log doivent obéir à certaines
régles assez simples. Ils doivent avoir un préffixe
(par exemple : access,ex,in ...) ainsi que des informations sur la
date. Si vous optez pour des fichiers de log quotidiens, la date doit
se retrouver dans le nom du fichier, celle-ci pouvant etre un
mélane de caractères et de nombres.
Concernant le format W3C, il s'agit d'une obligatoire car la date
n'est pas stockée dans le fichier de log.
Les dernières nouveautés concernant le logiciel sont
disponibles ici. Si vous désirez rester informer sur les
dernières versions de W3Perl, il est recommandé de s'abonner à la
mailing list de notification.
Une mise à jour est nécessaire ? Lisez avec attention
ces instructions. Il y a trois étapes pour cette
procédure.
La première est de sauvegarder vos fichiers de configuration en
cas où ... et tous les fichiers où vous avez pu
effectuer des modifications.
Ensuite, lancez le script d'upgrade, soit à partir de la ligne
de commande ou soit à partir de l'interface web. Cela va mettre
à jour vos fichiers de configurations si besoin est.
Enfin, lancez le script fixperlpath pour modifier le chemin lié
à Perl dans les nouveaux scripts installés.
Des problèmes avec W3Perl ? D'abord lisez la FAQ, beaucoup de
questions ont eu une réponse ici, aussi bien sur le
paramètrage, l'installation, les fichiers de log ou la version Windows.
Si vous ne trouvez pas votre bonheur dans la FAQ, alors
n'hésitez pas à poster un message dans le forum,
peut-être
que quelqu'un a déjà rencontré le même problème.
En dernier recours, il y a toujours la possibilité de me contacter.
Plusieurs trucs sont disponibles. Si vous en avez d'autres, je peux
les inclure dans la documentation. Le meilleur conseil est en premier
lieu de tester votre configuration sur une petite échelle (avec
de petits fichiers de log ou en utilisant l'option de sélection des
dates de départ/fin ou encore en utilisant le niveau de
précision le plus faible). Une fois que tout vous semble
correct, vous êtes prêt pour le calcul complet.
La critique essentiel à propos de W3Perl est sa relative lenteur
d'exécution. Le logiciel est écrit en Perl donc bien sur
pas moyen de rivaliser avec ceux écrit en C. Pour augmenter la
vitesse de traitement, on peut désactiver certains options (le
reverse DNS est tres lent par exemple ou le filtrage des robots).
Quelques tests ont été fait sur un 'vieux' ordinateur
et ils montrent que W3Perl peut traiter un nombre raisonnable de
fichiers de log en quelques heures.
Voici l'endroit où poser des questions, de suggérer de
nouvelles fonctionnalités et pour demander de l'aide.
Si aucun forum ne correspond à votre question, n'hésitez
pas a m'en suggérer d'autres. Je tacherai de répondre
à tous le plus rapidement possible.
Pour être informer des dernières versions de W3Perl, vous
pouvez vous abonner a la mailing list de notification. Ne soyez
effrayé car c'est une liste uniquement destinée aux
nouvelles annonces et par conséquent le nombre de messages
reçus ne dépasse pas quelques emails par an.
Si vous rencontrez un problème avec le logiciel,
n'hésitez pas à le mentionner en etant le plus
précis possible pour que je puisse reproduire le problème.
Voici les informations nécessaires :
- Version de W3Perl
- Nom du script fautif
- Comment W3Perl a été installé (FTP ou telnet)
- Votre OS
- L'étape a laquelle le problème a surgit (installation, configuration,
calcul, interface web ...)
- Quel type de fichiers de log utilisez vous (en morceaux, compressé, nom des fichiers)
- Le format de log que vous utilisez (CLF,IIS-W3C,IIS-Microsoft...)
- Si vous avez utilisé l'interface web pour générer vos fichiers de configuration
- L'URL où le problème peut être visualisé (si possible).
- Votre email bien sûr (ou je ne pourrai pas vous répondre !)
- Des commentaires qui puissent m'aider à trouver l'origine du problème
- Votre fichier de configuration et la sortie des scripts.
Voici quelques fonctionnalités que j'aimerais inclure dans les
prochaines releases. Bien sur, il ne s'agit pas d'une liste
compléte, vos idées sont toujours les bienvenues.
A propos de l'affichage, j'aimerais ajouter la possibilité
de générer des sorties en CSV, PDF, XML.
A propos de l'installation, fournir davantage de fichiers de
configuration peut être utile aux novices. Améliorer
l'installeur sous Windows pour pouvoir installer le logiciel sur
un serveur en particulier ou pouvoir utiliser W3Perl sans avoir un
serveur IIS/Apache en local.
A propos des fonctions, j'aimerais augmenté le support pour
les fichiers de log FTP/Squid et pourquoi par les fichiers de log Email.
Pourvoir filtrer plus efficacement les referer spam et
d'améliorer de manière générale le logiciel.
W3Perl posséde quelques limitations comme un minimum d'une
requête par semaine pour que les graphes ne soient pas
décalés ou un nombre maximum de fichiers de log qu'il
peut scanner.
|
