~ubuntu-branches/ubuntu/dapper/awstats/dapper

« back to all changes in this revision

Viewing changes to wwwroot/cgi-bin/awstats.model.conf

  • Committer: Bazaar Package Importer
  • Author(s): Jonas Smedegaard
  • Date: 2005-02-05 17:13:48 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20050205171348-h8uy32bhbcnhciie
Tags: 6.3-1
* New upstream release. Closes: bug#293702, #293668 (thanks to Nelson
  A. de Oliveira <naoliv@biolinux.df.ibilce.unesp.br>).
  + Includes upstream fix for security bug fixed in 6.2-1.1.
  + Includes upstream fix for most of security bug fixed in 6.2-1.1.
* Acknowledge NMUs. Closes: bug#291064, #294488 (thanks to Martin
  Schulze <joey@infodrom.org>, Martin Pitt <mpitt@debian.org>, Ubuntu,
  Joey Hess <joeyh@debian.org>, Frank Lichtenheld <djpig@debian.org> and Steve
  Langasek <vorlon@debian.org>).
* Include patch for last parts of security bug fixed in 6.2-1.1:
  01_sanitize_more.patch.
* Patch (02) to include snapshot of recent development:
  + Fix security hole that allowed a user to read log file content
    even when plugin rawlog was not enabled.
  + Fix a possible use of AWStats for a DoS attack.
  + configdir option was broken on windows servers.
  + DebugMessages is by default set to 0 for security reasons.
  + Minor fixes.
* References:
  CAN-2005-0435 - read server logs via loadplugin and pluginmode
  CAN-2005-0436 - code injection via PluginMode
  CAN-2005-0437 - directory traversal via loadplugin
  CAN-2005-0438 - information leak via debug

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# AWSTATS CONFIGURE FILE 6.0
 
1
# AWSTATS CONFIGURE FILE 6.3
2
2
#-----------------------------------------------------------------------------
3
3
# Copy this file into awstats.www.mydomain.conf and edit this new config file
4
4
# to setup AWStats (See documentation in docs/ directory).
10
10
# Note that environment variable AWSTATS_CURRENT_CONFIG is always defined with
11
11
# the config value in an AWStats running session and can be used like others.
12
12
#-----------------------------------------------------------------------------
13
 
# $Revision: 1.271 $ - $Author: eldy $ - $Date: 2004/01/25 15:35:11 $
 
13
# $Revision: 1.305 $ - $Author: eldy $ - $Date: 2005/01/22 15:26:06 $
14
14
 
15
15
 
16
16
 
64
64
 
65
65
 
66
66
# Enter here your log format (Must match your web server config. See setup
67
 
# instructions in documentation know how to configure your web server to have
68
 
# the required log format).
69
 
# Possible values: 1,2,3,4,5 or "your_own_personalized_log_format"
 
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
70
# 1 - Apache or Lotus Notes/Domino native combined log format (NCSA combined/XLF/ELF log format)
71
71
# 2 - Old IIS log format (IIS W3C log format). See FAQ for IIS 6.x.
72
72
# 3 - Webstar native log format.
76
76
#     you must use following keys to define the log format string (See FAQ
77
77
#     for ftp, mail or exotic web log format examples):
78
78
#   %host             Host client name or IP address
79
 
#   %lognamequot      Authenticated login/user with format: "alex"
80
 
#   %logname          Authenticated login/user with format: alex
81
 
#   %time1            Date and time with format: [dd/mmm/yyyy:hh:mm:ss +0000] or [dd/mmm/yyyy:hh:mm:ss]
 
79
#   %lognamequot      Authenticated login/user with format: "john"
 
80
#   %logname          Authenticated login/user with format: john
 
81
#   %time1            Date and time with format: [dd/mon/yyyy:hh:mm:ss +0000] or [dd/mon/yyyy:hh:mm:ss]
82
82
#   %time2            Date and time with format: yyyy-mm-dd hh:mm:ss
83
 
#   %time3            Date and time with format: Mon dd hh:mm:ss
 
83
#   %time3            Date and time with format: Mon dd hh:mm:ss or Mon dd hh:mm:ss yyyy
 
84
#   %time4            Date and time with unix timestamp format: dddddddddd
84
85
#   %methodurl        Method and URL with format: "GET /index.html HTTP/x.x"
85
86
#   %methodurlnoprot  Method and URL with format: "GET /index.html"
86
87
#   %method           Method with format: GET
102
103
#                     contains data of several virtual web servers. AWStats
103
104
#                     will discard records not in SiteDomain nor HostAliases
104
105
#   %cluster          If log file is provided from several computers (merged by
105
 
