Using the administration interface

 
The adminstration interface allow you to build configuration file from a browser. If you just want to change few settings, select the 'clone' option from a provided configuration file. Default values are working most of the time.

line
 
Platform specific

 
line
 
First, enter the configuration file name. Don't use a filename which is already exist or a warming will tell that you will overwrite default configuration file.

config_name

Select then the filename extensions W3Perl will produce. You don't need to change these values. Then select which extensions W3Perl will scan. If you don't have any shtml files on your server, don't select the string with shtml as it will slown down the scripts.
Extension separator have been added for zope server which use '_' instead od '.' so if you are using a classic server, don't change anything.

separator

line
 
Logfiles

 
line
 
Anything about your log files should be defined here. First select which logfile format your server produce. If you don't know, have a look where your logfiles are and compare few lines with those ones. You can specify your own format if none is valid. Check the 'Help' button to see what are the fields allowed.

logfiles

If many servers share the same logfile, each server add an extra field (virtual host) to allow log file to be split (NECLF format). If you have such logfile, just use the default selection.
You can also have the virtual host field in a CLF format (in fact, this field is hidden in the page request, instead of /index.html, you have http://<virtualserver>/index.html). If so, select 'Virtual servers in CLF or ECLF format'

logfile_format

If your provider split your logfiles, give the log filename structure. Usually logfiles are split daily so day of month, month and year are part of the log filename. %prefixlog is a prefix for all filename.

logfile_split

If you want to retrieve remote logfiles, select 'Yes' and fill the next fields. The tool to retrieve logfiles is 'wget' (and is provided with W3Perl for Windows). Tell W3Perl its location.
If your logfiles are in a proctected area, give user/passwd.
Fill the name of the server, the remote port (80 usually for web server) and the remote directory where the logfiles are.

remote_log

If your logfiles are also compressed, select 'Yes' and enter the path where your compression tool is located (provided with W3Perl for Windows).

compression

line
 
Path

 
line
 
Select where the output files will be produced and where the package have been installed.

line

Give the location of your web server html directory and the cgi directory if available.

web_path

Informations about your logfiles should be given here. Where are they located on your hard disk (or where they will be downloaded if you have selected a remote host). The logfile name (constant part of the filaname), the agent and referer logfiles if you have separate files.

logfile_path

The Fly tool path should be given. W3Perl for Windows provide by default the binary file so this field is already fill.

fly

line
 
Filter

 
line
 
Enter here your server name. Domain name is build from your server name. If you have some hosts which have only IP addresses, add them here.

server_name

Select the kind of filters you want to apply to your stats. You can exclude countries, directories, hosts or domain (excluding iap.fr will exclude all hosts from domain iap.fr).

filtering

In the other hand, you can choose to have very detailed stats about some pages or directories.

detailed

line
 
Display

 
line
 
If you are running a SPIP engine, select 'Yes'. Special stats will be enabled (like URL Mapping from the SPIP database for instance).

spip

Select the level of precision you want. The first level is a basic page and the highest one brings you a lot of details (but is slower to compute and take much more space disk). Default one is 3.

precision

Some display threshold can be adjust here.

threshold

line
 
Reverse DNS

 
line
 
URL mapping allow to view the name of your page (found in the title tag) instead of the URL.

url_mapping

Reverse DNS allow to map IP addresses to hostname by querying DNS server. It allow country stats to be build but it can be really slow.
If don't want to wait to much, you can use a Perl module which have the mapping in a file. This is not as accurate as the DNS query but it is really faster.
Of course, you can combine both to be even more precise.

ip_translation

line
 
Output

 
line
 
Choose a language for homepage display.

language

Four different types of graphs are available. Best one (from my point of view) is 3D bar chart. Color are now overridded by CSS stylesheet. Background image can be added for fun.

graph_display

line
 
Scripts

 
line
 
If you don't need to have all scripts running, choose the ones you want to run.

choose_scripts

Choose when the stats will be launched. Best is during the night.

when_stats

Some stats can be disabled to allow faster speed.

which_stats