From: eldy <>
Date: Sat, 16 Nov 2002 13:31:11 +0000 (+0000)
Subject: Added geoip plugin.
X-Git-Tag: AWSTATS_5_2_RELEASE~19
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=b4dbebd6ee337a063310262651a9ac1f7f03faec;p=thirdparty%2FAWStats.git
Added geoip plugin.
---
diff --git a/docs/awstats_benchmark.html b/docs/awstats_benchmark.html
index c2d441b2..360cefd3 100644
--- a/docs/awstats_benchmark.html
+++ b/docs/awstats_benchmark.html
@@ -45,9 +45,9 @@ AWStats speed depends on AWStats version and options/setup you use in configurat
HARDWARE: Athlon 1 GHz / 128Mb
SOFTWARE: Windows 2000 / Perl 5.8
-CONFIG OPTIONS: LogFormat=1, DNSLookup=0
+CONFIG OPTIONS: LogFormat=1, DNSLookup=0, URLWithQuery=0, URLReferrerWithQuery=0, No plugins
AVERAGE SPEED: 4500 lines by seconds
-Other times for different kind of web sites are shown lower in this page...
+Other times for different kind of web sites sizes are shown later in this page...
@@ -64,7 +64,7 @@ according to web server or AWStats configuration and web site content.
Don't forget that benchmarks of log analyzers are made without reverse DNS lookup
because this depends on your system, networks and Internet and not on the
-log analyzer you use. And the reverse DNS lookup can take 95% of the time of a log analysis !
+log analyzer you use. And the reverse DNS lookup can take more than 95% of time of a log analysis !
So, have a look at the following chart to:
- Get more real ideas on benchmarks results
- Get more information and advice on a good setup for your site.
@@ -89,9 +89,9 @@ So, have a look at the following chart to:
| +5,000,000 visits/month | AWStats is not a good choice for such web sites. Try a tool with less features but faster like Analog |
* You should set DNSLookup parameter to 0 (or 2) if
- - reverse DNS lookup is already done in your log file
- - or if you don't need the "domain/countries" report
+ - reverse DNS lookup is already done in your log file,
- or if your web site has more than 250,000 visits a month.
+Note: Country report can works without reverse DNS lookup if plugin 'geoip' is enabled (faster and more accurate than reverse DNS lookup).
** Free memory required for update process (in MB).
Warning: If you use the URLWithQuery or URLReferrerWithQuery option, or forget
to complete correctly URLQuerySeparators for some sites, this value can be dramatically increased.
@@ -103,12 +103,14 @@ to complete correctly URLQueryS




- You can disable DNSLookup in AWStats (set DNSLookup=0 or DNSlookup=2 to only use DNS file resolver).
-Note that with DNSLookup disabled if you still want to have the 'country/domain' report, this requires that hosts addresses
-in your log file are already resolved (need to setup your web server to do so, your web server will be slowed).
-Without DNSLookup, log analyze speed can be increased by 10 to 100 times.
+Note that with DNSLookup disabled, if you still want to have the 'Country' report, you must enable the 'geoip' plugin.
+Without this plugin, 'Country' report will works only if hosts addresses in your log file are already
+resolved (need to setup your web server to do so, your web server will be slowed).
+Without DNSLookup, log analyze speed can be increased by 20 to 100 times.



- Use carefully parameters URLWithQuery and URLReferrerWithQuery
-(Let them set to 0 if you don't know what they means) and check your web site URLs' syntax to know if you need to complete parameter URLQuerySeparators.
+(Let them set to 0 if you don't know what they means) and check your web site URLs' syntax to know if you need to complete parameter URLQuerySeparators.
+If you really need to use URLWithQuery=1, check that URLWithQueryWithoutFollowingParameters is set properly.



- Be sure that your HostAliases parameter list is complete.



diff --git a/docs/awstats_config.html b/docs/awstats_config.html
index ba918e74..0a20c7e6 100644
--- a/docs/awstats_config.html
+++ b/docs/awstats_config.html
@@ -308,17 +308,18 @@ when reading it), follow the example:
DNSLookup
Version : 1.0 + (5.0 + for value 2)
-
# If you want to have information on domains/countries visitors, you must ask
-
# AWStats to make reverse DNS lookup (if not already done in your log file).
+
# If you want to have hosts reported by name instead of ip address, AWStats
+
# need to make reverse DNS lookups (if not already done in your log file).
# With DNSLookup to 0, all hosts will be reported by their IP addresses and
-
# not by the full hostname of visitors. Domain/Country chart will also report
-
# all visitors from a domain/country "Unknown".
-
# If you need to set DNSLookup to 1, don't forget that this will reduce
+
# not by the full hostname of visitors.
+
# If you want to set DNSLookup to 1, don't forget that this will reduce
# dramatically AWStats update process speed. Do not use on large web sites.
+
# Note: Country detection can works without reverse DNS lookup if plugin
+
# 'geoip' is enabled (faster and more accurate than reverse DNS lookup).
# Possible values:
-
# 0 No DNS Lookup
-
# 1 DNS Lookup is fully enabled
-
# 2 DNS Lookup is made only from DNS cache files
+
# 0 - No DNS Lookup
+
# 1 - DNS Lookup is fully enabled
+
# 2 - DNS Lookup is made only from DNS cache files (if exist)
# Default: 2
#
DNSLookup=2
@@ -812,11 +813,11 @@ when reading it), follow the example:
URLQuerySeparators
Version : 5.2 +
-
# In URL links, "?" char is used to add parameters list in URLs. Syntax is:
+
# In URL links, "?" char is used to add parameter's list in URLs. Syntax is:
# /mypage.html?param1=value1
# However, some servers/sites have also others chars to isolate dynamic part of
-
# their URLs. You can complete this list with this parameter.
-
# Example: "?"
+
# their URLs. You can complete this list with all such characters.
+
# Example: "?;,"
# Default: "?;"
#
URLQuerySeparators="?;"
@@ -854,7 +855,7 @@ when reading it), follow the example:
# /mypage.cgi?p=abc&id=Yo4UomP9d and /mypage.cgi?p=abc&id=Mu8fdxl3r
# will be reported as 2 hits on /mypage.cgi?p=abc
# This parameter is not used when URLWithQuery is 0.
-
# Example: "PHPSESSID"
+
# Example: "PHPSESSID jsessionid"
# Default: ""
#
URLWithQueryWithoutFollowingParameters=""