#                     logresolvemerge.pl), this tag define field of cluster id.
 
106
#                     logresolvemerge.pl), use this to define cluster id field.
 
107
#   %extraX           Another field that you plan to use for building a
 
108
#                     personalized report with ExtraSection feature (See later).
106
109
#   If your log format has some fields not included in this list, use:
107
 
#   %other            Means another field not used
 
110
#   %other            Means another not used field
 
111
#   %otherquot        Means another not used double quoted field
108
112
#
109
113
# Examples for Apache combined logs (following two examples are equivalent):
110
114
# LogFormat = 1
114
118
 
115
119
 
116
120
# If your log field's separator is not a space, you can change this parameter.
117
 
# This parameter is not used if LogFormat is a predefined value (1,2,3,4,5,6)
 
121
# This parameter is not used if LogFormat is a predefined value (1,2,3,4)
 
122
# Backslash can be used as escape character.
118
123
# Example: " "
119
124
# Example: "\t"
120
 
# Example: "|"
 
125
# Example: "\|"
121
126
# Default: " "
122
127
#
123
128
LogSeparator=" "
151
156
# another site.
152
157
# Note: Use space between each value.
153
158
# Note: You can use regular expression values writing value with REGEX[value].
 
159
# Note: You can also use @/mypath/myfile if list of aliases are in a file.
154
160
# Example: "www.myserver.com localhost 127.0.0.1 REGEX[mydomain\.(net|org)$]"
155
161
#
156
162
HostAliases="localhost 127.0.0.1 REGEX[myserver\.com$]"
203
209
# Relative or absolute web URL of your awstats icon directory.
204
210
# If you build static reports ("... -output > outputpath/output.html"), enter
205
211
# path of icon directory relative to the output directory 'outputpath'.
206
 
# Example: "/awstatsicon"
 
212
# Example: "/awstatsicons"
207
213
# Example: "../icon"
208
214
# Default: "/icon" (means you must copy icon directories in "/mywwwroot/icon")
209
215
#
349
355
CreateDirDataIfNotExists=0
350
356
 
351
357
 
352
 
# If you can choose in which format tha awstats history database is saved.
353
 
# For the moment, only text is supported.
354
 
# Possible values: text
 
358
# You can choose in which format the Awstats history database is saved.
 
359
# Note: Using "xml" format make AWStats building database files three times
 
360
# larger than using "text" format.
 
361
# Change : Database format is switched after next update
 
362
# Possible values: text or xml
355
363
# Default: text
356
364
#
357
365
BuildHistoryFormat=text
358
366
 
359
367
 
360
368
# If you prefer having the report output pages be built as XML compliant pages
361
 
# instead of simple HTML pages, you can set this to 'xml' (May not works
362
 
# properly with some browsers).
363
 
# Possible values: html or xml
 
369
# instead of simple HTML pages, you can set this to 'xhtml' (May not works
 
370
# properly with old browsers).
 
371
# Change : Effective immediatly
 
372
# Possible values: html or xhtml
364
373
# Default: html
365
374
#
366
375
BuildReportFormat=html
367
376
 
368
377
 
369
 
# In most case, AWStats is used as a cgi program. So AWStats process is ran
370
 
# by default web server user (nobody for Unix, IUSR_xxx for IIS/Windows,...).
371
 
# To make use easier and avoid permission's problems between update process 
372
 
# (run by an admin user) and CGI process (ran by a low level user), AWStats
373
 
# save its database files with read and write for everyone.
374
 
# If you have experience on managing security policies (Web Hosting Provider),
375
 
# you should set this parameter to 0. AWStats will keep default process user
376
 
# permissions on its files.
 
378
# AWStats databases can be updated from command line of from a browser (when
 
379
# used as a cgi program). So AWStats database files need write permission
 
380
# for both command line user and default web server user (nobody for Unix,
 
381
# IUSR_xxx for IIS/Windows,...).
 
382
# To avoid permission's problems between update process (run by an admin user)
 
383
# and CGI process (ran by a low level user), AWStats can save its database 
 
384
# files with read and write permissions for everyone.
 
385
# By default, AWStats keep default user permissions on updated files. If you 
 
386
# set AllowToUpdateStatsFromBrowser to 1, you can change this parameter to 1.
377
387
# Change : Effective for new updates only
378
388
# Possible values: 0 or 1
379
 
# Default: 1
 
