pwebstats

The configuration file (./conf/pwebstats.conf) controls the setup information needed for pwebstats to run, and the user-settable limits and variables.

Lines starting with a # are comments and are ignored, as are blank lines.

All other lines are of the form variable:setting (the colon is necessary).

Use full pathnames where pathnames are to be specified (no trailing ‘/’).

Config Variables

server

Unique nickname for server – use only a-z, A-Z and ‘_’.

Server_header

Header for index page.

logfile

Location of log file (full pathname).

logtype

Type of logfile.
Acceptable values are: common (Common Log Format), squid, squid-emulated, ncsa-extended, and netscape-proxy. Defaults to common.

outdir

Directory location for the output of pwebstats (full pathname).

templates

directory containing GIF templates (full pathname).

interval

Stats collection interval – can be daily, weekly, monthly, quarterly.

verbose

Verbose output – progress bar and other details when pwebstats is running (any value = on).

fly_prog

Location of ‘fly’ program (full pathname).

page_config

Location of page-based stats config file (full pathname).

host_threshold

Threshold for inclusion in all hosts list (default = 25).

item_threshold

Threshold for inclusion in all requests list (default = 25).

domain_threshold

Threshold for inclusion in all domains list (default = 5).

protocol_threshold

Threshold for inclusion in all protocols list (default = 25).

local_patt

Regular expression for local domain
e.g.: local_patt:\.unimelb\.edu\.au$|^128\.250|\.mu\.oz\.au$

exclude

regexp of items to exclude from display in request stats (but are still counted in totals)

complete_exclude_host

completely ignore access from this set of hostnames ( | is the delimeter)
e.g. complete_exclude_host:foo1.users.bar.com|foo2.users.bar.com|foo3.users.bar.com

complete_exclude_url_patt

completely ignore access to this pattern of URLs
e.g. complete_exclude_url_patt:^/foo/bar/*$|^/robots.txt$

complete_exclude_user

completely ignore access from this set of users ( | is the delimeter)
e.g. complete_exclude_user:tom|dick|harry

dns_lookup

Convert IP numbers in the hostname field to fully-qualified domain names (any value = on).

An example config file.

Additionally, in a configuration file for a proxy server, the following directives are applicable:

remote_host_threshold

Threshold for inclusion in all remote hosts list (default = 25)

exclude_reqs

Exclude requests/accesses array – saves time and a lot of memory! (any value = on)