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
presented, 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 intelligently. In addition, the
Webalizer supports
xferlog formatted (
FTP) log files,
squid proxy logs and
W3C extended format 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
.bz2.
webazolver is normally just a symbolic link to the
Webalizer. When
run as
webazolver, only DNS file creation/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, it's configuration data is parsed. If the file is not present in
the current directory, 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 directory
(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
HistoryName 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.
- 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 directory, 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 representations 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 setup also necessitates that you always
process logs in chronological order, otherwise data loss will occur as a
result of the timestamp compare.
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 encountered 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, however may be set to anything between 1 and 100
days. Using the '
wcmgr' program, entries may also be marked as
'permanent', 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 database, 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 database,
greatly reducing the number of
Unknown/Unresolved entries in the
generated reports. The native
GeoDB geolocation database provided by
The
Webalizer fully supports both
IPv4 and
IPv6 lookups,
is updated regularly and is the preferred 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
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 informational
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
warnings 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 |
s quid | w3c )
- LogType. Specify log type to be processed. Value can
be either clf, ftp, squid or w3c format. If
not 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
displayed 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
displayed 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
considered 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.
- 4
- Browser name, major and minor version.
- 3
- Browser name, major version, minor version 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 grouping. 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 perform DNS lookups, either creating or updating the DNS cache file.
Specify zero ( 0) to disable cache file creation/updates. If given,
a DNS cache filename 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.
- -s name
- HideSite. Hide site matching name.
- -X
- HideAllSites. Hide all individual sites (only
display 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
´Keyword´ is one of the currently available configuration keywords
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 distribution 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
specified, the current directory will be used.
- HistoryName name
- Filename to use for history file. Relative to output
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
CAUTION. 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 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 directory being used. If specified,
the display of country 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 directories 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).
- 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 current 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.
- 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 mangle 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 modifications
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 insensitive).
- 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.current' in the standard output directory.
- DNSCache name
- Filename to use for the DNS cache. Relative to output
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.
- 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
disable.
- TopKSites num
- Display the top num Sites (by KByte) table. Use zero
to disable.
- AllSites ( yes | no )
- 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 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).
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
- 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 referrers
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 specified 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 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* commands specify which
files are to be written, and where.
- DumpPath name
- Save dump files in directory name. If not specified,
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 contains 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 contains 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 authentication 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.
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 produced.
(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-2011 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>