389
# Default: 0
380
390
#
381
 
SaveDatabaseFilesWithPermissionsForEveryone=1
 
391
SaveDatabaseFilesWithPermissionsForEveryone=0
382
392
 
383
393
 
384
394
# AWStats can purge log file, after analyzing it. Note that AWStats is able
466
476
# For example, to ignore /badpage.html, just add "/badpage.html". To ignore
467
477
# all pages in a particular directory, add "REGEX[^\/directorytoexclude]".
468
478
# The opposite parameter of "SkipFiles" is "OnlyFiles".
469
 
# Note: Use space between each value. This parameter is not case sensitive.
 
479
# Note: Use space between each value. This parameter is or not case sensitive
 
480
# depending on URLNotCaseSensitive parameter.
470
481
# Note: You can use regular expression values writing value with REGEX[value].
471
482
# Change : Effective for new updates only
472
483
# Example: "/badpage.html REGEX[^\/excludedirectory]"
510
521
# match a particular string, like a particular directory, you can add this
511
522
# directory name in this parameter.
512
523
# The opposite parameter of "OnlyFiles" is "SkipFiles".
513
 
# Note: Use space between each value. This parameter is not case sensitive.
 
524
# Note: Use space between each value. This parameter is or not case sensitive
 
525
# depending on URLNotCaseSensitive parameter.
514
526
# Note: You can use regular expression values writing value with REGEX[value].
515
527
# Change : Effective for new updates only
516
528
# Example: "REGEX[marketing_directory] REGEX[office\/.*\.(csv|sxw)$]"
531
543
# Example: ""
532
544
# Default: "css js class gif jpg jpeg png bmp ico"
533
545
#
534
 
NotPageList="css js class gif jpg jpeg png bmp ico"
 
546
NotPageList="css js class gif jpg jpeg png bmp ico swf"
535
547
 
536
548
 
537
549
# By default, AWStats considers that records found in web log file are
729
741
 
730
742
 
731
743
# MiscTrackerUrl can be used to make AWStats able to detect some miscellanous
732
 
# things, that can not be tracked on other way like:
 
744
# things, that can not be tracked on other way, like:
 
745
# - Javascript disabled
 
746
# - Java enabled
733
747
# - Screen size
734
748
# - Color depth
735
 
# - Java enabled
736
749
# - Macromedia Director plugin
737
750
# - Macromedia Shockwave plugin
738
751
# - Realplayer G2 plugin
741
754
# - Acrobat PDF plugin
742
755
# To enable all this features, you must copy the awstats_misc_tracker.js file
743
756
# into a /js/ directory stored in your web document root and add the following
744
 
# HTML code at the end of your index page (before </BODY>) :
 
757
# HTML code at the end of your index page (but before </BODY>) :
 
758
#
745
759
# <script language=javascript src="/js/awstats_misc_tracker.js"></script>
746
 
# If code is not added in index page, all this detection capabilities will be
 
760
# <noscript><img src="/js/awstats_misc_tracker.js?nojs=y" height=0 width=0 border=0 style="display: none"></noscript>
 
761
#
 
762
# If code is not added in index page, all those detection capabilities will be
747
763
# disabled. You must also check that ShowScreenSizeStats and ShowMiscStats
748
 
# parameters are set to 1 to make results appear in report page.
 
764
# parameters are set to 1 to make results appear in AWStats report page.
749
765
# If you want to use another directory than /js/, you must also change the
750
766
# awstatsmisctrackerurl variable into the awstats_misc_tracker.js file.
751
767
# Change : Effective for new updates only.
752
 
# Possible value: Full URL of javascript tracker file added in HTML code
 
768
# Possible value: URL of javascript tracker file added in your HTML code.
753
769
# Default: "/js/awstats_misc_tracker.js"
754
770
#
755
771
MiscTrackerUrl="/js/awstats_misc_tracker.js"
771
787
# Change : Effective for new updates only
772
788
# Default: 2 (0 for LevelForWormsDetection)
773
789
#
774
 
LevelForBrowsersDetection=2         # 0 disables Browsers detection.
 
790
LevelForBrowsersDetection=2         # 0 disables Browsers detection.
775
791
                                    # 2 reduces AWStats speed by 2%
776
792
LevelForOSDetection=2               # 0 disables OS detection.
777
793
                                    # 2 reduces AWStats speed by 3%
830
846
MaxRowsInHTMLOutput=1000
831
847
 
832
848
 
833
 
# Set your primary language.
 
