Configuration

L'interface d'administration vous permet de générer vos fichiers de configuration à partir de votre navigateur préfreré. Si vous ne désirez que changer certaines valeurs, la meilleure solution est d'utiliser la fonction 'clone' avec un des fichiers fournis. Les valeurs par défaut sont celles qui fonctionnent dans la plupart des cas.

	Serveurs

En premier lieu, choississez le nom de votre fichier de configuration. N'utilisez pas un fichier déjà existant ou une alerte vous signalera alors le danger d'écrasement du fichier de configuration fourni par défaut.

Sélectionnez le nom des extensions que W3Perl va produire. Les valeurs par défaut sont standards. Ensuite sélectionnez quelles extensions W3Perl va lire. Si vous n'avez aucun fichier shtml par exemple, inutile de prendre la ligne ou ce type d'extension apparait, cela ne fera que ralentir le programme.
Il est possible de spécifier un séparateur car pour les serveurs sous Zope, celui se trouve être le caractère '_' au lieu du traditionnel '.', donc si vous utilisez un serveur des plus classiques, ne changez rien.

	Fichier de Log

Tout ce qui concerne vos fichiers de log doit être défini ici. En premier lieu, il faut préciser quel type de ficher de log votre serveur utilise. Si vous l'ignorez, il suffit d'en examiner un échantillon et de le comparer avec ces lignes. Il vous est possible de spécifier votre propre format, une aide est fournie pour connaitre le type de champs autorisée.

Si plusieurs serveurs partagent le même fichier de log, chaque serveur ajoute un champs supplémentaire (virtual host) qui permet ensuite de les distinguer (format NECLF). Si vous utilisez un tel fichier, utilisez les valeurs proposées.
Il est possible également d'avoir ce champ supplémentaire (virtual host) au sein d'un format CLF (en fait, le champs est caché dans la requête, au lieu d'avoir une requête sur /index.html, vous aurez une requête sur http://<virtualserver>/index.html). Si cela est le cas, cochez alors la case 'Virtual servers in CLF or ECLF format'

Si votre provider fournit de nombreux fichiers, donnez le nom du fichier de base (partie constante à tous les fichiers). En général, les fichiers sont fournis pour chaque jour, donc le jour, le mois et l'année font partie du nom du fichier de log. %prefixlog est la partie commune à tous les fichiers.

Si vous désirez télécharger des fichiers de log distants, cochez 'Yes' et remplissez les champs suivants. L'outil utilisé pour récupérer les fichiers se nomme 'wget' (et il est fourni avec W3Perl pour Windows). Renseignez son emplacement sur votre machine.
Si vos fichiers distants (recommandés !) sont protégés, il vous faudra renseigné les champs user et password.
Dans tous les cas, il faut donner le nom du serveur, le port utilisé (port 80 pour un serveur Web classique) et le nom du répertoire distante où se trouve les fichiers.

Si vos fichiers de log sont également compressés, sélectionnez 'Yes' et entrez le chemin où votre outil de décompression se trouve (outil fourni dans la version Windows de W3Perl).

	Chemin

Sélectionnez le chemin de vos fichiers de sortie ainsi que l'emplacement où W3Perl a été installé.

Donnez le chemin où se trouve vos fichiers html de votre serveur et le répertoire cgi si présent.

Les informations sur vos fichiers de log doivent être renseignées ici. Ou sont-il sur votre disque (ou depuis où si vos fichiers sont sur un serveur distant). Le nom de vos fichiers de log (la partie constante du nom de fichier) ainsi que le nom des fichiers de log pour les references et les agent si vous utilisez des fichiers séparés.

L'emplacement ou Fly a été installé. La version pour Windows de W3Perl renseigne automatiquement ce champs car l'outil est fourni avec le logiciel.

	Filter

Entrez ici le nom de votre serveur Web. Le nom de domaine sera extrait de ce champ. Si vous avez des machines uniquement en adressage IP dans votre domaine, rajoutez les ici.

Choississez le type de filtres que vous voulez appliquer aux stats. Il est possible d'exclure des pays, répertoires, sites ou domaines (pour exclure le domaine iap.fr, il suffit de rentrer la valeur iap.fr)

D'autre part, il est possible d'obtenir des stats tres détaillées sur certaines pages et certains répertoires.

	Affichage

Si vous utilisez un moteur SPIP sur votre site, sélectionnez 'Yes'. Certaines stats spécifiques seront ici activées (comme le mappage d'URL à partir de la base de SPIP).

Choississez le niveau de précision souhaité. Le premier niveau est tres succint et le plus élevé procure enormement de détails (mais il est evidemment plus lent et nécessite plus de place). La valeur par défaut est 3.

Les seuils de visualisation peuvent être ajustés ici.

	Résolution DNS

La traduction des adresses URL permet de mieux visualiser le contenu des pages HTML. L'URL est alors remplacé par le titre de la page (se trouvant au niveau du tag title des fichiers).

La résolution DNS permet de résoudre les adresses IP en nom de site en interrogeant des serveurs DNS. Cela permet d'avoir des statistiques sur les pays mais c'est un processus tres lent. Si votre serveur effectue déjà cette résolution, inutile de l'activer ici.
Pour gagner en vitesse, il existe des modules Perl qui ont ces tables de correspondance dans un fichier. Cela n'est pas aussi précis que l'interrogation d'un serveur DNS mais c'est bien plus rapide.
Bien sur, il est possible de combiner les deux.

	Sortie

Choississez la langues de sortie.

Quatre types différents de graphes sont disponibles. Le meilleur(à mon avis) est celui de l'histogramme 3D. Les choix des couleurs sont desormais effectués dans la feuille de style CSS. Une image de fond peut être utilisés.

	Scripts

Si vous n'avez pas besoin de lancer tous les scripts, choississez ceux qui vous semblent le plus utiles.

Choississez quand vos stats seront lancées. La meilleure période est la nuit.

Certaines stats peuvent être desactivées pour gagner en vitesse de traitement.