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/macos car Perl est toujours
installé par défaut. Pour Windows, il faut installer
ActivePerl, le portage de Perl pour Windows.
W3Perl utilise une librairie javascript pour les sorties graphiques mais
on peut toujours utiliser l'ancien logiciel Fly pour générer ses graphes.
C'est un petit logiciel qui permet d'utiliser la librairie gd à
partir de Perl.
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.
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.
Des binaires sont également disponibles pour les serveurs sous Apache et Abyss.
W3Perl est diponible sous MacOS. Le fichier dpkg va installer les scripts
et lancer l'interface d'administration. Un fichier de configuration par
défaut pour MacOS est présent.
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...
Si vous utilisez SELinux (Security-Enhanced Linux), des réglages supplémentaires sont
requis pour faire tourner W3Perl. En fait, il s'agit de quelques commandes chcon and quelques
ajustements de sérité.
Si vous n'avez pas de fichiers de log ou ceux-ci ne sont pas accessibles, vous pouvez créer
les votres en utilisant un code javascript à inclure dans vos pages web. Le fichier
de log pourra être lu par W3Perl.
besoin de connaitre les stats sur vos liens externes ? Il suffit d'installer un script
php et celui-ci générera un fichier de log pour vous que vous pourrez ensuite
lire avec W3Perl.
Le script redirigera ensuite vos visiteurs sur la cible. C'est un bon moyen pour savoir
combien de personnes quittent votre site ou si les liens de vos sponsors sont utilisées.
Configuration files are the way to customize your stats. It includes
how the stats will be build, which stats you want to produce, the
display and many filtering options. A Web Administration interface
is available to help you managing those files. You can create one from
scratch, from a previous template or modify an existing one. Sadly,
people without cgi access won't be able to get this facility, then use
your favourite editor and select an existing one to build your own.
Some predefined configuration are availble for newbies. There are
ready to use with default values. Feel free to change them with the
administration interface.
To create a configuration file, you should first define some basic setup in order to W3Perl to
run : where your logfiles are, which kind of logfile you are using,
if your logfiles are split/compressed, your logfile filename ...
Then the filtering option to select on which directories you want to
get stats, which hosts you want to exclude, the threshold you want
on display ...
And finally, how the stats will be displayed using a background, in
which language ...
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.
|