849
# Set your primary language (ISO-639-1 language codes).
834
850
# Possible value:
835
851
#  Albanian=al, Bosnian=ba, Bulgarian=bg, Catalan=ca,
836
852
#  Chinese (Taiwan)=tw, Chinese (Simpliefied)=cn, Czech=cz, Danish=dk,
839
855
#  Icelandic=is, Indonesian=id, Italian=it, Japanese=jp, Korean=kr,
840
856
#  Latvian=lv, Norwegian (Nynorsk)=nn, Norwegian (Bokmal)=nb, Polish=pl,
841
857
#  Portuguese=pt, Portuguese (Brazilian)=br, Romanian=ro, Russian=ru,
842
 
#  Serbian=sr, Slovak=sk,  Spanish=es, Swedish=se, Turkish=tr, Ukrainian=ua,
843
 
#  Welsh=wlk.
 
858
#  Serbian=sr, Slovak=sk, Slovenian=si, Spanish=es, Swedish=se, Turkish=tr,
 
859
#  Ukrainian=ua, Welsh=cy.
844
860
#  First available language accepted by browser=auto
845
861
# Default: "auto"
846
862
#
854
870
DirLang="./lang"
855
871
 
856
872
 
 
873
# Show menu header with reports' links
 
874
# Possible values: 0 or 1
 
875
# Default: 1
 
876
#
 
877
ShowMenu=1                                      
 
878
 
 
879
 
857
880
# You choose here which reports you want to see in the main page and what you
858
881
# want to see in those reports.
859
882
# Possible values:
860
 
#  0  - Topic is not shown at all
861
 
#  1  - Report is shown with default informations
862
 
# XYZ - Report is shown with only informations defined by code X,Y,Z...
 
883
#  0  - Report is not shown at all
 
884
#  1  - Report is shown in main page with an entry in menu and default columns
 
885
# XYZ - Report shows column informations defined by code X,Y,Z...
863
886
#       X,Y,Z... are code letters among the following:
864
887
#        U = Unique visitors
865
888
#        V = Visits
872
895
#        C = Web compression (mod_gzip,mod_deflate)
873
896
#        M = Average mail size (mail logs)
874
897
#
875
 
# Show menu header with report links
876
 
# Default: 1, Possible codes: None
877
 
ShowMenu=1                                      
 
898
 
878
899
# Show monthly chart
879
 
# Default: UVPHB, Possible codes: UVPHB
 
900
# Context: Web, Streaming, Mail, Ftp
 
901
# Default: UVPHB, Possible column codes: UVPHB
880
902
ShowMonthStats=UVPHB
 
903
 
881
904
# Show days of month chart
882
 
# Default: VPHB, Possible codes: VPHB
 
905
# Context: Web, Streaming, Mail, Ftp
 
906
# Default: VPHB, Possible column codes: VPHB
883
907
ShowDaysOfMonthStats=VPHB
 
908
 
884
909
# Show days of week chart
885
 
# Default: PHB, Possible codes: PHB
 
910
# Context: Web, Streaming, Mail, Ftp
 
911
# Default: PHB, Possible column codes: PHB
886
912
ShowDaysOfWeekStats=PHB
 
913
 
887
914
# Show hourly chart
888
 
# Default: PHB, Possible codes: PHB
 
915
# Context: Web, Streaming, Mail, Ftp
 
916
# Default: PHB, Possible column codes: PHB
889
917
ShowHoursStats=PHB
 
918
 
890
919
# Show domains/country chart
891
 
# Default: PHB, Possible codes: PHB
 
920
# Context: Web, Streaming, Mail, Ftp
 
921
# Default: PHB, Possible column codes: PHB
892
922
ShowDomainsStats=PHB
 
923
 
893
924
# Show hosts chart
894
 
# Default: PHBL, Possible codes: PHBL
 
925
# Context: Web, Streaming, Mail, Ftp
 
926
# Default: PHBL, Possible column codes: PHBL
895
927
ShowHostsStats=PHBL
 
928
 
896
929
# Show authenticated users chart
897
 
# Default: 0, Possible codes: PHBL
 
930
# Context: Web, Streaming, Ftp
 
931
# Default: 0, Possible column codes: PHBL
898
932
ShowAuthenticatedUsers=0
 
933
 
899
934
# Show robots chart
900
 
# Default: HBL, Possible codes: HBL
 
935
# Context: Web, Streaming
 
936
# Default: HBL, Possible column codes: HBL
901
937
ShowRobotsStats=HBL
902
 
# Show worms chart
903
 
