## Sample Webalizer configuration file# Copyright 1997-2000 by Bradford L. Barrett (brad@mrunix.net)## Distributed under the GNU General Public License.  See the# files "Copyright" and "COPYING" provided with the webalizer# distribution for additional information.## This is a sample configuration file for the Webalizer (ver 2.01)# Lines starting with pound signs '#' are comment lines and are# ignored.  Blank lines are skipped as well.  Other lines are considered# as configuration lines, and have the form "ConfigOption  Value" where# ConfigOption is a valid configuration keyword, and Value is the value# to assign that configuration option.  Invalid keyword/values are# ignored, with appropriate warnings being displayed.  There must be# at least one space or tab between the keyword and its value.## As of version 0.98, The Webalizer will look for a 'default' configuration# file named "webalizer.conf" in the current directory, and if not found# there, will look for "/etc/webalizer.conf".# LogFile defines the web server log file to use.  If not specified# here or on on the command line, input will default to STDIN.  If# the log filename ends in '.gz' (ie: a gzip compressed file), it will# be decompressed on the fly as it is being read.#LogFile        /var/lib/httpd/logs/access_log# LogType defines the log type being processed.  Normally, the Webalizer# expects a CLF or Combined web server log as input.  Using this option,# you can process ftp logs as well (xferlog as produced by wu-ftp and# others), or Squid native logs.  Values can be 'clf', 'ftp' or 'squid',# with 'clf' the default.#LogType	clf# OutputDir is where you want to put the output files.  This should# should be a full path name, however relative ones might work as well.# If no output directory is specified, the current directory will be used.#OutputDir      /var/lib/httpd/htdocs/usage# HistoryName allows you to specify the name of the history file produced# by the Webalizer.  The history file keeps the data for up to 12 months# worth of logs, used for generating the main HTML page (index.html).# The default is a file named "webalizer.hist", stored in the specified# output directory.  If you specify just the filename (without a path),# it will be kept in the specified output directory.  Otherwise, the path# is relative to the output directory, unless absolute (leading /).HistoryName	webalizer.hist# Incremental processing allows multiple partial log files to be used# instead of one huge one.  Useful for large sites that have to rotate# their log files more than once a month.  The Webalizer will save its# internal state before exiting, and restore it the next time run, in# order to continue processing where it left off.  This mode also causes# The Webalizer to scan for and ignore duplicate records (records already# processed by a previous run).  See the README file for additional# information.  The value may be 'yes' or 'no', with a default of 'no'.# The file 'webalizer.current' is used to store the current state data,# and is located in the output directory of the program (unless changed# with the IncrementalName option below).  Please read at least the section# on Incremental processing in the README file before you enable this option.Incremental	yes# IncrementalName allows you to specify the filename for saving the# incremental data in.  It is similar to the HistoryName option where the# name is relative to the specified output directory, unless an absolute# filename is specified.  The default is a file named "webalizer.current"# kept in the normal output directory.  If you don't specify "Incremental"# as 'yes' then this option has no meaning.IncrementalName	webalizer.current# ReportTitle is the text to display as the title.  The hostname# (unless blank) is appended to the end of this string (separated with# a space) to generate the final full title string.# Default is (for english) "Usage Statistics for".#ReportTitle    Usage Statistics for# HostName defines the hostname for the report.  This is used in# the title, and is prepended to the URL table items.  This allows# clicking on URL's in the report to go to the proper location in# the event you are running the report on a 'virtual' web server,# or for a server different than the one the report resides on.# If not specified here, or on the command line, webalizer will# try to get the hostname via a uname system call.  If that fails,# it will default to "localhost".#HostName       localhost# HTMLExtension allows you to specify the filename extension to use# for generated HTML pages.  Normally, this defaults to "html", but# can be changed for sites who need it (like for PHP embeded pages).#HTMLExtension  html# PageType lets you tell the Webalizer what types of URL's you# consider a 'page'.  Most people consider html and cgi documents# as pages, while not images and audio files.  If no types are# specified, defaults will be used ('htm*', 'cgi' and HTMLExtension# if different for web logs, 'txt' for ftp logs).PageType	*#PageType	htm*#PageType	cgi#PageType	phtml#PageType	php3#PageType	pl# UseHTTPS should be used if the analysis is being run on a# secure server, and links to urls should use 'https://' instead# of the default 'http://'.  If you need this, set it to 'yes'.# Default is 'no'.  This only changes the behaviour of the 'Top# URL's' table.#UseHTTPS       no# DNSCache specifies the DNS cache filename to use for reverse DNS lookups.# This file must be specified if you wish to perform name lookups on any IP# addresses found in the log file.  If an absolute path is not given as# part of the filename (ie: starts with a leading '/'), then the name is# relative to the default output directory.  See the DNS.README file for# additional information.#DNSCache	dns_cache.db# DNSChildren allows you to specify how many "children" processes are# run to perform DNS lookups to create or update the DNS cache file.# If a number is specified, the DNS cache file will be created/updated# each time the Webalizer is run, immediately prior to normal processing,# by running the specified number of "children" processes to perform# DNS lookups.  If used, the DNS cache filename MUST be specified as# well.  The default value is zero (0), which disables DNS cache file# creation/updates at run time.  The number of children processes to# run may be anywhere from 1 to 100, however a large number may effect# normal system operations.  Reasonable values should be between 5 and# 20.  See the DNS.README file for additional information.#DNSChildren	0# HTMLPre defines HTML code to insert at the very beginning of the# file.  Default is the DOCTYPE line shown below.  Max line length# is 80 characters, so use multiple HTMLPre lines if you need more.#HTMLPre <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"># HTMLHead defines HTML code to insert within the <HEAD></HEAD># block, immediately after the <TITLE> line.  Maximum line length# is 80 characters, so use multiple lines if needed.#HTMLHead <META NAME="author" CONTENT="The Webalizer"># HTMLBody defined the HTML code to be inserted, starting with the# <BODY> tag.  If not specified, the default is shown below.  If# used, you MUST include your own <BODY> tag as the first line.# Maximum line length is 80 char, use multiple lines if needed.HTMLBody <BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#FF0000" VLINK="#A00000"># HTMLPost defines the HTML code to insert immediately before the# first <HR> on the document, which is just after the title and# "summary period"-"Generated on:" lines.  If anything, this should# be used to clean up in case an image was inserted with HTMLBody.# As with HTMLHead, you can define as many of these as you want and# they will be inserted in the output stream in order of apperance.# Max string size is 80 characters.  Use multiple lines if you need to.#HTMLPost 	<BR CLEAR="all"># HTMLTail defines the HTML code to insert at the bottom of each# HTML document, usually to include a link back to your home# page or insert a small graphic.  It is inserted as a table# data element (ie: <TD> your code here </TD>) and is right# alligned with the page.  Max string size is 80 characters.#HTMLTail <IMG SRC="msfree.png" ALT="100% Micro$oft free!"># HTMLEnd defines the HTML code to add at the very end of the# generated files.  It defaults to what is shown below.  If# used, you MUST specify the </BODY> and </HTML> closing tags# as the last lines.  Max string length is 80 characters.#HTMLEnd </BODY></HTML># The Quiet option suppresses output messages... Useful when run# as a cron job to prevent bogus e-mails.  Values can be either# "yes" or "no".  Default is "no".  Note: this does not suppress# warnings and errors (which are printed to stderr).#Quiet		no# ReallyQuiet will supress all messages including errors and# warnings.  Values can be 'yes' or 'no' with 'no' being the# default.  If 'yes' is used here, it cannot be overriden from# the command line, so use with caution.  A value of 'no' has# no effect.#ReallyQuiet	no# TimeMe allows you to force the display of timing information# at the end of processing.  A value of 'yes' will force the# timing information to be displayed.  A value of 'no' has no# effect.#TimeMe		no# GMTTime allows reports to show GMT (UTC) time instead of local# time.  Default is to display the time the report was generated# in the timezone of the local machine, such as EDT or PST.  This# keyword allows you to have times displayed in UTC instead.  Use# only if you really have a good reason, since it will probably# screw up the reporting periods by however many hours your local# time zone is off of GMT.#GMTTime		no# Debug prints additional information for error messages.  This# will cause webalizer to dump bad records/fields instead of just# telling you it found a bad one.   As usual, the value can be# either "yes" or "no".  The default is "no".  It shouldn't be# needed unless you start getting a lot of Warning or Error# messages and want to see why.  (Note: warning and error messages# are printed to stderr, not stdout like normal messages).#Debug		no# FoldSeqErr forces the Webalizer to ignore sequence errors.# This is useful for Netscape and other web servers that cache# the writing of log records and do not guarentee that they# will be in chronological order.  The use of the FoldSeqErr# option will cause out of sequence log records to be treated# as if they had the same time stamp as the last valid record.# Default is to ignore out of sequence log records.FoldSeqErr	yes# VisitTimeout allows you to set the default timeout for a visit# (sometimes called a 'session').  The default is 30 minutes,# which should be fine for most sites.# Visits are determined by looking at the time of the current# request, and the time of the last request from the site.  If# the time difference is greater than the VisitTimeout value, it# is considered a new visit, and visit totals are incremented.# Value is the number of seconds to timeout (default=1800=30min)#VisitTimeout	1800# IgnoreHist shouldn't be used in a config file, but it is here# just because it might be useful in certain situations.  If the# history file is ignored, the main "index.html" file will only# report on the current log files contents.  Usefull only when you# want to reproduce the reports from scratch.  USE WITH CAUTION!# Valid values are "yes" or "no".  Default is "no".#IgnoreHist	no# Country Graph allows the usage by country graph to be disabled.# Values can be 'yes' or 'no', default is 'yes'.#CountryGraph	yes# DailyGraph and DailyStats allows the daily statistics graph# and statistics table to be disabled (not displayed).  Values# may be "yes" or "no". Default is "yes".#DailyGraph	yes#DailyStats	yes# HourlyGraph and HourlyStats allows the hourly statistics graph# and statistics table to be disabled (not displayed).  Values# may be "yes" or "no". Default is "yes".#HourlyGraph	yes#HourlyStats	yes# GraphLegend allows the color coded legends to be turned on or off# in the graphs.  The default is for them to be displayed.  This only# toggles the color coded legends, the other legends are not changed.# If you think they are hideous and ugly, say 'no' here :)#GraphLegend	yes