webalizer
(1)
Name
webalizer - A web server log file analysis tool.
Synopsis
webalizer [ option ... ] [ log-file ]
webazolver [ option ... ] [ log-file ]
Description
The Webalizer webalizer(1)
NAME
webalizer - A web server log file analysis tool.
SYNOPSIS
webalizer [ option ... ] [ log-file ]
webazolver [ option ... ] [ log-file ]
DESCRIPTION
The Webalizer is a web server log file analysis program
which produces usage statistics in HTML format for viewing
with a browser. The results are presented in both columnar
and graphical format, which facilitates interpretation.
Yearly, monthly, daily and hourly usage statistics are pre-
sented, along with the ability to display usage by site,
URL, referrer, user agent (browser), username, search
strings, entry/exit pages, and country (some information
may not be available if not present in the log file being
processed).
The Webalizer supports CLF (common log format) log files, as
well as Combined log formats as defined by NCSA and others,
and variations of these which it attempts to handle intelli-
gently. In addition, the Webalizer supports xferlog format-
ted (FTP) log files, squid proxy logs and W3C extended for-
mat logs. Logs may also be compressed, via gzip (.gz) or,
if enabled at compile time, bzip2 (.bz2). If a compressed
log file is detected, it will be automatically uncompressed
while it is read. Compressed logs must have the standard
gzip extension of .gz or bzip2 extension of
webazolver is normally just a symbolic link to the Webal-
izer. When run as webazolver, only DNS file cre-
ation/updates are performed, and the program will exit once
complete. All normal options and configuration directives
are available, however many will not be used. In addition,
a DNS cache file must be specified. If the number of DNS
children processes to use are not specified, the webazolver
will default to 5.
This documentation applies to The Webalizer Version 2.20
RUNNING THE WEBALIZER
The Webalizer was designed to be run from a Unix command
line prompt or as a crond(8) job. Once executed, the general
flow of the program is:
o A default configuration file is scanned for. A file
named webalizer.conf is searched for in the current
directory, and if found, and is owned by the invok-
ing user, then its configuration data is parsed. If
the file is not present in the current directory,
Version 2.20 Last change: 12-Jul-2008 1
The Webalizer webalizer(1)
the file /etc/webalizer.conf is searched for and, if
found, is used instead.
o Any command line arguments given to the program are
parsed. This may include the specification of a
configuration file, which is processed at the time
it is encountered.
o If a log file was specified, it is opened and made
ready for processing. If no log file was given,
STDIN is used for input. If the log filename '-' is
specified, STDIN will be forced.
o If an output directory was specified, the program
does a chdir(2) to that directory in preparation for
generating output. If no output directory was
given, the current directory is used.
o If a non-zero number of DNS Children processes were
specified, they will be started, and the specified
log file will be processed, creating or updating the
specified DNS cache file.
o If no hostname was given, the program attempts to
get the hostname using a uname(2) system call. If
that fails, localhost is used.
o A history file is searched for in the current direc-
tory (output directory) and read if found. This
file keeps totals for previous months, which is used
in the main index.html HTML document. Note: The
file location can now be specified with the History-
Name configuration option.
o If incremental processing was specified, a data file
is searched for and loaded if found, containing the
'internal state' data of the program at the end of a
previous run. Note: The file location can now be
specified with the IncrementalName configuration
option.
o Main processing begins on the log file. If the log
spans multiple months, a separate HTML document is
created for each month.
o After main processing, the main index.html page is
created, which has totals by month and links to each
months HTML document.
o A new history file is saved to disk, which includes
totals generated by The Webalizer during the current
run.
Version 2.20 Last change: 12-Jul-2008 2
The Webalizer webalizer(1)
o If incremental processing was specified, a data file
is written that contains the 'internal state' data
at the end of this run.
INCREMENTAL PROCESSING
The Webalizer supports incremental run capability. Simply
put, this allows processing large log files by breaking them
up into smaller pieces, and processing these pieces instead.
What this means in real terms is that you can now rotate
your log files as often as you want, and still be able to
produce monthly usage statistics without the loss of any
detail. Basically, The Webalizer saves and restores all
internal data in a file named webalizer.current. This
allows the program to 'start where it left off' so to speak,
and allows the preservation of detail from one run to the
next. The data file is placed in the current output direc-
tory, and is a plain ASCII text file that can be viewed with
any standard text editor. It's location and name may be
changed using the IncrementalName configuration keyword.
Some special precautions need to be taken when using the
incremental run capability of The Webalizer. Configuration
options should not be changed between runs, as that could
cause corruption of the internal data stored. For example,
changing the MangleAgents level will cause different repre-
sentations of user agents to be stored, producing invalid
results in the user agents section of the report. If you
need to change configuration options, do it at the end of
the month after normal processing of the previous month and
before processing the current month. You may also want to
delete the webalizer.current file as well.
The Webalizer also attempts to prevent data duplication by
keeping track of the timestamp of the last record processed.
This timestamp is then compared to current records being
processed, and any records that were logged previous to that
timestamp are ignored. This, in theory, should allow you to
re-process logs that have already been processed, or process
logs that contain a mix of processed/not yet processed
records, and not produce duplication of statistics. The
only time this may break is if you have duplicate timestamps
in two separate log files... any records in the second log
file that do have the same timestamp as the last record in
the previous log file processed, will be discarded as if
they had already been processed. There are lots of ways to
prevent this however, for example, stopping the web server
before rotating logs will prevent this situation. This set-
up also necessitates that you always process logs in chrono-
logical order, otherwise data loss will occur as a result of
the timestamp compare.
Version 2.20 Last change: 12-Jul-2008 3
The Webalizer webalizer(1)
REVERSE DNS LOOKUPS
The Webalizer fully supports IPv4 and IPv6 DNS lookups, and
maintains a cache of those lookups to reduce processing the
same addresses in subsequent runs. The cache file can be
created at run-time, or may be created before running the
webalizer using either the stand alone 'webazolver' program,
or The Webalizer (DNS) Cache file manager program 'wcmgr'.
In order to perform reverse lookups, a DNSCache file must be
specified, either on the command line or in a configuration
file. In order to create/update the cache file at run-time,
the number of DNSChildren must also be specified, and can be
anything between 1 and 100. This specifies the number of
child processes to be forked, each of which will perform
network DNS queries in order to lookup up the addresses and
update the cache. Cached entries that are older than a
specified TTL (time to live) will be expired, and if encoun-
tered again in a log, will be looked up at that time in
order to 'freshen' them (verify the name is still the same
and update its timestamp). The default TTL is 7 days, how-
ever may be set to anything between 1 and 100 days. Using
the 'wcmgr' program, entries may also be marked as 'perma-
nent', in which case they will persist (with an infinite
TTL) in the cache until manually removed. See the file
DNS.README for additional information and examples.
GEOLOCATION LOOKUPS
The Webalizer has the ability to perform geolocation lookups
on IP addresses using either it's own internal GeoDB data-
base, or optionally the GeoIP database from MaxMind, Inc.
(www.maxmind.com). If used, unresolved addresses will be
searched for in the database and its country of origin will
be returned if found. This actually produces more accurate
Country information than DNS lookups, since the DNS address
space has additional gcTLDs that do not necessarily map to a
specific country (such as .net and .com). It is possible to
use both DNS lookups and geolocation lookups at the same
time, which will cause any addresses that could not be
resolved using DNS lookups to then be looked up in the data-
base, greatly reducing the number of Unknown/Unresolved
entries in the generated reports. The native GeoDB geoloca-
tion database provided by The Webalizer fully supports both
IPv4 and IPv6 lookups, is updated regularly and is the pre-
ferred geolocation method for use with The Webalizer. The
most current version of the database can be obtained from
our ftp site (ftp://ftp.mrunix.net/).
COMMAND LINE OPTIONS
The Webalizer supports many different configuration options
that will alter the way the program behaves and generates
output. Most of these can be specified on the command line,
while some can only be specified in a configuration file.
The command line options are listed below, with references
Version 2.20 Last change: 12-Jul-2008 4
The Webalizer webalizer(1)
to the corresponding configuration file keywords.
General Options
-h Display all available command line options and exit
program.
-v Be verbose. Will cause the program to output infor-
mational and Debug messages at run-time.
-V Display the program version and exit. Additional
program specific information will be displayed if
verbose mode is also used (e.g. '-vV'), which can be
useful when submitting bug reports.
-d Debug. Display debugging information for errors and
warnings.
-i IgnoreHist. Ignore history. USE WITH CAUTION. This
will cause The Webalizer to ignore any previous
monthly history file only. Incremental data (if
present) is still processed.
-b IgnoreState. Ignore incremental data file. USE
WITH CAUTION. This will cause The Webalizer to
ignore any existing incremental data file. By
ignoring the incremental data file, all previous
processing for the current month will be lost and
those logs must be re-processed.
-p Incremental. Preserve internal data between runs.
-q Quiet. Suppress informational messages. Does not
suppress warnings or errors.
-Q ReallyQuiet. Suppress all messages including warn-
ings and errors.
-T TimeMe. Force display of timing information at end
of processing.
-c file Use configuration file file.
-n name HostName. Use the hostname name.
-o dir OutputDir. Use output directory dir.
-t name ReportTitle. Use name for report title.
-F ( clf | ftp |
LogType. Specify log type to be processed. Value
can be either clf, ftp, squid or w3c format. If not
Version 2.20 Last change: 12-Jul-2008 5
The Webalizer webalizer(1)
specified, will default to CLF format. FTP logs
must be in standard wu-ftpd xferlog format.
-f FoldSeqErr. Fold out of sequence log records back
into analysis, by treating as if they were the same
date/time as the last good record. Normally, out of
sequence log records are simply ignored.
-Y CountryGraph. Suppress country graph.
-G HourlyGraph. Suppress hourly graph.
-x name HTMLExtension. Defines HTML file extension to use.
If not specified, defaults to html. Do not include
the leading period.
-H HourlyStats. Suppress hourly statistics.
-K num IndexMonths. Specify how many months should be dis-
played in the main index (yearly summary) table.
Default is 12 months. Can be set to anything
between 12 and 120 months (1 to 10 years).
-k num GraphMonths. Specify how many months should be dis-
played in the main index (yearly summary) graph.
Default is 12 months. Can be set to anything
between 12 and 72 months (1 to 6 years).
-L GraphLegend. Suppress color coded graph legends.
-l num GraphLines. Specify number of background lines.
Default is 2. Use zero ('0') to disable the lines.
-P name PageType. Specify file extensions that are consid-
ered pages. Sometimes referred to as pageviews.
-O name OmitPage. Specify URLs to exclude from being
counted as pages.
-m num VisitTimeout. Specify the Visit timeout period.
Specified in number of seconds. Default is 1800
seconds (30 minutes).
-I name IndexAlias. Use the filename name as an additional
alias for index..
-M num MangleAgents. Mangle user agent names according to
the mangle level specified by num. Mangle levels
are:
5 Browser name and major version.
Version 2.20 Last change: 12-Jul-2008 6
The Webalizer webalizer(1)
4 Browser name, major and minor version.
3 Browser name, major version, minor ver-
sion to two decimal places.
2 Browser name, major and minor versions
and sub-version.
1 Browser name, version and machine type
if possible.
0 All information (left unchanged).
-g num GroupDomains. Automatically group sites by domain.
The grouping level specified by num can be thought
of as 'the number of dots' to display in the group-
ing. The default value of 0 disables any domain
grouping.
-D name DNSCache. Use the DNS cache file name.
-N num DNSChildren. Use num DNS children processes to per-
form DNS lookups, either creating or updating the
DNS cache file. Specify zero (0) to disable cache
file creation/updates. If given, a DNS cache file-
name must be specified.
-j Enable GeoDB. This enables the internal GeoDB
geolocation services provided by The Webalizer.
-J name GeoDBDatabase. Use the alternate GeoDB database
name.
-w Enable GeoIP. Enables GeoIP (by MaxMind Inc.)
geolocation services. If native GeoDB services are
also enabled, then this option will have no effect.
-W name GeoIPDatabase. Use the alternate GeoIP database
name.
-z name FlagDir. Specify location of the country flag
graphics and enable their display in the top country
table. The directory name is relative to the output
directory being used unless an absolute path is
given (ie: starts with a leading '/').
Hide Options
-a name HideAgent. Hide user agents matching name.
-r name HideReferrer. Hide referrer matching name.
Version 2.20 Last change: 12-Jul-2008 7
The Webalizer webalizer(1)
-s name HideSite. Hide site matching name.
-X HideAllSites. Hide all individual sites (only dis-
play groups).
-u name HideURL. Hide URL matching name.
Table size options
-A num TopAgents. Display the top num user agents table.
-R num TopReferrers. Display the top num referrers table.
-S num TopSites. Display the top num sites table.
-U num TopURLs. Display the top num URLs table.
-C num TopCountries. Display the top num countries table.
-e num TopEntry. Display the top num entry pages table.
-E num TopExit. Display the top num exit pages table.
CONFIGURATION FILES
Configuration files are standard ASCII(7) text files that
may be created or edited using any standard editor. Blank
lines and lines that begin with a pound sign ('#') are
ignored. Any other lines are considered to be configuration
lines, and have the form "Keyword Value", where the 'Key-
word' is one of the currently available configuration key-
words defined below, and 'Value' is the value to assign to
that particular option. Any text found after the keyword up
to the end of the line is considered the keyword's value, so
you should not include anything after the actual value on
the line that is not actually part of the value being
assigned. The file sample.conf provided with the distribu-
tion contains lots of useful documentation and examples as
well.
General Configuration Keywords
LogFile name
Use log file named name. If none specified, STDIN
will be used.
LogType name
Specify log file type as name. Values can be either
clf, squid, ftp or w3c, with the default being clf.
OutputDir dir
Create output in the directory dir. If none speci-
fied, the current directory will be used.
Version 2.20 Last change: 12-Jul-2008 8
The Webalizer webalizer(1)
HistoryName name
Filename to use for history file. Relative to out-
put directory unless absolute name is given (ie:
starts with '/'). Defaults to 'webalizer.hist' in
the standard output directory.
ReportTitle name
Use the title string name for the report title. If
none specified, use the default of (in english)
"Usage Statistics for ".
HostName name
Set the hostname for the report as name. If none
specified, an attempt will be made to gather the
hostname via a uname(2) system call. If that fails,
localhost will be used.
UseHTTPS ( yes | no )
Use https:// on links to URLS, instead of the
default http://, in the 'Top URLs' table.
HTAccess ( yes | no )
Enables the creation of a default .htaccess file in
the output directory.
Quiet ( yes | no )
Suppress informational messages. Warning and Error
messages will not be suppressed.
ReallyQuiet ( yes | no )
Suppress all messages, including Warning and Error
messages.
Debug ( yes | no )
Print extra debugging information on Warnings and
Errors.
TimeMe ( yes | no )
Force timing information at end of processing.
GMTTime ( yes | no )
Use GMT (UTC) time instead of local timezone for
reports.
IgnoreHist ( yes | no )
Ignore previous monthly history file. USE WITH CAU-
TION. Does not prevent Incremental file processing.
IgnoreState ( yes | no )
Ignore incremental data file. USE WITH CAUTION. By
ignoring the incremental data file, all previous
processing for the current month will be lost and
Version 2.20 Last change: 12-Jul-2008 9
The Webalizer webalizer(1)
those logs must be re-processed.
FoldSeqErr ( yes | no )
Fold out of sequence log records back into analysis
by treating them as if they had the same date/time
as the last good record. Normally, out of sequence
log records are ignored.
CountryGraph ( yes | no )
Display Country Usage Graph in output report.
CountryFlags ( yes | no )
Enable or disable the display of flags in the top
country table.
FlagDir name
Specifies the directory name where the flag graphics
are located. If not specified, the default is in
the flags directory directly under the output direc-
tory being used. If specified, the display of coun-
try flags will be enabled by default. Using
'FlagDir flags' is identical to using 'CountryFlags
yes'.
DailyGraph ( yes | no )
Display Daily Graph in output report.
DailyStats ( yes | no )
Display Daily Statistics in output report.
HourlyGraph ( yes | no )
Display Hourly Graph in output report.
HourlyStats ( yes | no )
Display Hourly Statistics in output report.
PageType name
Define the file extensions to consider as a page.
If a file is found to have the same extension as
name, it will be counted as a page (sometimes called
a pageview).
PagePrefix name
Allows URLs with the prefix name to be counted as a
page type regardless of actual file type. This
allows you to treat contents under specified direc-
tories as pages no matter what their extension is.
OmitPage name
Specifies URLs which should not be counted as pages,
regardless of their extension (or lack thereof).
Version 2.20 Last change: 12-Jul-2008 10
The Webalizer webalizer(1)
GraphLegend ( yes | no )
Allows the color coded graph legends to be
enabled/disabled.
GraphLines num
Specify the number of background reference lines
displayed on the graphs produced. Disable by using
zero ('0'), default is 2.
IndexMonths num
Specify the number of months to display in the main
index (yearly summary) table. Default is 12 months.
Can be set to anything between 12 and 120 months (1
to 10 years).
YearHeaders ( yes | no )
Enable/disable the display of year headers in the
main index (yearly summary) table. If enabled, year
headers will be shown when the table is displaying
more than 16 months worth of data. Values can be
'yes' or 'no'. Default is 'yes'.
YearTotals ( yes | no )
Enable/disable the display of year totals in the
main index (yearly summary) table. If enabled, year
totals will be shown when the table is displaying
more than 16 months worth of data. Values can be
'yes' or 'no'. Default is 'yes'.
GraphMonths num
Specify the number of months to display in the main
index (yearly summary) graph. Default is 12 months.
Can be set to anything between 12 and 72 months (1
to 6 years).
VisitTimeout num
Specifies the visit timeout value. Default is 1800
seconds (30 minutes). A visit is determined by
looking at the difference in time between the cur-
rent and last request from a specific site. If the
difference is greater or equal to the timeout value,
the request is counted as a new visit. Specified in
seconds.
IndexAlias name
Use name as an additional alias for index.*.
DefaultIndex ( yes | no )
Enables or disables the use of 'index.' as a default
index name to be stripped from the end of URLs.
This does not effect any index names that may be
defined with the IndexAlias option.
Version 2.20 Last change: 12-Jul-2008 11
The Webalizer webalizer(1)
MangleAgents num
Mangle user agent names based on mangle level num.
See the -M command line switch for mangle levels and
their meaning. The default is 0, which doesn't man-
gle user agents at all.
StripCGI ( yes | no )
Determines if URL CGI variables should be stripped
from the end of URLs. Values may be 'yes' or 'no',
with the default being 'yes'.
TrimSquidURL num
Allows squid log URLs to be reduced in granularity
by truncating them after num slashes ('/') after the
http:// prefix. A setting of one (1) will cause all
URLs to be summarized by domain only. The default
value is zero (0), which will disable any URL modi-
fications and leave them exactly as found in the log
file.
SearchEngine name variable
Allows the specification of search engines and their
query strings. The name is the name to match
against the referrer string for a given search
engine. The variable is the cgi variable that the
search engine uses for queries. See the sample.conf
file for example usage with common search engines.
SearchCaseI ( yes | no )
Determines if search strings should be treated case
insensitive or not. The default is 'yes', which
lowercases all search strings (treat as case insen-
sitive).
Incremental ( yes | no )
Enable Incremental mode processing.
IncrementalName name
Filename to use for incremental data. Relative to
output directory unless an absolute name is given
(ie: starts with '/'). Defaults to 'webalizer.cur-
rent' in the standard output directory.
DNSCache name
Filename to use for the DNS cache. Relative to out-
put directory unless an absolute name is given (ie:
starts with '/').
DNSChildren num
Number of children DNS processes to run in order to
create/update the DNS cache file. Specify zero (0)
to disable.
Version 2.20 Last change: 12-Jul-2008 12
The Webalizer webalizer(1)
CacheIPs ( yes | no )
Cache unresolved IP addresses in the DNS database.
Default is 'no'.
CacheTTL num
DNS cache entry time to live (TTL) in days. Default
is 7 days. May be any value between 1 and 100.
GeoDB ( yes | no )
Allows native GeoDB geolocation services to be
enabled or disabled. Default value is 'no'.
GeoDBDatabase name
Allows the use of an alternate GeoDB database name.
If not specified, the default database will be used.
GeoIP ( yes | no )
Allows GeoIP (by MaxMind Inc.) geolocation services
to be enabled or disabled. Default is 'no'. If
native GeoDB geolocation services are also enabled,
then this option will have no effect (and the native
GeoDB services will be used).
GeoIPDatabase name
Allows the use of an alternate GeoIP database name.
If not specified, the default database will be used.
Top Table Keywords
TopAgents num
Display the top num User Agents table. Use zero to
disable.
AllAgents ( yes | no )
Create separate HTML page with All User Agents.
TopReferrers num
Display the top num Referrers table. Use zero to
disable.
AllReferrers ( yes | no )
Create separate HTML page with All Referrers.
TopSites num
Display the top num Sites table. Use zero to dis-
able.
TopKSites num
Display the top num Sites (by KByte) table. Use
zero to disable.
AllSites ( yes | no )
Version 2.20 Last change: 12-Jul-2008 13
The Webalizer webalizer(1)
Create separate HTML page with All Sites.
TopURLs num
Display the top num URLs table. Use zero to disable.
TopKURLs num
Display the top num URLs (by KByte) table. Use zero
to disable.
AllURLs ( yes | no )
Create separate HTML page with All URLs.
TopCountries num
Display the top num Countries in the table. Use zero
to disable.
TopEntry num
Display the top num Entry Pages in the table. Use
zero to disable.
TopExit num
Display the top num Exit Pages in the table. Use
zero to disable.
TopSearch num
Display the top num Search Strings in the table.
Use zero to disable.
AllSearchStr ( yes | no )
Create separate HTML page with All Search Strings.
TopUsers num
Display the top num Usernames in the table. Use
zero to disable. Usernames are only available if
using http based authentication.
AllUsers ( yes | no )
Create separate HTML page with All Usernames.
Hide/Ignore/Group/Include Keywords
HideAgent name
Hide User Agents that match name.
HideReferrer name
Hide Referrers that match name.
HideSite name
Hide Sites that match name.
HideAllSites ( yes | no )
Hide all individual sites. This causes only grouped
Version 2.20 Last change: 12-Jul-2008 14
The Webalizer webalizer(1)
sites to be displayed.
HideURL name
Hide URLs that match name.
HideUser name
Hide Usernames that match name.
IgnoreAgent name
Ignore User Agents that match name.
IgnoreReferrer name
Ignore Referrers that match name.
IgnoreSite name
Ignore Sites that match name.
IgnoreURL name
Ignore URLs that match name.
IgnoreUser name
Ignore Usernames that match name.
GroupAgent name [Label]
Group User Agents that match name. Display Label in
'Top Agent' table if given (instead of name). name
may be enclosed in quotes.
GroupReferrer name [Label]
Group Referrers that match name. Display Label in
'Top Referrer' table if given (instead of name).
name may be enclosed in quotes.
GroupSite name [Label]
Group Sites that match name. Display Label in 'Top
Site' table if given (instead of name). name may be
enclosed in quotes.
GroupDomains num
Automatically group sites by domain. The value num
specifies the level of grouping, and can be thought
of as the 'number of dots' to be displayed. The
default value of 0 disables domain grouping.
GroupURL name [Label]
Group URLs that match name. Display Label in 'Top
URL' table if given (instead of name). name may be
enclosed in quotes.
GroupUser name [Label]
Group Usernames that match name. Display Label in
'Top Usernames' table if given (instead of name).
Version 2.20 Last change: 12-Jul-2008 15
The Webalizer webalizer(1)
name may be enclosed in quotes.
IncludeSite name
Force inclusion of sites that match name. Takes
precedence over Ignore* keywords.
IncludeURL name
Force inclusion of URLs that match name. Takes
precedence over Ignore* keywords.
IncludeReferrer name
Force inclusion of Referrers that match name. Takes
precedence over Ignore* keywords.
IncludeAgent name
Force inclusion of User Agents that match name.
Takes precedence over Ignore* keywords.
IncludeUser name
Force inclusion of Usernames that match name. Takes
precedence over Ignore* keywords.
HTML Generation Keywords
HTMLExtension text
Defines the HTML file extension to use. Default is
html. Do not include the leading period!
HTMLPre text
Insert text at the very beginning of the generated
HTML file. Defaults to a standard html 3.2 DOCTYPE
record.
HTMLHead text
Insert text within the <HEAD></HEAD> block of the
HTML file.
HTMLBody text
Insert text in HTML page, starting with the <BODY>
tag. If used, the first line must be a <BODY ...>
tag. Multiple lines may be specified.
HTMLPost text
Insert text at top (before horiz. rule) of HTML
pages. Multiple lines may be specified.
HTMLTail text
Insert text at bottom of the HTML page. The text is
top and right aligned within a table column at the
end of the report.
HTMLEnd text
Version 2.20 Last change: 12-Jul-2008 16
The Webalizer webalizer(1)
Insert text at the very end of the HTML page. If
not specified, the default is to insert the ending
</BODY> and </HTML> tags. If used, you must supply
these tags yourself.
LinkReferrer ( yes | no )
Determines if the referrers listed in the top refer-
rers table should be displayed as plain text, or as
a link to the referrer URL.
ColorHit ( rrggbb | 00805c )
Sets the graph's hit-color to the specified html
color (no '#').
ColorFile ( rrggbb | 0040ff )
Sets the graph's file-color to the specified html
color (no '#').
ColorSite ( rrggbb | ff8000 )
Sets the graph's site-color to the specified html
color (no '#').
ColorKbyte ( rrggbb | ff0000 )
Sets the graph's kilobyte-color to the specified
html color (no '#').
ColorPage ( rrggbb | 00e0ff )
Sets the graph's page-color to the specified html
color (no '#').
ColorVisit ( rrggbb | ffff00 )
Sets the graph's visit-color to the specified html
color (no '#').
ColorMisc ( rrggbb | 00e0ff )
Sets the 'miscellaneous' color for table headers
(not graphs) to the specified html color (no '#').
PieColor1 ( rrggbb | 800080 )
Sets the pie's first optional color to the specified
html color (no '#').
PieColor2 ( rrggbb | 80ffc0 )
Sets the pie's second optional color to the speci-
fied html color (no '#').
PieColor3 ( rrggbb | ff00ff )
Sets the pie's third optional color to the specified
html color (no '#').
PieColor4 ( rrggbb | ffc480 )
Sets the pie's fourth optional color to the
Version 2.20 Last change: 12-Jul-2008 17
The Webalizer webalizer(1)
specified html color (no '#').
Dump Object Keywords
The Webalizer allows you to export processed data to other
programs by using tab delimited text files. The Dump* com-
mands specify which files are to be written, and where.
DumpPath name
Save dump files in directory name. If not speci-
fied, the default output directory will be used. Do
not specify a trailing slash ('/').
DumpExtension name
Use name as the filename extension for dump files.
If not given, the default of tab will be used.
DumpHeader ( yes | no )
Print a column header as the first record of the
file.
DumpSites ( yes | no )
Dump the sites data to a tab delimited file.
DumpURLs ( yes | no )
Dump the url data to a tab delimited file.
DumpReferrers ( yes | no )
Dump the referrer data to a tab delimited file.
This data is only available if using a log that con-
tains referrer information (ie: a combined format
web log).
DumpAgents ( yes | no )
Dump the user agent data to a tab delimited file.
This data is only available if using a log that con-
tains user agent information (ie: a combined format
web log).
DumpUsers ( yes | no )
Dump the username data to a tab delimited file.
This data is only available if processing a wu-ftpd
xferlog or a web log that contains http authentica-
tion information.
DumpSearchStr ( yes | no )
Dump the search string data to a tab delimited file.
This data is only available if processing a web log
that contains referrer information and had search
string information present.
Version 2.20 Last change: 12-Jul-2008 18
The Webalizer webalizer(1)
FILES
webalizer.conf Default configuration file. Is searched
for in the current directory and if not
found, in the /etc/ directory.
webalizer.hist Monthly history file for previous
months. (can be changed)
webalizer.current Current state data file (Incremental
processing). (can be changed)
xxxxx_YYYYMM.html Various monthly HTML output files pro-
duced. (extension can be changed)
xxxxx_YYYYMM.png Various monthly image files used in the
reports.
xxxxx_YYYYMM.tab Monthly tab delimited text files.
(extension can be changed)
BUGS
Please report bugs to the author.
COPYRIGHT
Copyright (C) 1997-2009 by Bradford L. Barrett. Distributed
under the GNU GPL. See the files "COPYING" and "Copyright",
supplied with all distributions for additional information.
AUTHOR
Bradford L. Barrett <brad at mrunix dot net>
ATTRIBUTES
See attributes(5) for descriptions of the following
attributes:
+---------------+-------------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-------------------------+
|Availability | web/analytics/webalizer |
+---------------+-------------------------+
|Stability | Uncommitted |
+---------------+-------------------------+
NOTES
This software was built from source available at
https://java.net/projects/solaris-userland. The original
community source was downloaded from
ftp://ftp.mrunix.net/pub/webalizer/webal-
izer-2.21-02-src.tar.bz2
Further information about this software can be found on the
Version 2.20 Last change: 12-Jul-2008 19
The Webalizer webalizer(1)
open source community website at
http://www.mrunix.net/webalizer/.
Version 2.20 Last change: 12-Jul-2008 20