Qu'est ce que c'est ?
e Web Log Analyzer (eWLA) est un analyseur de logs pour sites web
qui génères les statistiques détaillées sur la fréquentation du site. Il
produit un rapport graphique au format HTML...
Dépendances:
- Perl 5.0 ou une version plus récente; vous pouvez le trouver sur
http://www.perl.com
- GD Lib (maximum version of 1.7x, not 1.8)
- Le Module Perl GD (maximum version of 1.19)
- Le Module Perl CDGraph (maximum version of 1.30)
- Le Module Perl CDGraph3d (maximum version of 0.40)
- Ces modules sont fournit dans l'archive, ou peuvent être trouvé sur
le server CPAN.
- Optinnel : un serveur web apache.
Télécharger la version courante :
La version en cours est la Version 0.1, crée le 05/15/00, dernière modification le 05/25/00.
Télécharger le code source / script et la documentation :
Archive Tar/Gzip : ewla.tar.gz (0 Ko)
Format Zip DOS : ewla.zip (0 Ko)
Que contient cette archive ?
Cette Archive contient différents fichiers:
- COPYING: La licence de ce programme (GPL).
- README: La doc en anglais...
- LISEZMOI: Ce fichier...
- ewla.pl: Le lanceur.
- ewla_logan.pl: Programme d'analyse des logs.
- ewla_graph.pl: Programme de génération des rapports.
- ewla.cfg: Fichier de config (Commentaires Anglais).
- ewla_fr.cfg: Fichier de config (Commentaires Français)
- ewla.lg: Fichier de langue anglais (défaut).
- ewla_fr.lg: Fichier de langue français.
- ewla_mk_help.pl Programme de générations des fenêtres d'aide.
- ewla_cal.cgi: Calendrier CGI.
- present/html Répertoire des images et des fichiers statiques.
- present/templates Répertoire des templates.
Principe de fonctionnement:
ewla.pl:
Ne fait presque rien, lance juste 'ewla_logan.pl' and 'ewla_graph.pl'.
ewla_logan.pl:
1) Parse le fichier de log pour chaque nouveau jours et stocke les
infos dans le répertoire des résumés (resume).
2) Lit les fichiers journaliers des mois modifiés et en calcule la somme
pour générer un fichier mensuel.
3) Lit les fichiers mensuels de l'année commencée et calcul la somme.
ewla_graph.pl:
Lit chaque nouveau (ou modifier) fichier résume et crée le rapport pour
ces nouveaux jours...
Si vous désirez utiliser cet analyser pour créer des rapport au jour le
jour il est préférable d'utiliser le calendrier CGI. Ce calendrier crée
automatiquement les liens vers les jours / mois déjà calculés présents
sur le serveur.
Installation et Configuration:
C'est un script Perl, l'installation est simple. Vous n'avez pas besoin de
compiler quelque chose...
Si vous n'aimez pas l'anglais (Optionnel) :)
renommez : 'ewla_fr.cfg' en 'ewla.cfg'
: 'ewla_fr.lg' en 'ewla.lg'
Editez le fichier de config (ewla.cfg) :
Lisez les commentaires et changez les valeurs par défaut si nécessaire...
Copiez les pages statiques et images :
copier 'present/html/*' dans votre répertoire résultat.
Lancer 'ewla_mk_help.pl' pour générer les pages d'aide.
Optionnel : changez le look des rapports, voir paragraphe 6.
Comment l'utiliser ?
ewla.pl [Options]
Options :
-c fichier, --conf-file fichier Nom fichier de config (défaut ewla.cfg).
-l fichier, --log-file fichier Nom fichier de log.
-rd rep, --res-dir rep Nom répertoire des résumés.
-od rep, --out-dir rep Nom répertoire résultat.
-v, --version Affiche la version et sort.
-h, --help Affiche l'aide.
Comment changer le look:
Vous pouvez personnalisez vos rapport, pour cela éditez les fichiers
templates présents dans le répertoire 'present/templates'.
Les donnée sont ajouter à la place des 'Value_*'.
Pouvant être utilisé dans tous les templates :
Value_site_name : remplacé par la valeur 'ServerName' du fichier de config.
Value_site_url : remplacé par la valeur 'ServerURL' du fichier de config.
Value_img_up_dir : remplacé par des ../ or ../../ ...
Value_gene_date : remplacé par la date de génération.
Value_scale_date : remplacé par le texte indiquant le période du rapport.
Value_scale_date_report_type : remplacé par le type du rapport.
Value_scale_date_report_time : remplacé par la date de la période du rapport.
Value_scale_date_yer : remplacé par l'année de la période du rapport.
Value_scale_date_mth : remplacé par le mois de la période du rapport.
Value_scale_date_day : remplacé par le jour de la période du rapport.
Value_calendar : remplacé par le calendrier
Value_menu : remplacé par le menu
Pouvant être utilisé le template stats : (stats.html) :
eWLA (e Web Log Analyzer)
Version 0.1 : remplacé par le titre de la section.
Value_txt_intro : remplacé par le texte d'introduction de la section.
eWLA (e Web Log Analyzer)
Version 0.1_head_help : remplacé par le titre de l'aide pour la section.
Value_txt_help : remplacé par le texte de l'aide pour la section.
Value_graph1 : remplacé par le premier graphique si présent.
Value_graph2 : remplacé par le premier second si présent
Value_tab : remplacé par le tableau résultat.
FTLS_COPYRIGHT : Mon Copyright (Ne pas supprimer...)
Editez le fichier de configuration pour changer les couleurs...
Que manque t-il ? / Bugs :
Pour les prochaines versions, j'ai l'intention d'ajouter / modifier certaines choses :
- Reconnaissance de plusieurs formats de logs ( fonction &load_log_line() )
- Reconnaissance de multiple virtual host.
- Ajouter / Modifier les fichiers de langue (fichier 'ewla_*.lg')
- Changer le look, Je ne suis pas graphiste :)
- Changer l'utilisation de la GD Lib, pour utiliser le PNG.
Bugs connus :
- Erreur aléatoire sur le records.
- Erreur sur la moyenne annuelle.
- Gif noir si pas de données.
Bien entendu, toute aide est la bien venue, si elle est dans les termes de
la GPL...
Historique:
Version 0.1 30/05/00 - 1er version public.
Version 0.1B 15/05/00 - 1er pre version.
Version 0.00 20/04/00 - Début de codage.
Remerciements:
Merci à 'Arthur Corliss' concepteur de Perl WebStat pour quelques idées :
- La plus importante, l'utilisation de la GD Lib pour les graphiques
Merci à la société Webfutur ( http://www.webfutur.com/ ) pour qui
j'ai réalisé ce programme pendant pendant mes soirs et week-end qui accepte
la diffusion du source en GPL sous mon copyright.
Copyright:
This software is copyright (C) 1999 Frédéric TYNDIUK. It is distributed
under the terms of the GNU General Public License (GPL). Because it is licensed
free of charge, there is NO WARRANTY, it is provided AS IS. The author can not
be held liable for any damage that might arise from the use of this software.
Use it at your own risk.
See the file COPYING for more details (or http://www.gnu.org/).
Attention: C'est pas parce que ce logiciel est libre que vous pouvez supprimer
le copyright...
Nouvelles versions:
Les nouvelles versions ainsi que d'autres scripts sont disponibles sur:
http://www.ftls.org/
Contact:
N'hésitez pas à m'envoyez un mail si vous avez des commentaires, des
suggestions, si vous trouvez des bugs, ou si vous avez des critiques, ou juste
pour me dire que vous aimez ce programme...
Si vous avez des problèmes de configuration, d'utilisation de ces
scripts, relisez ce document en premier, si vous ne trouvez pas la
solution, n'hésitez pas à me contacter...
E-Mail: tyndiuk@ftls.org
Web: http://www.ftls.org/
Frédéric TYNDIUK