# Default: 0 (If set to 1, see also LevelForWormsDetection), Possible codes: HBL
904
 
ShowWormsStats=0
 
938
 
 
939
# Show worms chart
 
940
# Context: Web, Streaming
 
941
# Default: 0 (If set to 1, see also LevelForWormsDetection), Possible column codes: HBL
 
942
ShowWormsStats=0
 
943
 
905
944
# Show email senders chart (For use when analyzing mail log files)
906
 
# Default: 0, Possible codes: HBML
 
945
# Context: Mail
 
946
# Default: 0, Possible column codes: HBML
907
947
ShowEMailSenders=0
 
948
 
908
949
# Show email receivers chart (For use when analyzing mail log files)
909
 
# Default: 0, Possible codes: HBML
 
950
# Context: Mail
 
951
# Default: 0, Possible column codes: HBML
910
952
ShowEMailReceivers=0
 
953
 
911
954
# Show session chart
912
 
# Default: 1, Possible codes: None
 
955
# Context: Web, Streaming, Ftp
 
956
# Default: 1, Possible column codes: None
913
957
ShowSessionsStats=1
 
958
 
914
959
# Show pages-url chart.
915
 
# Default: PBEX, Possible codes: PBEX
 
960
# Context: Web, Streaming, Ftp
 
961
# Default: PBEX, Possible column codes: PBEX
916
962
ShowPagesStats=PBEX
 
963
 
917
964
# Show file types chart.
918
 
# Default: HB, Possible codes: HBC
 
965
# Context: Web, Streaming, Ftp
 
966
# Default: HB, Possible column codes: HBC
919
967
ShowFileTypesStats=HB
 
968
 
920
969
# Show file size chart (Not yet available)
921
 
# Default: 1, Possible codes: None
 
970
# Context: Web, Streaming, Mail, Ftp
 
971
# Default: 1, Possible column codes: None
922
972
ShowFileSizesStats=0            
 
973
 
923
974
# Show operating systems chart
924
 
# Default: 1, Possible codes: None
 
975
# Context: Web, Streaming, Ftp
 
976
# Default: 1, Possible column codes: None
925
977
ShowOSStats=1
 
978
 
926
979
# Show browsers chart
927
 
# Default: 1, Possible codes: None
 
980
# Context: Web, Streaming
 
981
# Default: 1, Possible column codes: None
928
982
ShowBrowsersStats=1
 
983
 
929
984
# Show screen size chart
930
 
# Default: 0 (If set to 1, see also MiscTrackerUrl), Possible codes: None
 
985
# Context: Web, Streaming
 
986
# Default: 0 (If set to 1, see also MiscTrackerUrl), Possible column codes: None
931
987
ShowScreenSizeStats=0
 
988
 
932
989
# Show origin chart
933
 
# Default: PH, Possible codes: PH
 
990
# Context: Web, Streaming
 
991
# Default: PH, Possible column codes: PH
934
992
ShowOriginStats=PH
 
993
 
935
994
# Show keyphrases chart
936
 
# Default: 1, Possible codes: None
 
995
# Context: Web, Streaming
 
996
# Default: 1, Possible column codes: None
937
997
ShowKeyphrasesStats=1
 
998
 
938
999
# Show keywords chart
939
 
# Default: 1, Possible codes: None
 
1000
# Context: Web, Streaming
 
1001
# Default: 1, Possible column codes: None
940
1002
ShowKeywordsStats=1
 
1003
 
941
1004
# Show misc chart
942
 
# Default: a (See also MiscTrackerUrl parameter), Possible codes: ajdfrqwp
 
1005
# Context: Web, Streaming
 
1006
# Default: a (See also MiscTrackerUrl parameter), Possible column codes: anjdfrqwp
943
1007
ShowMiscStats=a
 
1008
 
944
1009
# Show http errors chart
945
 
# Default: 1, Possible codes: None
 
1010
# Context: Web, Streaming
 
1011
# Default: 1, Possible column codes: None
946
1012
ShowHTTPErrorsStats=1
 
1013
 
947
1014
# Show smtp errors chart (For use when analyzing mail log files)
948
 
# Default: 0, Possible codes: None
 
1015
# Context: Mail
 
1016
# Default: 0, Possible column codes: None
949
1017
ShowSMTPErrorsStats=0
 
1018
 
950
1019
# Show the cluster report (Your LogFormat must contains the %cluster tag)
951
 
# Default: 0, Possible codes: PHB
 
1020
# Context: Web, Streaming, Ftp
 
