349
355
CreateDirDataIfNotExists=0
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
357
365
BuildHistoryFormat=text
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
366
375
BuildReportFormat=html
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
381
SaveDatabaseFilesWithPermissionsForEveryone=1
391
SaveDatabaseFilesWithPermissionsForEveryone=0
384
394
# AWStats can purge log file, after analyzing it. Note that AWStats is able
872
895
# C = Web compression (mod_gzip,mod_deflate)
873
896
# M = Average mail size (mail logs)
875
# Show menu header with report links
876
# Default: 1, Possible codes: None
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
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
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
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
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
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
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
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
903
# Default: 0 (If set to 1, see also LevelForWormsDetection), Possible codes: HBL
940
# Context: Web, Streaming
941
# Default: 0 (If set to 1, see also LevelForWormsDetection), Possible column codes: HBL
905
944
# Show email senders chart (For use when analyzing mail log files)
906
# Default: 0, Possible codes: HBML
946
# Default: 0, Possible column codes: HBML
907
947
ShowEMailSenders=0
908
949
# Show email receivers chart (For use when analyzing mail log files)
909
# Default: 0, Possible codes: HBML
951
# Default: 0, Possible column codes: HBML
910
952
ShowEMailReceivers=0
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
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
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
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
923
974
# Show operating systems chart
924
# Default: 1, Possible codes: None
975
# Context: Web, Streaming, Ftp
976
# Default: 1, Possible column codes: None
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
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
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
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
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
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
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
947
1014
# Show smtp errors chart (For use when analyzing mail log files)
948
# Default: 0, Possible codes: None
1016
# Default: 0, Possible column codes: None
949
1017
ShowSMTPErrorsStats=0
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
1163
1244
#LoadPlugin="hashfiles"
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% !
1255
#LoadPlugin="geoip GEOIP_STANDARD"
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% !
1173
1268
#LoadPlugin="geoipfree"
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% !
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.
1280
#LoadPlugin="geoip_region_maxmind GEOIP_STANDARD /pathto/GeoIPRegion.dat"
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.
1291
#LoadPlugin="geoip_city_maxmind GEOIP_STANDARD /pathto/GeoIPCity.dat"
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.
1302
#LoadPlugin="geoip_isp_maxmind GEOIP_STANDARD /pathto/GeoIPISP.dat"
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.
1313
#LoadPlugin="geoip_org_maxmind GEOIP_STANDARD /pathto/GeoIPOrg.dat"
1185
1315
# Plugin: UserInfo
1186
1316
# Perl modules required: None
1193
1323
#LoadPlugin="userinfo"
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).
1200
1330
#LoadPlugin="hostinfo"
1332
# Plugin: ClusterInfo
1333
# Perl modules required: None
1334
# Add a text (for example a full hostname) in cluster reports for each cluster
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.
1342
#LoadPlugin="clusterinfo"
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
1348
# second is text to show, separated by a tab char) must be created into
1349
# DirData directory.
1209
1351
#LoadPlugin="urlalias"
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.
1215
1357
#LoadPlugin="timehires"
1255
1397
# In most cases, you don't need this feature.
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).