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