1021
# Default: 0, Possible column codes: PHB
952
1022
ShowClusterStats=0
953
1023
 
954
1024
 
968
1038
AddDataArrayShowHoursStats=1
969
1039
 
970
1040
 
 
1041
# In the Origin chart, you have stats on where your hits came from. You can
 
1042
# includes hits on pages that comes from pages of same sites in this chart.
 
1043
# Possible values: 0 or 1
 
1044
# Default: 0
 
1045
#
 
1046
IncludeInternalLinksInOriginSection=0
 
1047
 
 
1048
 
971
1049
# Following parameter can be used to choose maximum number of lines shown for
972
1050
# the particular following report.
973
1051
#
995
1073
# Stats by screen size
996
1074
MaxNbOfScreenSizesShown = 5
997
1075
MinHitScreenSize = 1
 
1076
# Stats by window size (following 2 parameters are not yet used)
 
1077
MaxNbOfWindowSizesShown = 5
 
1078
MinHitWindowSize = 1
998
1079
# Stats by referers
999
1080
MaxNbOfRefererShown = 10
1000
1081
MinHitRefer   = 1
1023
1104
# If you don't want any flag link, set ShowFlagLinks to "".
1024
1105
# This parameter is used only if ShowMenu parameter is set to 1.
1025
1106
# Possible values: "" or "language_codes_separated_by_space"
1026
 
# Example: "en es fr nl es"
 
1107
# Example: "en es fr nl de"
1027
1108
# Default: ""
1028
1109
#
1029
1110
ShowFlagLinks=""
1142
1223
# Plugin: DecodeUTFKeys
1143
1224
# Perl modules required: Encode and URI::Escape
1144
1225
# Allow AWStats to show correctly (in language charset) keywords/keyphrases
1145
 
# strings even if they were UTF8 coded by the referer search engine.
 
1226
# strings even if they were UTF8 coded by the referer search engine.
1146
1227
#
1147
1228
#LoadPlugin="decodeutfkeys"
1148
1229
 
1162
1243
#
1163
1244
#LoadPlugin="hashfiles"
1164
1245
 
 
1246
# Plugin: GeoIP
 
1247
# Perl modules required: Geo::IP or Geo::IP::PurePerl (from Maxmind)
 
1248
# Country chart is built from an Internet IP-Country database.
 
1249
# This plugin is useless for intranet only log files.
 
1250
# Note: You must choose between using this plugin (need Perl Geo::IP module 
 
1251
# from Maxmind, database more up to date) or the GeoIPfree plugin (need
 
1252
# Perl Geo::IPfree module, database less up to date).
 
1253
# This plugin reduces AWStats speed of 8% !
 
1254
#
 
1255
#LoadPlugin="geoip GEOIP_STANDARD"
 
1256
 
1165
1257
# Plugin: GeoIPfree
1166
1258
# Perl modules required: Geo::IPfree version 0.2+ (from Graciliano M.P.)
1167
1259
# Country chart is built from an Internet IP-Country database.
1168
1260
# This plugin is useless for intranet only log files.
1169
 
# Note: You must choose between using this plugin (need Perl Geo::IPfree module)
1170
 
# or the GeoIP plugin (need Perl Geo::IP module from Maxmind).
 
1261
# Note: You must choose between using this plugin (need Perl Geo::IPfree
 
1262
# module, database less up to date) or the GeoIP plugin (need Perl Geo::IP
 
1263
# module from Maxmind, database more up to date).
 
1264
# Note: Activestate provide a corrupted version of Geo::IPfree 0.2 Perl
 
1265
# module, so install it from elsewhere (from www.cpan.org for example).
1171
1266
# This plugin reduces AWStats speed of 10% !
1172
1267
#
1173
1268
#LoadPlugin="geoipfree"
1174
1269
 
1175
 
# Plugin: GeoIP
1176
 
# Perl modules required: Geo::IP or Geo::IP::PurePerl (from Maxmind)
1177
 
# Country chart is built from an Internet IP-Country database.
1178
 
# This plugin is useless for intranet only log files.
1179
 
# Note: You must choose between using this plugin (need Perl Geo::IP module 
1180
 
# from Maxmind) or the GeoIPfree plugin (need Perl Geo::IPfree module).
1181
 
# This plugin reduces AWStats speed of 10% !
1182
 
#
1183
 
#LoadPlugin="geoip"
 
1270
# Plugin: GeoIP_Region_Maxmind
 
1271
# Perl modules required: Geo::IP (from Maxmind)
 
