Annotation of ports/www/awstats/files/awstats.localhost.conf, Revision 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