Ticket #4463: awstats.www.conf

File awstats.www.conf, 59.6 KB (added by runa, 9 years ago)
Line 
1WSTATS CONFIGURE FILE 6.8
2#-----------------------------------------------------------------------------
3# Copy this file into awstats.www.mydomain.conf and edit this new config file
4# to setup AWStats (See documentation in docs/ directory).
5# The config file must be in /etc/awstats, /usr/local/etc/awstats or /etc (for
6# Unix/Linux) or same directory than awstats.pl (Windows, Mac, Unix/Linux...)
7# To include an environment variable in any parameter (AWStats will replace
8# it with its value when reading it), follow the example:
9# Parameter="__ENVNAME__"
10# Note that environment variable AWSTATS_CURRENT_CONFIG is always defined with
11# the config value in an AWStats running session and can be used like others.
12#-----------------------------------------------------------------------------
13# $Revision: 1.334 $ - $Author: eldy $ - $Date: 2008/10/05 11:01:31 $
14
15
16
17#-----------------------------------------------------------------------------
18# MAIN SETUP SECTION (Required to make AWStats work)
19#-----------------------------------------------------------------------------
20
21# "LogFile" contains the web, ftp or mail server log file to analyze.
22# Possible values: A full path, or a relative path from awstats.pl directory.
23# Example: "/var/log/apache/access.log"
24# Example: "../logs/mycombinedlog.log"
25# You can also use tags in this filename if you need a dynamic file name
26# depending on date or time (Replacement is made by AWStats at the beginning
27# of its execution). This is available tags :
28#   %YYYY-n  is replaced with 4 digits year we were n hours ago
29#   %YY-n    is replaced with 2 digits year we were n hours ago
30#   %MM-n    is replaced with 2 digits month we were n hours ago
31#   %MO-n    is replaced with 3 letters month we were n hours ago
32#   %DD-n    is replaced with day we were n hours ago
33#   %HH-n    is replaced with hour we were n hours ago
34#   %NS-n    is replaced with number of seconds at 00:00 since 1970
35#   %WM-n    is replaced with the week number in month (1-5)
36#   %Wm-n    is replaced with the week number in month (0-4)
37#   %WY-n    is replaced with the week number in year (01-52)
38#   %Wy-n    is replaced with the week number in year (00-51)
39#   %DW-n    is replaced with the day number in week (1-7, 1=sunday)
40#                              use n=24 if you need (1-7, 1=monday)
41#   %Dw-n    is replaced with the day number in week (0-6, 0=sunday)
42#                              use n=24 if you need (0-6, 0=monday)
43#   Use 0 for n if you need current year, month, day, hour...
44# Example: "/var/log/access_log.%YYYY-0%MM-0%DD-0.log"
45# Example: "C:/WINNT/system32/LogFiles/W3SVC1/ex%YY-24%MM-24%DD-24.log"
46# You can also use a pipe if log file come from a pipe :
47# Example: "gzip -d </var/log/apache/access.log.gz |"
48# If there are several log files from load balancing servers :
49# Example: "/pathtotools/logresolvemerge.pl *.log |"
50#
51# LogFile="/var/log/apache2/access.log"
52LogFile="/home/ubuntu/www.torproject.org-access.log"
53
54# Enter the log file type you want to analyze.
55# Possible values:
56#  W - For a web log file
57#  S - For a streaming log file
58#  M - For a mail log file
59#  F - For a ftp log file
60# Example: W
61# Default: W
62#
63LogType=W
64
65# Enter here your log format (Must match your web server config. See setup
66# instructions in documentation to know how to configure your web server to
67# have the required log format).
68# Possible values: 1,2,3,4 or "your_own_personalized_log_format"
69# 1 - Apache or Lotus Notes/Domino native combined log format (NCSA combined/XLF/ELF log format)
70# 2 - IIS or ISA format (IIS W3C log format). See FAQ-COM115 For ISA.
71# 3 - Webstar native log format.
72# 4 - Apache or Squid native common log format (NCSA common/CLF log format)
73#     With LogFormat=4, some features (browsers, os, keywords...) can't work.
74# "your_own_personalized_log_format" = If your log is ftp, mail or other format,
75#     you must use following keys to define the log format string (See FAQ for
76#     ftp, mail or exotic web log format examples):
77#   %host             Client hostname or IP address (or Sender host for mail log)
78#   %host_r           Receiver hostname or IP address (for mail log)
79#   %lognamequot      Authenticated login/user with format: "john"
80#   %logname          Authenticated login/user with format: john
81#   %time1            Date and time with format: [dd/mon/yyyy:hh:mm:ss +0000] or [dd/mon/yyyy:hh:mm:ss]
82#   %time2            Date and time with format: yyyy-mm-dd hh:mm:ss
83#   %time3            Date and time with format: Mon dd hh:mm:ss or Mon dd hh:mm:ss yyyy
84#   %time4            Date and time with unix timestamp format: dddddddddd
85#   %methodurl        Method and URL with format: "GET /index.html HTTP/x.x"
86#   %methodurlnoprot  Method and URL with format: "GET /index.html"
87#   %method           Method with format: GET
88#   %url              URL only with format: /index.html
89#   %query            Query string (used by URLWithQuery option)
90#   %code             Return code status (with format for web log: 999)
91#   %bytesd           Size of document in bytes
92#   %refererquot      Referer page with format: "http://from.com/from.htm"
93#   %referer          Referer page with format: http://from.com/from.htm
94#   %uabracket        User agent with format: [Mozilla/4.0 (compatible, ...)]
95#   %uaquot           User agent with format: "Mozilla/4.0 (compatible, ...)"
96#   %ua               User agent with format: Mozilla/4.0_(compatible...)
97#   %gzipin           mod_gzip compression input bytes: In:XXX
98#   %gzipout          mod_gzip compression output bytes & ratio: Out:YYY:ZZpct.
99#   %gzipratio        mod_gzip compression ratio: ZZpct.
100#   %deflateratio     mod_deflate compression ratio with format: (ZZ)
101#   %email            EMail sender (for mail log)
102#   %email_r          EMail receiver (for mail log)
103#   %virtualname      Web sever virtual hostname. Use this tag when same log
104#                     contains data of several virtual web servers. AWStats
105#                     will discard records not in SiteDomain nor HostAliases
106#   %cluster          If log file is provided from several computers (merged by
107#                     logresolvemerge.pl), use this to define cluster id field.
108#   %extraX           Another field that you plan to use for building a
109#                     personalized report with ExtraSection feature (See later).
110#   If your log format has some fields not included in this list, use:
111#   %other            Means another not used field
112#   %otherquot        Means another not used double quoted field
113#
114# Examples for Apache combined logs (following two examples are equivalent):
115# LogFormat = 1
116# LogFormat = "%host %other %logname %time1 %methodurl %code %bytesd %refererquot %uaquot"
117#
118# Example for IIS:
119# LogFormat = 2
120#
121# LogFormat=4
122LogFormat = "%host %other %other %time1 %methodurl %code %bytesd %other %other"
123
124# If your log field's separator is not a space, you can change this parameter.
125# This parameter is not used if LogFormat is a predefined value (1,2,3,4)
126# Backslash can be used as escape character.
127# Example: " "
128# Example: "\t"
129# Example: "\|"
130# Example: ","
131# Default: " "
132#
133LogSeparator=" "
134
135
136# "SiteDomain" must contain the main domain name, or the main intranet web
137# server name, used to reach the web site.
138# If you share the same log file for several virtual web servers, this
139# parameter is used to tell AWStats to filter record that contains records for
140# this virtual host name only (So check that this virtual hostname can be
141# found in your log file and use a personalized log format that include the
142# %virtualname tag).
143# But for multi hosting a better solution is to have one log file for each
144# virtual web server. In this case, this parameter is only used to generate
145# full URL's links when ShowLinksOnUrl option is set to 1.
146# If analyzing mail log, enter here the domain name of mail server.
147# Example: "myintranetserver"
148# Example: "www.domain.com"
149# Example: "ftp.domain.com"
150# Example: "domain.com"
151#
152#SiteDomain=""
153SiteDomain="localhost 127.0.0.1"
154
155
156# Enter here all other possible domain names, addresses or virtual host
157# aliases someone can use to access your site. Try to keep only the minimum
158# number of possible names/addresses to have the best performances.
159# You can repeat the "SiteDomain" value in this list.
160# This parameter is used to analyze referer field in log file and to help
161# AWStats to know if a referer URL is a local URL of same site or an URL of
162# another site.
163# Note: Use space between each value.
164# Note: You can use regular expression values writing value with REGEX[value].
165# Note: You can also use @/mypath/myfile if list of aliases are in a file.
166# Example: "www.myserver.com localhost 127.0.0.1 REGEX[mydomain\.(net|org)$]"
167#
168HostAliases="localhost 127.0.0.1"
169
170
171# If you want to have hosts reported by name instead of ip address, AWStats
172# need to make reverse DNS lookups (if not already done in your log file).
173# With DNSLookup to 0, all hosts will be reported by their IP addresses and
174# not by the full hostname of visitors (except if names are already available
175# in log file).
176# If you want/need to set DNSLookup to 1, don't forget that this will reduce
177# dramatically AWStats update process speed. Do not use on large web sites.
178# Note: Reverse DNS lookup is done on IPv4 only (Enable ipv6 plugin for IPv6).
179# Note: Result of DNS Lookup can be used to build the Country report. However
180# it is highly recommanded to enable the plugin 'geoip' or 'geoipfree' to
181# have an accurate Country report with no need of DNS Lookup.
182# Possible values:
183# 0 - No DNS Lookup
184# 1 - DNS Lookup is fully enabled
185# 2 - DNS Lookup is made only from static DNS cache file (if it exists)
186# Default: 2
187#
188DNSLookup=1
189
190# When AWStats updates its statistics, it stores results of its analysis in
191# files (AWStats database). All those files are written in the directory
192# defined by the "DirData" parameter. Set this value to the directory where
193# you want AWStats to save its database and working files into.
194# Warning: If you want to be able to use the "AllowToUpdateStatsFromBrowser"
195# feature (see later), you need "Write" permissions by web server user on this
196# directory (and "Modify" for Windows NTFS file systems).
197# Example: "/var/lib/awstats"
198# Example: "../data"
199# Example: "C:/awstats_data_dir"
200# Default: "."          (means same directory as awstats.pl)
201#
202DirData="/var/lib/awstats"
203
204
205# Relative or absolute web URL of your awstats cgi-bin directory.
206# This parameter is used only when AWStats is run from command line
207# with -output option (to generate links in HTML reported page).
208# Example: "/awstats"
209# Default: "/cgi-bin"   (means awstats.pl is in "/yourwwwroot/cgi-bin")
210#
211DirCgi="/cgi-bin"
212
213
214# Relative or absolute web URL of your awstats icon directory.
215# If you build static reports ("... -output > outputpath/output.html"), enter
216# path of icon directory relative to the output directory 'outputpath'.
217# Example: "/awstatsicons"
218# Example: "../icon"
219# Default: "/icon" (means you must copy icon directories in "/mywwwroot/icon")
220#
221DirIcons="/awstats-icon"
222
223
224# When this parameter is set to 1, AWStats adds a button on report page to
225# allow to "update" statistics from a web browser. Warning, when "update" is
226# made from a browser, AWStats is run as a CGI by the web server user defined
227# in your web server (user "nobody" by default with Apache, "IUSR_XXX" with
228# IIS), so the "DirData" directory and all already existing history files
229# awstatsMMYYYY[.xxx].txt must be writable by this user. Change permissions if
230# necessary to "Read/Write" (and "Modify" for Windows NTFS file systems).
231# Warning: Update process can be long so you might experience "time out"
232# browser errors if you don't launch AWStats frequently enough.
233# When set to 0, update is only made when AWStats is run from the command
234# line interface (or a task scheduler).
235# Possible values: 0 or 1
236# Default: 0
237#
238AllowToUpdateStatsFromBrowser=0
239
240
241# AWStats saves and sorts its database on a month basis (except if using
242# databasebreak option from command line).
243# However, if you choose the -month=all from command line or
244# value '-Year-' from CGI combo form to have a report for all year, AWStats
245# needs to reload all data for full year (each month), and sort them,
246# requiring a large amount of time, memory and CPU. This might be a problem
247# for web hosting providers that offer AWStats for large sites, on shared
248# servers, to non CPU cautious customers.
249# For this reason, the 'full year' is only enabled on Command Line by default.
250# You can change this by setting this parameter to 0, 1, 2 or 3.
251# Possible values:
252#  0 - Never allowed
253#  1 - Allowed on CLI only, -Year- value in combo is not visible
254#  2 - Allowed on CLI only, -Year- value in combo is visible but not allowed
255#  3 - Possible on CLI and CGI
256# Default: 2
257#
258AllowFullYearView=2
259
260#-----------------------------------------------------------------------------
261# OPTIONAL SETUP SECTION (Not required but increase AWStats features)
262#-----------------------------------------------------------------------------
263
264# When the update process runs, AWStats can set a lock file in TEMP or TMP
265# directory. This lock is to avoid to have 2 update processes running at the
266# same time to prevent unknown conflicts problems and avoid DoS attacks when
267# AllowToUpdateStatsFromBrowser is set to 1.
268# Because, when you use lock file, you can experience sometimes problems in
269# lock file not correctly removed (killed process for example requires that
270# you remove the file manualy), this option is not enabled by default (Do
271# not enable this option with no console server access).
272# Change : Effective immediatly
273# Possible values: 0 or 1
274# Default: 0
275#
276EnableLockForUpdate=0
277
278
279# AWStats can do reverse DNS lookups through a static DNS cache file that was
280# previously created manually. If no path is given in static DNS cache file
281# name, AWStats will search DirData directory. This file is never changed.
282# This option is not used if DNSLookup=0.
283# Note: DNS cache file format is 'minsince1970 ipaddress resolved_hostname'
284# or just 'ipaddress resolved_hostname'
285# Change : Effective for new updates only
286# Example: "/mydnscachedir/dnscache"
287# Default: "dnscache.txt"
288#
289DNSStaticCacheFile="dnscache.txt"
290
291
292# AWStats can do reverse DNS lookups through a DNS cache file that was created
293# by a previous run of AWStats. This file is erased and recreated after each
294# statistics update process. You don't need to create and/or edit it.
295# AWStats will read and save this file in DirData directory.
296# This option is used only if DNSLookup=1.
297# Note: If a DNSStaticCacheFile is available, AWStats will check for DNS
298# lookup in DNSLastUpdateCacheFile after checking into DNSStaticCacheFile.
299# Change : Effective for new updates only
300# Example: "/mydnscachedir/dnscachelastupdate"
301# Default: "dnscachelastupdate.txt"
302#
303DNSLastUpdateCacheFile="dnscachelastupdate.txt"
304
305
306# You can specify specific IP addresses that should NOT be looked up in DNS.
307# This option is used only if DNSLookup=1.
308# Note: Use space between each value.
309# Note: You can use regular expression values writing value with REGEX[value].
310# Change : Effective for new updates only
311# Example: "123.123.123.123 REGEX[^192\.168\.]"
312# Default: ""
313#
314SkipDNSLookupFor=""
315
316# The following two parameters allow you to protect a config file from being
317# read by AWStats when called from a browser if web user has not been
318# authenticated. Your AWStats program must be in a web protected "realm" (With
319# Apache, you can use .htaccess files to do so. With other web servers, see
320# your server setup manual).
321# Change : Effective immediatly
322# Possible values: 0 or 1
323# Default: 0
324#
325AllowAccessFromWebToAuthenticatedUsersOnly=0
326
327
328# This parameter gives the list of all authorized authenticated users to view
329# statistics for this domain/config file. This parameter is used only if
330# AllowAccessFromWebToAuthenticatedUsersOnly is set to 1.
331# Change : Effective immediatly
332# Example: "user1 user2"
333# Example: "__REMOTE_USER__"
334# Default: ""
335#
336AllowAccessFromWebToFollowingAuthenticatedUsers=""
337
338
339# When this parameter is defined to something, the IP address of the user that
340# reads its statistics from a browser (when AWStats is used as a CGI) is
341# checked and must match one of the IP address values or ranges.
342# Change : Effective immediatly
343# Example: "127.0.0.1 123.123.123.1-123.123.123.255"
344# Default: ""
345#
346AllowAccessFromWebToFollowingIPAddresses=""
347
348
349# If the "DirData" directory (see above) does not exist, AWStats return an
350# error. However, you can ask AWStats to create it.
351# This option can be used by some Web Hosting Providers that has defined a
352# dynamic value for DirData (for example DirData="/home/__REMOTE_USER__") and
353# don't want to have to create a new directory each time they add a new user.
354# Change : Effective immediatly
355# Possible values: 0 or 1
356# Default: 0
357#
358CreateDirDataIfNotExists=0
359
360
361# You can choose in which format the Awstats history database is saved.
362# Note: Using "xml" format make AWStats building database files three times
363# larger than using "text" format.
364# Change : Database format is switched after next update
365# Possible values: text or xml
366# Default: text
367#
368BuildHistoryFormat=text
369
370
371# If you prefer having the report output pages be built as XML compliant pages
372# instead of simple HTML pages, you can set this to 'xhtml' (May not work
373# properly with old browsers).
374# Change : Effective immediatly
375# Possible values: html or xhtml
376# Default: html
377#
378BuildReportFormat=html
379
380# AWStats databases can be updated from command line of from a browser (when
381# used as a cgi program). So AWStats database files need write permission
382# for both command line user and default web server user (nobody for Unix,
383# IUSR_xxx for IIS/Windows,...).
384# To avoid permission problems between update process (run by an admin user)
385# and CGI process (ran by a low level user), AWStats can save its database
386# files with read and write permissions for everyone.
387# By default, AWStats keeps default user permissions on updated files. If you
388# set AllowToUpdateStatsFromBrowser to 1, you can change this parameter to 1.
389# Change : Effective for new updates only
390# Possible values: 0 or 1
391# Default: 0
392#
393SaveDatabaseFilesWithPermissionsForEveryone=0
394
395
396# AWStats can purge log file, after analyzing it. Note that AWStats is able
397# to detect new lines in a log file, to process only them, so you can launch
398# AWStats as often as you want, even with this parameter to 0.
399# With 0, no purge is made, so you must use a scheduled task or a web server
400# that make this purge frequently.
401# With 1, the purge of the log file is made each time AWStats update is run.
402# This parameter doesn't work with IIS (This web server doesn't let its log
403# file to be purged).
404# Change : Effective for new updates only
405# Possible values: 0 or 1
406# Default: 0
407#
408PurgeLogFile=0
409
410
411# When PurgeLogFile is setup to 1, AWStats will clean your log file after
412# processing it. You can however keep an archive file of all processed log
413# records by setting this parameter (For example if you want to use another
414# log analyzer). The archived log file is saved in "DirData" with name
415# awstats_archive.configname[.suffix].log
416# This parameter is not used if PurgeLogFile=0
417# Change : Effective for new updates only
418# Possible values: 0, 1, or tags (See LogFile parameter) for suffix
419# Example: 1
420# Example: %YYYY%MM%DD
421# Default: 0
422#
423ArchiveLogRecords=0
424
425
426# Each time you run the update process, AWStats overwrites the 'historic file'
427# for the month (awstatsMMYYYY[.*].txt) with the updated one.
428# When write errors occurs (IO, disk full,...), this historic file can be
429# corrupted and must be deleted. Because this file contains information of all
430# past processed log files, you will loose old stats if removed. So you can
431# ask AWStats to save last non corrupted file in a .bak file. This file is
432# stored in "DirData" directory with other 'historic files'.
433# Change : Effective for new updates only
434# Possible values: 0 or 1
435# Default: 0
436#
437KeepBackupOfHistoricFiles=0
438
439
440# Default index page name for your web server.
441# Change : Effective for new updates only
442# Example: "index.php index.html default.html"
443# Default: "index.html"
444#
445DefaultFile="index.html"
446
447# Do not include access from clients that match following criteria.
448# If your log file contains IP addresses in host field, you must enter here
449# matching IP addresses criteria.
450# If DNS lookup is already done in your log file, you must enter here hostname
451# criteria, else enter ip address criteria.
452# The opposite parameter of "SkipHosts" is "OnlyHosts".
453# Note: Use space between each value. This parameter is not case sensitive.
454# Note: You can use regular expression values writing value with REGEX[value].
455# Change : Effective for new updates only
456# Example: "127.0.0.1 REGEX[^192\.168\.] REGEX[^10\.]"
457# Example: "localhost REGEX[^.*\.localdomain$]"
458# Default: ""
459#
460SkipHosts=""
461
462
463# Do not include access from clients with a user agent that match following
464# criteria. If you want to exclude a robot, you should update the robots.pm
465# file instead of this parameter.
466# The opposite parameter of "SkipUserAgents" is "OnlyUserAgents".
467# Note: Use space between each value. This parameter is not case sensitive.
468# Note: You can use regular expression values writing value with REGEX[value].
469# Change : Effective for new updates only
470# Example: "konqueror REGEX[ua_test_v\d\.\d]"
471# Default: ""
472#
473SkipUserAgents=""
474
475
476# Use SkipFiles to ignore access to URLs that match one of following entries.
477# You can enter a list of not important URLs (like framed menus, hidden pages,
478# etc...) to exclude them from statistics. You must enter here exact relative
479# URL as found in log file, or a matching REGEX value. Check apply on URL with
480# all its query paramaters.
481# For example, to ignore /badpage.php, just add "/badpage.php". To ignore all
482# pages in a particular directory, add "REGEX[^\/directorytoexclude]".
483# The opposite parameter of "SkipFiles" is "OnlyFiles".
484# Note: Use space between each value. This parameter is or not case sensitive
485# depending on URLNotCaseSensitive parameter.
486# Note: You can use regular expression values writing value with REGEX[value].
487# Change : Effective for new updates only
488# Example: "/badpage.php /page.php?param=x REGEX[^\/excludedirectory]"
489# Default: ""
490#
491SkipFiles=""
492
493
494# Use SkipReferrersBlackList if you want to exclude records coming from a SPAM
495# referrer. Parameter must receive a local file name containing rules applied
496# on referrer field. If parameter is empty, no filter is applied.
497# An example of such a file is available in lib/blacklist.txt
498# You can download updated version at http://www.jayallen.org/comment_spam/
499# Change : Effective for new updates only
500# Example: "/mylibpath/blacklist.txt"
501# Default: ""
502#
503# WARNING!! Using this feature make AWStats running very slower (5 times slower
504# with black list file provided with AWStats !
505#
506SkipReferrersBlackList=""
507
508# Include in stats, only accesses from hosts that match one of following
509# entries. For example, if you want AWStats to filter access to keep only
510# stats for visits from particular hosts, you can add those host names in
511# this parameter.
512# If DNS lookup is already done in your log file, you must enter here hostname
513# criteria, else enter ip address criteria.
514# The opposite parameter of "OnlyHosts" is "SkipHosts".
515# Note: Use space between each value. This parameter is not case sensitive.
516# Note: You can use regular expression values writing value with REGEX[value].
517# Change : Effective for new updates only
518# Example: "127.0.0.1 REGEX[^192\.168\.] REGEX[^10\.]"
519# Default: ""
520#
521OnlyHosts=""
522
523
524# Include in stats, only accesses from user agent that match one of following
525# entries. For example, if you want AWStats to filter access to keep only
526# stats for visits from particular browsers, you can add their user agents
527# string in this parameter.
528# The opposite parameter of "OnlyUserAgents" is "SkipUserAgents".
529# Note: Use space between each value. This parameter is not case sensitive.
530# Note: You can use regular expression values writing value with REGEX[value].
531# Change : Effective for new updates only
532# Example: "msie"
533# Default: ""
534#
535OnlyUserAgents=""
536
537
538# Include in stats, only accesses from authenticated users that match one of
539# following entries. For example, if you want AWStats to filter access to keep
540# only stats for authenticated users, you can add those users names in
541# this parameter. Useful for statistics for per user ftp logs.
542# Note: Use space between each value. This parameter is not case sensitive.
543# Note: You can use regular expression values writing value with REGEX[value].
544# Change : Effective for new updates only
545# Example: "john bob REGEX[^testusers]"
546# Default: ""
547#
548OnlyUsers=""
549
550
551# Include in stats, only accesses to URLs that match one of following entries.
552# For example, if you want AWStats to filter access to keep only stats that
553# match a particular string, like a particular directory, you can add this
554# directory name in this parameter.
555# The opposite parameter of "OnlyFiles" is "SkipFiles".
556# Note: Use space between each value. This parameter is or not case sensitive
557# depending on URLNotCaseSensitive parameter.
558# Note: You can use regular expression values writing value with REGEX[value].
559# Change : Effective for new updates only
560# Example: "REGEX[marketing_directory] REGEX[office\/.*\.(csv|sxw)$]"
561# Default: ""
562#
563OnlyFiles=""
564
565
566# Add here a list of kind of url (file extension) that must be counted as
567# "Hit only" and not as a "Hit" and "Page/Download". You can set here all
568# image extensions as they are hit downloaded that must be counted but they
569# are not viewed pages. URLs with such extensions are not included in the TOP
570# Pages/URL report.
571# Note: If you want to exclude particular URLs from stats (No Pages and no
572# Hits reported), you must use SkipFiles parameter.
573# Change : Effective for new updates only
574# Example: "css js class gif jpg jpeg png bmp ico rss xml swf zip arj rar gz z bz2 wav mp3 wma mpg avi"
575# Example: ""
576# Default: "css js class gif jpg jpeg png bmp ico rss xml swf"
577#
578NotPageList="css js class gif jpg jpeg png bmp ico rss xml swf"
579
580# By default, AWStats considers that records found in web log file are
581# successful hits if HTTP code returned by server is a valid HTTP code (200
582# and 304). Any other code are reported in HTTP status chart.
583# Note that HTTP 'control codes', like redirection (302, 305) are not added by
584# default in this list as they are not pages seen by a visitor but are
585# protocol exchange codes to tell the browser to ask another page. Because
586# this other page will be counted and seen with a 200 or 304 code, if you
587# add such codes, you will have 2 pages viewed reported for only one in facts.
588# Change : Effective for new updates only
589# Example: "200 304 302 305"
590# Default: "200 304"
591#
592ValidHTTPCodes="200 304"
593
594
595# By default, AWStats considers that records found in mail log file are
596# successful mail transfers if field that represent return code in analyzed
597# log file match values defined by this parameter.
598# Change : Effective for new updates only
599# Example: "1 250 200"
600# Default: "1 250"
601#
602ValidSMTPCodes="1 250"
603
604
605# Some web servers on some Operating systems (IIS-Windows) consider that a
606# login with same value but different case are the same login. To tell AWStats
607# to also consider them as one, set this parameter to 1.
608# Change : Effective for new updates only
609# Possible values: 0 or 1
610# Default: 0
611#
612AuthenticatedUsersNotCaseSensitive=0
613
614
615# Some web servers on some Operating systems (IIS-Windows) considers that two
616# URLs with same value but different case are the same URL. To tell AWStats to
617# also considers them as one, set this parameter to 1.
618# Change : Effective for new updates only
619# Possible values: 0 or 1
620# Default: 0
621#
622URLNotCaseSensitive=0
623
624
625# Keep or remove the anchor string you can find in some URLs.
626# Change : Effective for new updates only
627# Possible values: 0 or 1
628# Default: 0
629#
630URLWithAnchor=0
631
632
633# In URL links, "?" char is used to add parameter's list in URLs. Syntax is:
634# /mypage.html?param1=value1&param2=value2
635# However, some servers/sites use also other chars to isolate dynamic part of
636# their URLs. You can complete this list with all such characters.
637# Change : Effective for new updates only
638# Example: "?;,"
639# Default: "?;"
640#
641URLQuerySeparators="?;"
642
643# Keep or remove the query string to the URL in the statistics for individual
644# pages. This is primarily used to differentiate between the URLs of dynamic
645# pages. If set to 1, mypage.html?id=x and mypage.html?id=y are counted as two
646# different pages.
647# Warning, when set to 1, memory required to run AWStats is dramatically
648# increased if you have a lot of changing URLs (for example URLs with a random
649# id inside). Such web sites should not set this option to 1 or use seriously
650# the next parameter URLWithQueryWithOnlyFollowingParameters (or eventually
651# URLWithQueryWithoutFollowingParameters).
652# Change : Effective for new updates only
653# Possible values:
654# 0 - URLs are cleaned from the query string (ie: "/mypage.html")
655# 1 - Full URL with query string is used     (ie: "/mypage.html?p=x&q=y")
656# Default: 0
657#
658URLWithQuery=0
659
660
661# When URLWithQuery is on, you will get the full URL with all parameters in
662# URL reports. But among thoose parameters, sometimes you don't need a
663# particular parameter because it does not identify the page or because it's
664# a random ID changing for each access even if URL points to same page. In
665# such cases, it is higly recommanded to ask AWStats to keep only parameters
666# you need (if you know them) before counting, manipulating and storing URL.
667# Enter here list of wanted parameters. For example, with "param", one hit on
668# /mypage.cgi?param=abc&id=Yo4UomP9d  and  /mypage.cgi?param=abc&id=Mu8fdxl3r
669# will be reported as 2 hits on /mypage.cgi?param=abc
670# This parameter is not used when URLWithQuery is 0 and can't be used with
671# URLWithQueryWithoutFollowingParameters.
672# Change : Effective for new updates only
673# Example: "param"
674# Default: ""
675#
676URLWithQueryWithOnlyFollowingParameters=""
677
678
679# When URLWithQuery is on, you will get the full URL with all parameters in
680# URL reports. But among thoose parameters, sometimes you don't need a
681# particular parameter because it does not identify the page or because it's
682# a random ID changing for each access even if URL points to same page. In
683# such cases, it is higly recommanded to ask AWStats to remove such parameters
684# from the URL before counting, manipulating and storing URL. Enter here list
685# of all non wanted parameters. For example if you enter "id", one hit on
686# /mypage.cgi?param=abc&id=Yo4UomP9d  and  /mypage.cgi?param=abc&id=Mu8fdxl3r
687# will be reported as 2 hits on /mypage.cgi?param=abc
688# This parameter is not used when URLWithQuery is 0 and can't be used with
689# URLWithQueryWithOnlyFollowingParameters.
690# Change : Effective for new updates only
691# Example: "PHPSESSID jsessionid"
692# Default: ""
693#
694URLWithQueryWithoutFollowingParameters=""
695
696
697# Keep or remove the query string to the referrer URL in the statistics for
698# external referrer pages. This is used to differentiate between the URLs of
699# dynamic referrer pages. If set to 1, mypage.html?id=x and mypage.html?id=y
700# are counted as two different referrer pages.
701# Change : Effective for new updates only
702# Possible values:
703# 0 - Referrer URLs are cleaned from the query string (ie: "/mypage.html")
704# 1 - Full URL with query string is used      (ie: "/mypage.html?p=x&q=y")
705# Default: 0
706#
707URLReferrerWithQuery=0
708
709# AWStats can detect setup problems or show you important informations to have
710# a better use. Keep this to 1, except if AWStats says you can change it.
711# Change : Effective immediatly
712# Possible values: 0 or 1
713# Default: 1
714#
715WarningMessages=1
716
717
718# When an error occurs, AWStats outputs a message related to errors. If you
719# want (in most cases for security reasons) to have no error messages, you
720# can set this parameter to your personalized generic message.
721# Change : Effective immediatly
722# Example: "An error occurred. Contact your Administrator"
723# Default: ""
724#
725ErrorMessages=""
726
727
728# AWStat can be run with debug=x parameter to output various informations
729# to help in debugging or solving troubles. If you want to allow this (not
730# enabled by default for security reasons), set this parameter to 0.
731# Change : Effective immediatly
732# Possible values: 0 or 1
733# Default: 0
734#
735DebugMessages=0
736
737
738# To help you to detect if your log format is good, AWStats reports an error
739# if all the first NbOfLinesForCorruptedLog lines have a format that does not
740# match the LogFormat parameter.
741# However, some worm virus attack on your web server can result in a very high
742# number of corrupted lines in your log. So if you experience awstats stop
743# because of bad virus records at the beginning of your log file, you can
744# increase this parameter (very rare).
745# Change : Effective for new updates only
746# Default: 50
747#
748NbOfLinesForCorruptedLog=50
749
750
751# For some particular integration needs, you may want to have CGI links to
752# point to another script than awstats.pl.
753# Use the name of this script in WrapperScript parameter.
754# Change : Effective immediatly
755# Example: "awstatslauncher.pl"
756# Default: ""
757#
758WrapperScript=""
759
760
761# DecodeUA must be set to 1 if you use Roxen web server. This server converts
762# all spaces in user agent field into %20. This make the AWStats robots, OS
763# and browsers detection fail in some cases. Just change it to 1 if and only
764# if your web server is Roxen.
765# Change : Effective for new updates only
766# Possible values: 0 or 1
767# Default: 0
768#
769DecodeUA=0
770
771# MiscTrackerUrl can be used to make AWStats able to detect some miscellaneous
772# things, that can not be tracked on other way, like:
773# - Javascript disabled
774# - Java enabled
775# - Screen size
776# - Color depth
777# - Macromedia Director plugin
778# - Macromedia Shockwave plugin
779# - Realplayer G2 plugin
780# - QuickTime plugin
781# - Mediaplayer plugin
782# - Acrobat PDF plugin
783# To enable all these features, you must copy the awstats_misc_tracker.js file
784# into a /js/ directory stored in your web document root and add the following
785# HTML code at the end of your index page (but before </BODY>) :
786#
787# <script type="text/javascript" src="/js/awstats_misc_tracker.js"></script>
788# <noscript><img src="/js/awstats_misc_tracker.js?nojs=y" height=0 width=0 border=0 style="display: none"></noscript>
789#
790# If code is not added in index page, all those detection capabilities will be
791# disabled. You must also check that ShowScreenSizeStats and ShowMiscStats
792# parameters are set to 1 to make results appear in AWStats report page.
793# If you want to use another directory than /js/, you must also change the
794# awstatsmisctrackerurl variable into the awstats_misc_tracker.js file.
795# Change : Effective for new updates only.
796# Possible value: URL of javascript tracker file added in your HTML code.
797# Default: "/js/awstats_misc_tracker.js"
798#
799MiscTrackerUrl="/js/awstats_misc_tracker.js"
800
801
802
803#-----------------------------------------------------------------------------
804# OPTIONAL ACCURACY SETUP SECTION (Not required but increase AWStats features)
805#-----------------------------------------------------------------------------
806
807# The following values allow you to define accuracy of AWStats entities
808# (robots, browsers, os, referers, file types) detection.
809# It might be a good idea for large web sites or ISP that provides AWStats to
810# high number of customers, to set this parameter to 1 (or 0), instead of 2.
811# Possible values:
812#    0      = No detection,
813#    1      = Medium/Standard detection
814#    2      = Full detection
815# Change : Effective for new updates only
816# Note   : LevelForBrowsersDetection can also accept value "allphones". This
817#          enable detailed detection of phone/pda browsers.
818# Default: 2 (0 for LevelForWormsDetection)
819#
820LevelForBrowsersDetection=2         # 0 disables Browsers detection.
821                                    # 2 reduces AWStats speed by 2%
822                                    # allphones reduces AWStats speed by 5%
823LevelForOSDetection=2               # 0 disables OS detection.
824                                    # 2 reduces AWStats speed by 3%
825LevelForRefererAnalyze=2            # 0 disables Origin detection.
826                                    # 2 reduces AWStats speed by 14%
827LevelForRobotsDetection=2           # 0 disables Robots detection.
828                                    # 2 reduces AWStats speed by 2.5%
829LevelForSearchEnginesDetection=2    # 0 disables Search engines detection.
830                                    # 2 reduces AWStats speed by 9%
831LevelForKeywordsDetection=2         # 0 disables Keyphrases/Keywords detection.
832                                    # 2 reduces AWStats speed by 1%
833LevelForFileTypesDetection=2        # 0 disables File types detection.
834                                    # 2 reduces AWStats speed by 1%
835LevelForWormsDetection=0            # 0 disables Worms detection.
836                                    # 2 reduces AWStats speed by 15%
837
838#-----------------------------------------------------------------------------
839# OPTIONAL APPEARANCE SETUP SECTION (Not required but increase AWStats features)
840#-----------------------------------------------------------------------------
841
842# When you use AWStats as a CGI, you can have the reports shown in HTML frames.
843# Frames are only available for report viewed dynamically. When you build
844# pages from command line, this option is not used and no frames are built.
845# Possible values: 0 or 1
846# Default: 1
847#
848UseFramesWhenCGI=1
849
850
851# This parameter asks your browser to open detailed reports into a different
852# window than the main page.
853# Possible values:
854# 0 - Open all in same browser window
855# 1 - Open detailed reports in another window except if using frames
856# 2 - Open always in a different window even if reports are framed
857# Default: 1
858#
859DetailedReportsOnNewWindows=1
860
861
862# You can add, in the HTML report page, a cache lifetime (in seconds) that
863# will be returned to the browser in HTTP header answer by server.
864# This parameter is not used when reports are built with -staticlinks option.
865# Example: 3600
866# Default: 0
867#
868Expires=0
869
870
871# To avoid too large web pages, you can ask AWStats to limit number of rows of
872# all reported charts to this number when no other limits apply.
873# Default: 1000
874#
875MaxRowsInHTMLOutput=1000
876
877
878# Set your primary language (ISO-639-1 language codes).
879# Possible values:
880#  Albanian=al, Bosnian=ba, Bulgarian=bg, Catalan=ca,
881#  Chinese (Taiwan)=tw, Chinese (Simpliefied)=cn, Croatian=hr, Czech=cz,
882#  Danish=dk, Dutch=nl, English=en, Estonian=et, Euskara=eu, Finnish=fi,
883#  French=fr, Galician=gl, German=de, Greek=gr, Hebrew=he, Hungarian=hu,
884#  Icelandic=is, Indonesian=id, Italian=it, Japanese=jp, Korean=ko,
885#  Latvian=lv, Norwegian (Nynorsk)=nn, Norwegian (Bokmal)=nb, Polish=pl,
886#  Portuguese=pt, Portuguese (Brazilian)=br, Romanian=ro, Russian=ru,
887#  Serbian=sr, Slovak=sk, Slovenian=si, Spanish=es, Swedish=se, Turkish=tr,
888#  Ukrainian=ua, Welsh=cy.
889#  First available language accepted by browser=auto
890# Default: "auto"
891#
892Lang="auto"
893
894
895# Set the location of language files.
896# Example: "/usr/share/awstats/lang"
897# Default: "./lang" (means lang directory is in same location than awstats.pl)
898#
899DirLang="/usr/share/awstats/lang"
900
901# Show menu header with reports' links
902# Possible values: 0 or 1
903# Default: 1
904#
905ShowMenu=1
906
907
908# You choose here which reports you want to see in the main page and what you
909# want to see in those reports.
910# Possible values:
911#  0  - Report is not shown at all
912#  1  - Report is shown in main page with an entry in menu and default columns
913# XYZ - Report shows column informations defined by code X,Y,Z...
914#       X,Y,Z... are code letters among the following:
915#        U = Unique visitors
916#        V = Visits
917#        P = Number of pages
918#        H = Number of hits (or mails)
919#        B = Bandwith (or total mail size for mail logs)
920#        L = Last access date
921#        E = Entry pages
922#        X = Exit pages
923#        C = Web compression (mod_gzip,mod_deflate)
924#        M = Average mail size (mail logs)
925#
926
927# Show monthly summary
928# Context: Web, Streaming, Mail, Ftp
929# Default: UVPHB, Possible column codes: UVPHB
930ShowSummary=UVPHB
931
932# Show monthly chart
933# Context: Web, Streaming, Mail, Ftp
934# Default: UVPHB, Possible column codes: UVPHB
935ShowMonthStats=UVPHB
936
937# Show days of month chart
938# Context: Web, Streaming, Mail, Ftp
939# Default: VPHB, Possible column codes: VPHB
940ShowDaysOfMonthStats=VPHB
941
942# Show days of week chart
943# Context: Web, Streaming, Mail, Ftp
944# Default: PHB, Possible column codes: PHB
945ShowDaysOfWeekStats=PHB
946
947# Show hourly chart
948# Context: Web, Streaming, Mail, Ftp
949# Default: PHB, Possible column codes: PHB
950ShowHoursStats=PHB
951
952# Show domains/country chart
953# Context: Web, Streaming, Mail, Ftp
954# Default: PHB, Possible column codes: PHB
955ShowDomainsStats=PHB
956
957# Show hosts chart
958# Context: Web, Streaming, Mail, Ftp
959# Default: PHBL, Possible column codes: PHBL
960ShowHostsStats=PHBL
961
962# Show authenticated users chart
963# Context: Web, Streaming, Ftp
964# Default: 0, Possible column codes: PHBL
965ShowAuthenticatedUsers=0
966
967# Show robots chart
968# Context: Web, Streaming
969# Default: HBL, Possible column codes: HBL
970ShowRobotsStats=HBL
971
972# Show worms chart
973# Context: Web, Streaming
974# Default: 0 (If set to other than 0, see also LevelForWormsDetection), Possible column codes: HBL
975ShowWormsStats=0
976
977# Show email senders chart (For use when analyzing mail log files)
978# Context: Mail
979# Default: 0, Possible column codes: HBML
980ShowEMailSenders=0
981
982# Show email receivers chart (For use when analyzing mail log files)
983# Context: Mail
984# Default: 0, Possible column codes: HBML
985ShowEMailReceivers=0
986
987# Show session chart
988# Context: Web, Streaming, Ftp
989# Default: 1, Possible column codes: None
990ShowSessionsStats=1
991
992# Show pages-url chart.
993# Context: Web, Streaming, Ftp
994# Default: PBEX, Possible column codes: PBEX
995ShowPagesStats=PBEX
996
997# Show file types chart.
998# Context: Web, Streaming, Ftp
999# Default: HB, Possible column codes: HBC
1000ShowFileTypesStats=HB
1001
1002# Show file size chart (Not yet available)
1003# Context: Web, Streaming, Mail, Ftp
1004# Default: 1, Possible column codes: None
1005ShowFileSizesStats=0
1006
1007# Show operating systems chart
1008# Context: Web, Streaming, Ftp
1009# Default: 1, Possible column codes: None
1010ShowOSStats=1
1011
1012# Show browsers chart
1013# Context: Web, Streaming
1014# Default: 1, Possible column codes: None
1015ShowBrowsersStats=1
1016
1017# Show screen size chart
1018# Context: Web, Streaming
1019# Default: 0 (If set to 1, see also MiscTrackerUrl), Possible column codes: None
1020ShowScreenSizeStats=0
1021
1022# Show origin chart
1023# Context: Web, Streaming
1024# Default: PH, Possible column codes: PH
1025ShowOriginStats=PH
1026
1027# Show keyphrases chart
1028# Context: Web, Streaming
1029# Default: 1, Possible column codes: None
1030ShowKeyphrasesStats=1
1031
1032# Show keywords chart
1033# Context: Web, Streaming
1034# Default: 1, Possible column codes: None
1035ShowKeywordsStats=1
1036
1037# Show misc chart
1038# Context: Web, Streaming
1039# Default: a (See also MiscTrackerUrl parameter), Possible column codes: anjdfrqwp
1040ShowMiscStats=a
1041
1042# Show http errors chart
1043# Context: Web, Streaming
1044# Default: 1, Possible column codes: None
1045ShowHTTPErrorsStats=1
1046
1047# Show smtp errors chart (For use when analyzing mail log files)
1048# Context: Mail
1049# Default: 0, Possible column codes: None
1050ShowSMTPErrorsStats=0
1051
1052# Show the cluster report (Your LogFormat must contains the %cluster tag)
1053# Context: Web, Streaming, Ftp
1054# Default: 0, Possible column codes: PHB
1055ShowClusterStats=0
1056
1057
1058# Some graphical reports are followed by the data array of values.
1059# If you don't want this array (to reduce the report size for example), you
1060# can set thoose options to 0.
1061# Possible values: 0 or 1
1062# Default: 1
1063#
1064# Data array values for the ShowMonthStats report
1065AddDataArrayMonthStats=1
1066# Data array values for the ShowDaysOfMonthStats report
1067AddDataArrayShowDaysOfMonthStats=1
1068# Data array values for the ShowDaysOfWeekStats report
1069AddDataArrayShowDaysOfWeekStats=1
1070# Data array values for the ShowHoursStats report
1071AddDataArrayShowHoursStats=1
1072
1073
1074# In the Origin chart, you have stats on where your hits came from. You can
1075# include hits on pages that come from pages of same sites in this chart.
1076# Possible values: 0 or 1
1077# Default: 0
1078#
1079IncludeInternalLinksInOriginSection=0
1080
1081
1082# The following parameters can be used to choose the maximum number of lines
1083# shown for the particular following reports.
1084#
1085# Stats by countries/domains
1086MaxNbOfDomain = 10
1087MinHitDomain  = 1
1088# Stats by hosts
1089MaxNbOfHostsShown = 10
1090MinHitHost    = 1
1091# Stats by authenticated users
1092MaxNbOfLoginShown = 10
1093MinHitLogin   = 1
1094# Stats by robots
1095MaxNbOfRobotShown = 10
1096MinHitRobot   = 1
1097# Stats by pages
1098MaxNbOfPageShown = 10
1099MinHitFile    = 1
1100# Stats by OS
1101MaxNbOfOsShown = 10
1102MinHitOs      = 1
1103# Stats by browsers
1104MaxNbOfBrowsersShown = 10
1105MinHitBrowser = 1
1106# Stats by screen size
1107MaxNbOfScreenSizesShown = 5
1108MinHitScreenSize = 1
1109# Stats by window size (following 2 parameters are not yet used)
1110MaxNbOfWindowSizesShown = 5
1111MinHitWindowSize = 1
1112# Stats by referers
1113MaxNbOfRefererShown = 10
1114MinHitRefer   = 1
1115# Stats for keyphrases
1116MaxNbOfKeyphrasesShown = 10
1117MinHitKeyphrase = 1
1118# Stats for keywords
1119MaxNbOfKeywordsShown = 10
1120MinHitKeyword = 1
1121# Stats for sender or receiver emails
1122MaxNbOfEMailsShown = 20
1123MinHitEMail   = 1
1124
1125
1126# Choose if you want the week report to start on sunday or monday
1127# Possible values:
1128# 0 - Week starts on sunday
1129# 1 - Week starts on monday
1130# Default: 1
1131#
1132FirstDayOfWeek=1
1133
1134
1135# List of visible flags that link to other language translations.
1136# See Lang parameter for list of allowed flag/language codes.
1137# If you don't want any flag link, set ShowFlagLinks to "".
1138# This parameter is used only if ShowMenu parameter is set to 1.
1139# Possible values: "" or "language_codes_separated_by_space"
1140# Example: "en es fr nl de"
1141# Default: ""
1142#
1143ShowFlagLinks=""
1144
1145
1146# Each URL, shown in stats report views, are links you can click.
1147# Possible values: 0 or 1
1148# Default: 1
1149#
1150ShowLinksOnUrl=1
1151
1152# When AWStats builds HTML links in its report pages, it starts those links
1153# with "http://". However some links might be HTTPS links, so you can enter
1154# here the root of all your HTTPS links. If all your site is a SSL web site,
1155# just enter "/".
1156# This parameter is not used if ShowLinksOnUrl is 0.
1157# Example: "/shopping"
1158# Example: "/"
1159# Default: ""
1160#
1161UseHTTPSLinkForUrl=""
1162
1163
1164# Maximum length of URL part shown on stats page (number of characters).
1165# This affects only URL visible text, links still work.
1166# Default: 64
1167#
1168MaxLengthOfShownURL=64
1169
1170
1171# You can enter HTML code that will be added at the top of AWStats reports.
1172# Default: ""
1173#
1174HTMLHeadSection=""
1175
1176
1177# You can enter HTML code that will be added at the end of AWStats reports.
1178# Great to add advert ban.
1179# Default: ""
1180#
1181HTMLEndSection=""
1182
1183
1184# You can set Logo and LogoLink to use your own logo.
1185# Logo must be the name of image file (must be in $DirIcons/other directory).
1186# LogoLink is the expected URL when clicking on Logo.
1187# Default: "awstats_logo6.png"
1188#
1189Logo="awstats_logo6.png"
1190LogoLink="http://awstats.sourceforge.net"
1191
1192
1193# Value of maximum bar width/height for horizontal/vertical HTML graphics bars.
1194# Default: 260/90
1195#
1196BarWidth   = 260
1197BarHeight  = 90
1198
1199
1200# You can ask AWStats to use a particular CSS (Cascading Style Sheet) to
1201# change its look. To create a style sheet, you can use samples provided with
1202# AWStats in wwwroot/css directory.
1203# Example: "/awstatscss/awstats_bw.css"
1204# Example: "/css/awstats_bw.css"
1205# Default: ""
1206#
1207StyleSheet=""
1208
1209
1210# Those color parameters can be used (if StyleSheet parameter is not used)
1211# to change AWStats look.
1212# Example: color_name="RRGGBB"  # RRGGBB is Red Green Blue components in Hex
1213#
1214color_Background="FFFFFF"       # Background color for main page (Default = "FFFFFF")
1215color_TableBGTitle="CCCCDD"     # Background color for table title (Default = "CCCCDD")
1216color_TableTitle="000000"       # Table title font color (Default = "000000")
1217color_TableBG="CCCCDD"          # Background color for table (Default = "CCCCDD")
1218color_TableRowTitle="FFFFFF"    # Table row title font color (Default = "FFFFFF")
1219color_TableBGRowTitle="ECECEC"  # Background color for row title (Default = "ECECEC")
1220color_TableBorder="ECECEC"      # Table border color (Default = "ECECEC")
1221color_text="000000"             # Color of text (Default = "000000")
1222color_textpercent="606060"      # Color of text for percent values (Default = "606060")
1223color_titletext="000000"        # Color of text title within colored Title Rows (Default = "000000")
1224color_weekend="EAEAEA"          # Color for week-end days (Default = "EAEAEA")
1225color_link="0011BB"             # Color of HTML links (Default = "0011BB")
1226color_hover="605040"            # Color of HTML on-mouseover links (Default = "605040")
1227color_u="FFAA66"                # Background color for number of unique visitors (Default = "FFAA66")
1228color_v="F4F090"                # Background color for number of visites (Default = "F4F090")
1229color_p="4477DD"                # Background color for number of pages (Default = "4477DD")
1230color_h="66DDEE"                # Background color for number of hits (Default = "66DDEE")
1231color_k="2EA495"                # Background color for number of bytes (Default = "2EA495")
1232color_s="8888DD"                # Background color for number of search (Default = "8888DD")
1233color_e="CEC2E8"                # Background color for number of entry pages (Default = "CEC2E8")
1234color_x="C1B2E2"                # Background color for number of exit pages (Default = "C1B2E2")
1235
1236
1237
1238#-----------------------------------------------------------------------------
1239# PLUGINS
1240#-----------------------------------------------------------------------------
1241
1242# Add here all plugin files you want to load.
1243# Plugin files must be .pm files stored in 'plugins' directory.
1244# Uncomment LoadPlugin lines to enable a plugin after checking that perl
1245# modules required by the plugin are installed.
1246
1247# Plugin: Tooltips
1248# Perl modules required: None
1249# Add some tooltips help on HTML report pages.
1250# Note that enabling this kind of help will increased HTML report pages size,
1251# so server load and bandwidth.
1252#
1253#LoadPlugin="tooltips"
1254
1255# Plugin: DecodeUTFKeys
1256# Perl modules required: Encode and URI::Escape
1257# Allow AWStats to show correctly (in language charset) keywords/keyphrases
1258# strings even if they were UTF8 coded by the referer search engine.
1259#
1260#LoadPlugin="decodeutfkeys"
1261
1262# Plugin: IPv6
1263# Perl modules required: Net::IP and Net::DNS
1264# This plugin gives AWStats capability to make reverse DNS lookup on IPv6
1265# addresses.
1266# Note: If you are interested in having country report, you should use the
1267# geoip or geoipfree plugin instead of enabled reverse DNS lookup.
1268#
1269#LoadPlugin="ipv6"
1270
1271# Plugin: HashFiles
1272# Perl modules required: Storable
1273# AWStats DNS cache files are read/saved as native hash files. This increases
1274# DNS cache files loading speed, above all for very large web sites.
1275#
1276LoadPlugin="hashfiles"
1277
1278# Plugin: GeoIP
1279# Perl modules required: Geo::IP or Geo::IP::PurePerl (from Maxmind)
1280# Country chart is built from an Internet IP-Country database.
1281# This plugin is useless for intranet only log files.
1282# Note: You must choose between using this plugin (need Perl Geo::IP module
1283# from Maxmind, database is free and up to date) or the GeoIPfree plugin
1284# (need Perl Geo::IPfree module, database is free but not up to date).
1285# There is two versions of Maxmind Country Database:
1286# You can get a free version or purchase a license from Maxmind to get/use a more
1287# accurate version including updates (http://www.maxmind.com/app/perl?rId=awstat)
1288# This plugin reduces AWStats speed of 8% !
1289#
1290#LoadPlugin="geoip GEOIP_STANDARD /usr/share/GeoIP/GeoIP.dat"
1291
1292# Plugin: GeoIPfree
1293# Perl modules required: Geo::IPfree version 0.2+ (from Graciliano M.P.)
1294# Country chart is built from an Internet IP-Country database.
1295# This plugin is useless for intranet only log files.
1296# Note: You must choose between using this plugin (need Perl Geo::IPfree
1297# module, database is free but not up to date) or the GeoIP plugin (need
1298# Perl Geo::IP module from Maxmind, database is also free and up to date).
1299# Note: Activestate provide a corrupted version of Geo::IPfree 0.2 Perl
1300# module, so install it from elsewhere (from www.cpan.org for example).
1301# This plugin reduces AWStats speed of 10% !
1302#
1303#LoadPlugin="geoipfree"
1304
1305# Plugin: GeoIP_Region_Maxmind
1306# Perl modules required: Geo::IP (from Maxmind)
1307# This plugin add a chart of hits by regions. Only regions for US and
1308# Canada can be detected.
1309# Note: This plugin need Maxmind GeoIP Perl module AND the region database.
1310# Note: I get some problem with Maxmind Geo::IP Perl module with ActiveState
1311# on Windows but it works great on Linux with default Perl.
1312# You need to purchase a license from Maxmind to get/use the Region database.
1313# This plugin reduces AWStats speed.
1314#
1315#LoadPlugin="geoip_region_maxmind GEOIP_STANDARD /pathto/GeoIPRegion.dat"
1316
1317# Plugin: GeoIP_City_Maxmind
1318# Perl modules required: Geo::IP (from Maxmind)
1319# This plugin add a chart of hits by cities (with country and regions
1320# informations for major countries).
1321# Note: This plugin need Maxmind GeoIP Perl module AND the city database.
1322# Note: I get some problem with Maxmind Geo::IP Perl module with ActiveState
1323# on Windows but it works great on Linux with default Perl.
1324# There is two versions of Maxmind City Database:
1325# You can get a free version or purchase a license from Maxmind to get/use a more
1326# accurate version including updates (http://www.maxmind.com/app/perl?rId=awstat)
1327# This plugin reduces AWStats speed.
1328#
1329#LoadPlugin="geoip_city_maxmind GEOIP_STANDARD /usr/share/GeoIP/GeoIPCity.dat"
1330
1331# Plugin: GeoIP_ISP_Maxmind
1332# Perl modules required: Geo::IP (from Maxmind)
1333# This plugin add a chart of hits by ISP.
1334# Note: This plugin need Maxmind GeoIP Perl module AND the ISP database.
1335# Note: I get some problem with Maxmind Geo::IP Perl module with ActiveState
1336# on Windows but it works great on Linux with default Perl.
1337# You need to purchase a license from Maxmind to get/use the ISP database.
1338# This plugin reduces AWStats speed.
1339#
1340#LoadPlugin="geoip_isp_maxmind GEOIP_STANDARD /pathto/GeoIPISP.dat"
1341
1342# Plugin: GeoIP_Org_Maxmind
1343# Perl modules required: Geo::IP (from Maxmind)
1344# This plugin add a chart of hits by Organization name
1345# Note: This plugin need Maxmind GeoIP Perl module AND the Org database.
1346# Note: I get some problem with Maxmind Geo::IP Perl module with ActiveState
1347# on Windows but it works great on Linux with default Perl.
1348# You need to purchase a license from Maxmind to get/use the Org database.
1349# This plugin reduces AWStats speed.
1350#
1351#LoadPlugin="geoip_org_maxmind GEOIP_STANDARD /pathto/GeoIPOrg.dat"
1352
1353# Plugin: UserInfo
1354# Perl modules required: None
1355# Add a text (Firtname, Lastname, Office Department, ...) in authenticated user
1356# reports for each login value.
1357# A text file called userinfo.myconfig.txt, with two fields (first is login,
1358# second is text to show, separated by a tab char) must be created in DirData
1359# directory.
1360#
1361#LoadPlugin="userinfo"
1362
1363# Plugin: HostInfo
1364# Perl modules required: Net::XWhois
1365# Add a column into host chart with a link to open a popup window that shows
1366# info on host (like whois records).
1367#
1368#LoadPlugin="hostinfo"
1369
1370# Plugin: ClusterInfo
1371# Perl modules required: None
1372# Add a text (for example a full hostname) in cluster reports for each cluster
1373# number.
1374# A text file called clusterinfo.myconfig.txt, with two fields (first is
1375# cluster number, second is text to show) separated by a tab char. must be
1376# created into DirData directory.
1377# Note this plugin is useless if ShowClusterStats is set to 0 or if you don't
1378# use a personalized log format that contains %cluster tag.
1379#
1380#LoadPlugin="clusterinfo"
1381
1382# Plugin: UrlAliases
1383# Perl modules required: None
1384# Add a text (Page title, description...) in URL reports before URL value.
1385# A text file called urlalias.myconfig.txt, with two fields (first is URL,
1386# second is text to show, separated by a tab char) must be created into
1387# DirData directory.
1388#
1389#LoadPlugin="urlalias"
1390
1391# Plugin: TimeHiRes
1392# Perl modules required: Time::HiRes (if Perl < 5.8)
1393# Time reported by -showsteps option is in millisecond. For debug purpose.
1394#
1395#LoadPlugin="timehires"     
1396
1397# Plugin: TimeZone
1398# Perl modules required: Time::Local
1399# Allow AWStats to correct a bad timezone for user of some IIS that use
1400# GMT date in its log instead of local server time.
1401# This module is useless for Apache and most IIS version.
1402# This plugin reduces AWStats speed of 40% !!!!!!!
1403#
1404#LoadPlugin="timezone +2"
1405
1406# Plugin: Rawlog
1407# Perl modules required: None
1408# This plugin adds a form in AWStats main page to allow users to see raw
1409# content of current log files. A filter is also available.
1410#
1411#LoadPlugin="rawlog"
1412
1413# Plugin: GraphApplet
1414# Perl modules required: None
1415# Supported charts are built by a 3D graphic applet.
1416#
1417#LoadPlugin="graphapplet /awstatsclasses"               # EXPERIMENTAL FEATURE
1418
1419
1420
1421#-----------------------------------------------------------------------------
1422# EXTRA SECTIONS
1423#-----------------------------------------------------------------------------
1424
1425# You can define your own charts, you choose here what are rows and columns
1426# keys. This feature is particularly useful for marketing purpose, tracking
1427# products orders for example.
1428# For this, edit all parameters of Extra section. Each set of parameter is a
1429# different chart. For several charts, duplicate section changing the number.
1430# Note: Each Extra section reduces AWStats speed by 8%.
1431#
1432# WARNING: A wrong setup of Extra section might result in too large arrays
1433# that will consume all your memory, making AWStats unusable after several
1434# updates, so be sure to setup it correctly.
1435# In most cases, you don't need this feature.
1436#
1437# ExtraSectionNameX is title of your personalized chart.
1438# ExtraSectionCodeFilterX is list of codes the record code field must match.
1439#   Put an empty string for no test on code.
1440# ExtraSectionConditionX are conditions you can use to count or not the hit,
1441#   Use one of the field condition
1442#   (URL,URLWITHQUERY,QUERY_STRING,REFERER,UA,HOSTINLOG,HOST,VHOST,extraX)
1443#   and a regex to match, after a coma. Use "||" for "OR".
1444# ExtraSectionFirstColumnTitleX is the first column title of the chart.
1445# ExtraSectionFirstColumnValuesX is a string to tell AWStats which field to
1446#   extract value from
1447#   (URL,URLWITHQUERY,QUERY_STRING,REFERER,UA,HOSTINLOG,HOST,VHOST,extraX)
1448#   and how to extract the value (using regex syntax). Each different value
1449#   found will appear in first column of report on a different row. Be sure
1450#   that list of different possible values will not grow indefinitely.
1451# ExtraSectionFirstColumnFormatX is the string used to write value.
1452# ExtraSectionStatTypesX are things you want to count. You can use standard
1453#   code letters (P for pages,H for hits,B for bandwidth,L for last access).
1454# ExtraSectionAddAverageRowX add a row at bottom of chart with average values.
1455# ExtraSectionAddSumRowX add a row at bottom of chart with sum values.
1456# MaxNbOfExtraX is maximum number of rows shown in chart.
1457# MinHitExtraX is minimum number of hits required to be shown in chart.
1458#
1459
1460# Example to report the 20 products the most ordered by "order.cgi" script
1461#ExtraSectionName1="Product orders"
1462#ExtraSectionCodeFilter1="200 304"
1463#ExtraSectionCondition1="URL,\/cgi\-bin\/order\.cgi||URL,\/cgi\-bin\/order2\.cgi"
1464#ExtraSectionFirstColumnTitle1="Product ID"
1465#ExtraSectionFirstColumnValues1="QUERY_STRING,productid=([^&]+)"
1466#ExtraSectionFirstColumnFormat1="%s"
1467#ExtraSectionStatTypes1=PL
1468#ExtraSectionAddAverageRow1=0
1469#ExtraSectionAddSumRow1=1
1470#MaxNbOfExtra1=20
1471#MinHitExtra1=1
1472
1473# There is also a global parameter ExtraTrackedRowsLimit that limits the
1474# number of possible rows an ExtraSection can report. This parameter is
1475# here to protect too much memory use when you make a bad setup in your
1476# ExtraSection. It applies to all ExtraSection independently meaning that
1477# none ExtraSection can report more rows than value defined by ExtraTrackedRowsLimit.
1478# If you know an ExtraSection will report more rows than its value, you should
1479# increase this parameter or AWStats will stop with an error.
1480# Example: 2000
1481# Default: 500
1482#
1483ExtraTrackedRowsLimit=500
1484
1485
1486#-----------------------------------------------------------------------------
1487# INCLUDES
1488#-----------------------------------------------------------------------------
1489
1490# You can include other config files using the directive with the name of the
1491# config file.
1492# This is particularly useful for users who have a lot of virtual servers, so
1493# a lot of config files and want to maintain common values in only one file.
1494# Note that when a variable is defined both in a config file and in an
1495# included file, AWStats will use the last value read for parameters that
1496# contains one value and AWStats will concat all values from both files for
1497# parameters that are lists of values.
1498#
1499
1500Include "/etc/awstats/awstats.conf.local"