1272
# This plugin add a chart of hits by regions. Only regions for US and 
 
1273
# Canada can be detected.
 
1274
# Note: This plugin need Maxmind GeoIP Perl module AND the region database.
 
1275
# Note: I get some problem with Maxmind Geo::IP Perl module with ActiveState
 
1276
# on Windows but it works great on Linux with default Perl.
 
1277
# You need to purchase a license from Maxmind to get/use the Region database.
 
1278
# This plugin reduces AWStats speed.
 
1279
#
 
1280
#LoadPlugin="geoip_region_maxmind GEOIP_STANDARD /pathto/GeoIPRegion.dat"
 
1281
 
 
1282
# Plugin: GeoIP_City_Maxmind
 
1283
# Perl modules required: Geo::IP (from Maxmind)
 
1284
# This plugin add a chart of hits by cities.
 
1285
# Note: This plugin need Maxmind GeoIP Perl module AND the city database.
 
1286
# Note: I get some problem with Maxmind Geo::IP Perl module with ActiveState
 
1287
# on Windows but it works great on Linux with default Perl.
 
1288
# You need to purchase a license from Maxmind to get/use the City database.
 
1289
# This plugin reduces AWStats speed.
 
1290
#
 
1291
#LoadPlugin="geoip_city_maxmind GEOIP_STANDARD /pathto/GeoIPCity.dat"
 
1292
 
 
1293
# Plugin: GeoIP_ISP_Maxmind
 
1294
# Perl modules required: Geo::IP (from Maxmind)
 
1295
# This plugin add a chart of hits by ISP.
 
1296
# Note: This plugin need Maxmind GeoIP Perl module AND the ISP database.
 
1297
# Note: I get some problem with Maxmind Geo::IP Perl module with ActiveState
 
1298
# on Windows but it works great on Linux with default Perl.
 
1299
# You need to purchase a license from Maxmind to get/use the ISP database.
 
1300
# This plugin reduces AWStats speed.
 
1301
#
 
1302
#LoadPlugin="geoip_isp_maxmind GEOIP_STANDARD /pathto/GeoIPISP.dat"
 
1303
 
 
1304
# Plugin: GeoIP_Org_Maxmind
 
1305
# Perl modules required: Geo::IP (from Maxmind)
 
1306
# This plugin add a chart of hits by Organization name
 
1307
# Note: This plugin need Maxmind GeoIP Perl module AND the Org database.
 
1308
# Note: I get some problem with Maxmind Geo::IP Perl module with ActiveState
 
1309
# on Windows but it works great on Linux with default Perl.
 
1310
# You need to purchase a license from Maxmind to get/use the Org database.
 
1311
# This plugin reduces AWStats speed.
 
1312
#
 
1313
#LoadPlugin="geoip_org_maxmind GEOIP_STANDARD /pathto/GeoIPOrg.dat"
1184
1314
 
1185
1315
# Plugin: UserInfo
1186
1316
# Perl modules required: None
1193
1323
#LoadPlugin="userinfo"
1194
1324
 
1195
1325
# Plugin: HostInfo
1196
 
# Perl modules required: XWhois
 
1326
# Perl modules required: Net::XWhois
1197
1327
# Add a column into host chart with a link to open a popup window that shows
1198
1328
# info on host (like whois records).
1199
1329
#
1200
1330
#LoadPlugin="hostinfo"
1201
1331
 
 
1332
# Plugin: ClusterInfo
 
1333
# Perl modules required: None
 
1334
# Add a text (for example a full hostname) in cluster reports for each cluster
 
1335
# number.
 
1336
# A text file called clusterinfo.myconfig.txt, with two fields (first is
 
1337
# cluster number, second is text to show) separated by a tab char. must be
 
1338
# created into DirData directory.
 
1339
# Note this plugin is useless if ShowClusterStats is set to 0 or if you don't
 
1340
# use a personalized log format that contains %cluster tag.
 
1341
#
 
1342
#LoadPlugin="clusterinfo"
 
1343
 
1202
1344
# Plugin: UrlAliases
1203
1345
# Perl modules required: None
1204
1346
# Add a text (Page title, description...) in URL reports before URL value.
1205
1347
# A text file called urlalias.myconfig.txt, with two fields (first is URL,
1206
 
# second is text to show, separated by a tab char) must be created in DirData
1207
 
# directory.
 
1348
# second is text to show, separated by a tab char) must be created into
 
1349
# DirData directory.
1208
1350
#
1209
1351
#LoadPlugin="urlalias"
1210
1352
 
