Configuration File

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)

Leave a Reply

You must be logged in to post a comment.