1211
1353
# Plugin: TimeHiRes
1212
 
# Perl modules required: Time::HiRes
 
1354
# Perl modules required: Time::HiRes (if Perl < 5.8)
1213
1355
# Time reported by -showsteps option is in millisecond. For debug purpose.
1214
1356
#
1215
1357
#LoadPlugin="timehires"         
1255
1397
# In most cases, you don't need this feature.
1256
1398
#
1257
1399
# ExtraSectionNameX is title of your personalized chart.
1258
 
# ExtraSectionConditionalX are conditions you can use to count or not the hit,
1259
 
#   Use one of the field condition (URL, QUERY_STRING, REFERER, UA, HOST),
1260
 
#   and a regex to match after a coma. Use "|" for "OR".
 
1400
# ExtraSectionCodeFilterX is list of codes the record code field must match.
 
1401
#   Put an empty string for no test on code.
 
1402
# ExtraSectionConditionX are conditions you can use to count or not the hit,
 
1403
#   Use one of the field condition (URL,QUERY_STRING,REFERER,UA,HOST,extraX)
 
1404
#   and a regex to match, after a coma. Use "||" for "OR".
1261
1405
# ExtraSectionFirstColumnTitleX is the first column title of the chart.
1262
 
# ExtraSectionFirstColumnValuesX is a Regex string to tell AWStats in which 
1263
 
#   field to extract value from (URL, QUERY_STRING, REFERER, UA, HOST) and how
1264
 
#   to extract the value (using regex syntax). Each different value found will
1265
 
#   appear in first column of report on a different row. Be sure that list of
1266
 
#   different values is "limited" to avoid "not enough memory" problems !
 
1406
# ExtraSectionFirstColumnValuesX is a string to tell AWStats which field to
 
1407
#   extract value from (URL,QUERY_STRING,REFERER,UA,HOST,extraX)
 
1408
#   and how to extract the value (using regex syntax). Each different value
 
1409
#   found will appear in first column of report on a different row. Be sure
 
1410
#   that list of different possible values will not grow indefinitely.
1267
1411
# ExtraSectionFirstColumnFormatX is the string used to write value.
1268
1412
# ExtraSectionStatTypesX are things you want to count. You can use standard
1269
1413
#   code letters (P for pages,H for hits,B for bandwidth,L for last access).
1275
1419
 
1276
1420
# Example to report the 20 products the most ordered by "order.cgi" script
1277
1421
#ExtraSectionName1="Product orders"
1278
 
#ExtraSectionCondition1="URL,\/cgi\-bin\/order\.cgi|URL,\/cgi\-bin\/order2\.cgi"
 
1422
#ExtraSectionCodeFilter1="200 304"
 
1423
#ExtraSectionCondition1="URL,\/cgi\-bin\/order\.cgi||URL,\/cgi\-bin\/order2\.cgi"
1279
1424
#ExtraSectionFirstColumnTitle1="Product ID"
1280
1425
#ExtraSectionFirstColumnValues1="QUERY_STRING,productid=([^&]+)"
1281
1426
#ExtraSectionFirstColumnFormat1="%s"
1286
1431
#MinHitExtra1=1
1287
1432
 
1288
1433
 
 
1434
# There is also a global parameter ExtraTrackedRowsLimit that limit the
 
1435
# number of possible rows an ExtraSection can report. This parameter is
 
1436
# here to protect too much memory use when you make a bad setup in your
 
1437
# ExtraSection. It applies to all ExtraSection independently meaning that
 
1438
# none ExtraSection can report more rows than value defined by ExtraTrackedRowsLimit.
 
1439
# If you know an ExtraSection will report more rows than its value, you should
 
1440
# increase this parameter or AWStats will stop with an error.
 
1441
# Example: 2000
 
1442
# Default: 500
 
1443
#
 
1444
ExtraTrackedRowsLimit=500
 
1445
 
1289
1446
 
1290
1447
#-----------------------------------------------------------------------------
1291
1448
# INCLUDES
1296
1453
# This is particularly usefull for users who have a lot of virtual servers, so
1297
1454
# a lot of config files and want to maintain common values in only one file.
1298
1455
# Note that when a variable is defined both in a config file and in an
1299
 
# included file, AWStats will use the last value read.
 
1456
# included file, AWStats will use the last value read for parameters that
 
1457
# contains one value and AWStats will concat all values from both files for
 
1458
# parameters that are lists of value.
1300
1459
#
1301
1460
 
1302
1461
#Include ""