Changesets can be listed by changeset number.
The Git repository is here.
- Revision:
- 297
- Log:
Updated to AWStats 7.0.
- Author:
- rool
- Date:
- Fri Mar 18 13:33:29 +0000 2011
- Size:
- 30316 Bytes
- Properties:
- Property svn:executable is set
| 1 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> |
| 2 | <html><head> |
| 3 | <meta name="description" content="AWStats Documentation - Contrib and resource page"> |
| 4 | <meta name="keywords" content="awstats, awstat, log, file, analyzer, contrib, plugins, resources, maxmind, geoipfree, geoip, cities, regions, countries, frontend"> |
| 5 | <meta name="robots" content="index,follow"> |
| 6 | <meta name="title" content="AWStats Documentation - Contrib and resource page"> |
| 7 | |
| 8 | <title>AWStats Documentation - Contrib and resource page</title><link rel="stylesheet" href="styles.css" type="text/css"><!-- $Revision: 1.38 $ - $Author: eldy $ - $Date: 2010/06/22 21:35:24 $ --></head> |
| 9 | <body topmargin="10" leftmargin="5"> |
| 10 | |
| 11 | |
| 12 | <table style="font-family: arial,helvetica,verdana; font-style: normal; font-variant: normal; font-weight: normal; font-size: 10pt; line-height: normal; font-size-adjust: none; font-stretch: normal;" bgcolor="#ffffff" border="0" cellpadding="0" cellspacing="0" width="100%"> |
| 13 | |
| 14 | <!-- Large --> |
| 15 | <tbody><tr style="font-family: arial,helvetica,verdana; font-style: normal; font-variant: normal; font-weight: normal; font-size: 10pt; line-height: normal; font-size-adjust: none; font-stretch: normal;"> |
| 16 | <td align="center" bgcolor="#9999cc"><a href="/"><img src="images/awstats_logo1.png" border="0"></a></td> |
| 17 | <td align="center" bgcolor="#9999cc"> |
| 18 | <br> |
| 19 | <font style="font-family: arial,helvetica,sans-serif; font-style: normal; font-variant: normal; font-weight: normal; font-size: 16pt; line-height: normal; font-size-adjust: none; font-stretch: normal;" color="#eeeeff"><b>AWStats logfile analyzer 7.0 Documentation</b></font><br> |
| 20 | <br> |
| 21 | </td> |
| 22 | <td align="center" bgcolor="#9999cc"> |
| 23 | |
| 24 | </td> |
| 25 | </tr> |
| 26 | |
| 27 | </tbody></table> |
| 28 | |
| 29 | |
| 30 | <br><br><h1 style="font-family: arial,helvetica,sanserif; font-style: normal; font-variant: normal; font-weight: normal; font-size: 26px; line-height: normal; font-size-adjust: none; font-stretch: normal;">Plugins, contribs and related programs</h1> |
| 31 | |
| 32 | You will find here description for different kinds of ressource files :<br> |
| 33 | - <a href="#PLUGINS">AWStats plugins</a><br> |
| 34 | - <a href="#CONTRIB">Other AWStats contribs/tools/package</a><br> |
| 35 | - <a href="#RELATED">Other Non AWStats contribs/tools (not related to AWStats but related to log analysis)</a><br> |
| 36 | - <a href="#DOC">Documents on AWStats or related to log analysis</a><br> |
| 37 | <br> |
| 38 | |
| 39 | |
| 40 | <br><a name="PLUGINS"></a><br> |
| 41 | <font color="#665544" size="3"><b>AWStats plugins</b></font><br> |
| 42 | <hr> |
| 43 | Plugins are .pm files you can put in your AWStats plugins directory to add new features.<br> |
| 44 | Note that you must enable the plugin by adding a new line in your config files to make |
| 45 | it works (See <a href="awstats_config.html#LoadPlugin">LoadPlugin</a> parameter).<br> |
| 46 | <br> |
| 47 | |
| 48 | <a href="#plugin_standards">Standard free plugins</a> : <b>tooltips, decodeutfkeys, ipv6, hashfiles, userinfo, hostinfo, clusterinfo, urlalias, timehires, timezone, rawlog, |
| 49 | graphapplet, graphgooglechartsapi </b><b>geoipfree</b><br> |
| 50 | <a href="#plugin_others">GeoIP Plugins</a> (may require other licensed product to work) : |
| 51 | <b>geoip,</b><b> geoip_city_maxmind, geoip_asn_maxmind, </b><b>geoip_region_maxmind</b>, |
| 52 | <b>geoip_isp_maxmind</b>, |
| 53 | <b>geoip_org_maxmind</b>, |
| 54 | <br> |
| 55 | <br> |
| 56 | |
| 57 | <br><a name="plugin_standards"><b>List of standard plugins</b></a> (Provided with AWStats) : |
| 58 | <br> |
| 59 | |
| 60 | <br><span style="font-weight: bold;">Tooltips |
| 61 | </span><br><span style="font-style: italic;">Required Modules:</span> None |
| 62 | <br><span style="font-style: italic;">Parameters:</span> None<br><span style="font-style: italic;">Description</span>: Add tooltips pop-up help boxes to HTML report pages. |
| 63 | <br>Provided with AWStats (5.4+). |
| 64 | |
| 65 | <br> |
| 66 | |
| 67 | <br><span style="font-weight: bold;">DecodeUTFKeys |
| 68 | </span><br><span style="font-style: italic;">Required Modules:</span> Encode and URI::Escape |
| 69 | <br><span style="font-style: italic;">Parameters:</span> None<br><span style="font-style: italic;">Description:</span> Allow AWStats to show correctly (in language charset) keywords/keyphrases |
| 70 | strings even if they were UTF8 coded by the referer search engine. |
| 71 | <br>Plugin provided with AWStats (6.0+). |
| 72 | |
| 73 | <br> |
| 74 | |
| 75 | <br><span style="font-weight: bold;">IPv6 |
| 76 | </span><br><span style="font-style: italic;">Required Modules: </span>Net::IP and Net::DNS |
| 77 | <br><span style="font-style: italic;">Parameters:</span> None<br><span style="font-style: italic;">Description:</span> This plugin gives AWStats capability to make reverse DNS lookup on IPv6 addresses. |
| 78 | <br>Note: IPv6 addresses are currently incompatible with the GeoIP databases<br>Plugin provided with AWStats (5.5+) |
| 79 | |
| 80 | <br> |
| 81 | |
| 82 | <br><span style="font-weight: bold;">HashFiles |
| 83 | </span><br><span style="font-style: italic;">Required Modules:</span> Storable |
| 84 | <br><span style="font-style: italic;">Parameters:</span> None<br><span style="font-style: italic;">Description:</span> AWStats DNS cache files are read/saved as native hash files. This improves |
| 85 | cache file loading speed, especially for very large web sites. |
| 86 | |
| 87 | <br>Plugin provided with AWStats (5.1+) |
| 88 | |
| 89 | <br><br><span style="font-weight: bold;">UserInfo |
| 90 | </span><br><span style="font-style: italic;">Required Modules:</span> None |
| 91 | <br><span style="font-style: italic;">Parameters:</span> None<br><span style="font-style: italic;">Description: </span> Add text (Firtname, Lastname, Office Department, ...) to authenticated user reports for each login value. |
| 92 | A text file called userinfo.myconfig.txt, with two fields (first is login, |
| 93 | second is text to show, separated by a tab char) must be created in DirData directory. |
| 94 | |
| 95 | <br>Plugin provided with AWStats (5.5+) |
| 96 | |
| 97 | <br> |
| 98 | |
| 99 | <br><span style="font-weight: bold;">ClusterInfo |
| 100 | </span><br><span style="font-style: italic;">Required Modules:</span> None |
| 101 | <br><span style="font-style: italic;">Parameters:</span> None<br><span style="font-style: italic;">Description:</span> |
| 102 | Add text (for example a full hostname) to cluster reports for each |
| 103 | cluster |
| 104 | number. A text file called clusterinfo.myconfig.txt, with two |
| 105 | fields (first is cluster number, second is text to show) separated |
| 106 | by a tab character must be created in DirData directory. <br>Note: This plugin is useless if ShowClusterStats is set to 0 or if you don't use a personalized log format that contains <span style="font-style: italic;">%cluster</span> tag. |
| 107 | |
| 108 | <br>Plugin provided with AWStats (6.2+) |
| 109 | |
| 110 | <br> |
| 111 | |
| 112 | <br><span style="font-weight: bold;">HostInfo |
| 113 | </span><br><span style="font-style: italic;">Required Modules:</span> Net::XWhois |
| 114 | <br><span style="font-style: italic;">Parameters:</span> None<br><span style="font-style: italic;">Description:</span> Add a column into host chart with a link to open a popup window that shows info on host (like whois records). |
| 115 | |
| 116 | <br>Plugin provided with AWStats (6.0+) |
| 117 | |
| 118 | <br> |
| 119 | |
| 120 | <br><span style="font-weight: bold;">UrlAliases |
| 121 | </span><br><span style="font-style: italic;">Required Modules:</span> None |
| 122 | <br><span style="font-style: italic;">Parameters:</span> None<br><span style="font-style: italic;">Description:</span> Add text |
| 123 | (Page title, description...) to URL reports before URL value. A |
| 124 | text file called urlalias.myconfig.txt, with two fields (first is |
| 125 | URL, second is text to show, separated by a tab char) must be |
| 126 | created in DirData directory. |
| 127 | <br>You can build your urlalias file manually or use <a href="awstats_tools.html#urlaliasbuilder">urlaliasbuilder.pl</a> tool (provided with 5.4+) |
| 128 | |
| 129 | <br>Plugin provided with AWStats (5.2+) |
| 130 | <br> |
| 131 | |
| 132 | <br><span style="font-weight: bold;">TimeHiRes |
| 133 | </span><br><span style="font-style: italic;">Required Modules:</span> Time::HiRes |
| 134 | <br><span style="font-style: italic;">Parameters:</span> None<br><span style="font-style: italic;">Description:</span> Time reported by -showsteps option is in millisecond. For debug purpose. |
| 135 | |
| 136 | <br>Plugin provided with AWStats (5.1+) |
| 137 | |
| 138 | <br> |
| 139 | |
| 140 | <br><span style="font-weight: bold;">TimeZone |
| 141 | </span><br><span style="font-style: italic;">Required Modules:</span> Time::Local |
| 142 | <br><span style="font-style: italic;">Parameters:</span> <offset or local timezone><br><span style="font-style: italic;">Description:</span> |
| 143 | Converts the timezone of log files before processing using the offset |
| 144 | provided in the parameters. This is useful for some IIS users if logs |
| 145 | are stored in GMT or for users who have servers in a different |
| 146 | timezone. You must provide either the abreviated name of the timezone |
| 147 | you wish to convert to or the offset value in hours. For example<br><span style="font-style: italic;">LoadPlugin="timezone +2"</span> would add two hours to the log timestamps<br><span style="font-style: italic;">LoadPlugin="timezone CET"</span> would convert the log from GMT to CET<br>Note: This plugin reduces AWStats speed by about 40%!<br>Plugin provided with AWStats (5.1+) |
| 148 | |
| 149 | <br> |
| 150 | |
| 151 | <br><span style="font-weight: bold;">Rawlog |
| 152 | </span><br><span style="font-style: italic;">Required Modules:</span> None |
| 153 | <br><span style="font-style: italic;">Parameters:</span> None<br><span style="font-style: italic;">Description: </span>This |
| 154 | plugin adds a form in AWStats main page to allow users to see |
| 155 | raw content of current log files. A display filter will also be |
| 156 | displayed. |
| 157 | <br>Plugin provided with AWStats (5.7+) |
| 158 | |
| 159 | <br> |
| 160 | |
| 161 | <br><span style="font-weight: bold;">GraphApplet |
| 162 | </span><br><span style="font-style: italic;">Required Modules:</span> None |
| 163 | <br><span style="font-style: italic;">Parameters:</span> None<br><span style="font-style: italic;">Description:</span> Supported charts are built by a 3D graphic applet. |
| 164 | <br>LoadPlugin="graphapplet" # EXPERIMENTAL FEATURE |
| 165 | |
| 166 | <br>Plugin provided with AWStats (6.0+) |
| 167 | |
| 168 | <br><br><span style="font-weight: bold;">GraphGoogleChartAPI</span><br><span style="font-style: italic;">Required Modules:</span> None |
| 169 | <br><span style="font-style: italic;">Parameters:</span> None<br><span style="font-style: italic;">Description:</span> |
| 170 | Replaces the standard charts with free Google API generated images in |
| 171 | HTML reports. If country data is available and more than one country |
| 172 | has hits, a map will be generated using Google Visualizations.<br>Note: |
| 173 | The machine where reports are displayed must have Internet access for |
| 174 | the charts to be generated. The only data sent to Google includes the |
| 175 | statistic numbers, legend names and country names. <br>Plugin provided with AWStats (6.0+) |
| 176 | |
| 177 | <br><br><span style="font-weight: bold;">GeoIPfree |
| 178 | </span><br><span style="font-style: italic;">Required Modules:</span> Geo::IPfree version 0.2+ (from Graciliano M.P.) |
| 179 | <br><span style="font-style: italic;">Parameters:</span> None<br><span style="font-style: italic;">Description:</span> Country |
| 180 | chart is built from an Internet IP-Country database. This plugin |
| 181 | is useless for intranet only log files. <br>Note: You must |
| 182 | choose between using this plugin (need Perl Geo::IPfree module, |
| 183 | database is free but not up to date) or the GeoIP plugin |
| 184 | (need Perl Geo::IP module from Maxmind, database is also free and |
| 185 | up to date). <br>Note: Activestate provide a corrupted version of Geo::IPfree 0.2 Perl module, so install it from elsewhere (from <a href="http://www.cpan.org/">www.cpan.org</a> for example). |
| 186 | <br>This plugin reduces AWStats speed by about 10% ! |
| 187 | <br>Plugin provided with AWStats (5.5+). |
| 188 | <br>You can find Geo::IPfree Perl Module on : |
| 189 | <br>- All OS: <a href="http://www.cpan.org/">CPAN site</a> |
| 190 | <br>- RPM compatible OS (RedHat, Mandrake...): <a href="http://www.lafraia.com/RPM/">Lafraia rpm</a> |
| 191 | <br>- ActiveState: GeoIPfree module provided by Activestate is not working correctly so I removed |
| 192 | the link. You can follow the following setup instead: Download from <a href="http://www.cpan.org/">CPAN site</a> |
| 193 | and copy 'Geo' directory (found in 'lib') into AWStats plugins directory. |
| 194 | This is a fast tip to install Geo-IPfree perl module to be used by AWStats geoipfree plugin. |
| 195 | <br>Note: The Geo::IPfree database has not been updated in a long time, so using |
| 196 | the <a href="awstats_contrib.html#geoip">geoip</a> plugin (using the Geo::IP Perl module, now free for countries) is highly recommended. |
| 197 | <br>You can use the following tool to test your geoipfree setup: <a href="file:///files/testgeoipfree.pl">testgeoipfree.pl</a>. Just |
| 198 | put this file into your plugins directory and run it. |
| 199 | |
| 200 | <br><br> |
| 201 | |
| 202 | <a name="geoip"> </a> |
| 203 | <br><span style="font-weight: bold;">Maxmind GeoIP Plugin Notes</span><br>Maxmind |
| 204 | is a company that sells geolocation technology that matches IP |
| 205 | addresses to countries, regions, cities and ISPs. All of their databses |
| 206 | are available for an initial fee and a monthly update subscription and |
| 207 | include greater accuracy and a higher frequency of updating. Some |
| 208 | databases are available for free but they are not updated as often and |
| 209 | may not be as accurate.<br><br><span style="text-decoration: underline;">Install:</span><br>First choose a database. When downloading a database for AWStats, please download the <span style="font-style: italic;">Binary Format</span> version. Current databases AWStats supports are:<br><span style="font-style: italic;"><br>Commercial</span>: <a href="http://www.maxmind.com/app/country?rId=awstats">Country</a>, <a href="http://www.maxmind.com/app/region?rId=awstats">Region</a>, <a href="http://www.maxmind.com/app/city?rId=awstats">City</a>, <a href="http://www.maxmind.com/app/organization?rId=awstats">Organization</a>, <a href="http://www.maxmind.com/app/isp?rId=awstats">ISP</a><br><span style="font-style: italic;">Open Source</span> <a href="http://www.maxmind.com/app/geolitecountry?rId=awstats">Country</a>, <a href="http://www.maxmind.com/app/geolitecity?rId=awstats">City</a>, <a href="http://www.maxmind.com/app/asnum?rId=awstats">ASN</a><br><br>If you choose to purchase a commercial database for country |
| 210 | information, you only need to purchase the one with the greatest level |
| 211 | of detail you want to appear in your report. For example, if you only |
| 212 | want country information, you can purchase just the Country database. |
| 213 | If you want City detail, you do <span style="font-style: italic;">not</span> |
| 214 | need to purcahse the Country and Region databases, just the City |
| 215 | database. (Organization and ISP databases do not include country or |
| 216 | region info so you must purchase those in addition to Country, Region |
| 217 | or City if you desire more information)<br><br>Next, install the |
| 218 | Geo::IP Perl module. Then choose a Maxmind API to access the databse. |
| 219 | Maxmind also has two Perl API's available for interacting with their |
| 220 | databases. There is a a C/Perl library that will run quickly and |
| 221 | there is a pure Perl API that is a little slower but does not require |
| 222 | any C depdencies. Choose <a href="http://www.maxmind.com/app/perl?rId=awstats">one of the API</a>s and install it on your machine.<br><br><span style="font-style: italic;">Parameters</span>: |
| 223 | Each GeoIP database can be loaded entirely into memory or lookups can |
| 224 | scan through the file. When editing your AWStats configuration, you |
| 225 | have to specify if you want to use memory or file lookups. Specify |
| 226 | GEOIP_STANDARD for file lookups or GEOIP_MEMORY_CACHE for memory |
| 227 | loading. Please note that the memory method may crash on some Linux |
| 228 | distributions so if that happens, try the standard method. Also, using |
| 229 | the C API with Activestate Perl may crash on Windows machines, so use |
| 230 | the PurePerl module instead.<br><br>You may also override some |
| 231 | databases by generating a comma seperated text file with IP addresses |
| 232 | and associated data. This is useful if you are reporting on an Intranet |
| 233 | site, have a mixture of internal and external users or the data for a |
| 234 | specific IP is incorrect in the database. You can use the included |
| 235 | geoip_generator tool to create override files. (Overrides only available in AWStats version 6.96 and later)<br><b>Override Formats:</b><br><i>GeoIP</i> |
| 236 | - ip_address,"countrycode"<br><i>GeoIP City</i> - |
| 237 | ip_address,"countrycode","regioncode","cityname","postalcode",latitude,longitude,"metrocode","areacode"<br><i>GeoIP |
| 238 | ASN</i> - ip_address,"asn ispname"<br><i>GeoIP Region - </i>ip_address,"countrycode","regioncode"<br><i>GeoIP |
| 239 | Org</i> - ip_address,"organisation"<i><br></i><i>GeoIP ISP</i> - |
| 240 | ip_address,"ISP"<br><br>Note: AWStats |
| 241 | does not currently support IPv6 for GeoIP lookups as Maxmind only |
| 242 | offers the country DB with IPv6 at this time. As Maxmind includes IPv6 |
| 243 | support in more DBs, we will update AWStats.<br>Enabling GeoIP plugins |
| 244 | will reduce the speed of AWStats processing.<br><br><span style="font-weight: bold;">GeoIP |
| 245 | </span><br><span style="font-style: italic;">Required Modules:</span> Geo::IP or Geo::IP::PurePerl (from Maxmind) |
| 246 | <br><span style="font-style: italic;">Parameters:</span> [GEOIP_STANDARD | GEOIP_MEMORY_CACHE] [/pathto/geoip.dat] </pathto/override.txt><br><span style="font-style: italic;">Description:</span> Country chart is built from an Internet IP-Country database. |
| 247 | <br>Note: You must choose between using this plugin or the |
| 248 | GeoIPfree plugin (need Perl Geo::IPfree module, database is free |
| 249 | but not up to date). |
| 250 | <br>Example <span style="font-style: italic;">LoadPlugin="geoip GEOIP_STANDARD /usr/local/geoip.dat /usr/local/geoip_override.txt" |
| 251 | |
| 252 | </span><br>Plugin provided with AWStats (5.2+) |
| 253 | |
| 254 | <br><br><span style="font-weight: bold;">GeoIP_City_Maxmind |
| 255 | </span><br><span style="font-style: italic;">Required Modules:</span> Geo::IP or Geo::IP::PurePerl (from Maxmind) |
| 256 | <br><span style="font-style: italic;">Parameters:</span> [GEOIP_STANDARD | GEOIP_MEMORY_CACHE] [/pathto/GeoIPCity.dat] </pathto/override.txt><br><span style="font-style: italic;">Description: </span>This plugin adds a chart of hits by cities (with country and regions informations for major countries). |
| 257 | <br> |
| 258 | By enabling this plugin, you will see a new link called 'Cities' on |
| 259 | reports menu.<br>Example <span style="font-style: italic;">LoadPlugin="geoip_city_maxmind GEOIP_STANDARD /usr/local/geoip.dat /usr/local/GeoIPCity_override.txt" |
| 260 | |
| 261 | </span><br>Plugin provided with AWStats (6.2+) |
| 262 | |
| 263 | <br><br><span style="font-weight: bold;">GeoIP_ASN_Maxmind</span><br><span style="font-style: italic;">Required Modules:</span> Geo::IP or Geo::IP::PurePerl (from Maxmind) |
| 264 | <br><span style="font-style: italic;">Parameters:</span> [GEOIP_STANDARD | GEOIP_MEMORY_CACHE] [/pathto/GeoIPASN.dat] </pathto/override.txt> <link to AS lookup><br><span style="font-style: italic;">Description: </span>This |
| 265 | plugin adds a chart of AS numbers where the host IP address is |
| 266 | registered. This plugin can display some ISP information if included in |
| 267 | the database. You can also provide a link that will be used to lookup |
| 268 | additional registration data. Put the link at the end of the parameter |
| 269 | string and the report page will include the link with the full AS |
| 270 | number at the end.<br>Example <span style="font-style: italic;">LoadPlugin="geoip_asn_maxmind |
| 271 | GEOIP_STANDARD /usr/local/geoip.dat /usr/local/GeoIPASN_override.txt |
| 272 | http://enc.com.au/itools/aut-num.php?autnum=" |
| 273 | </span><br>Plugin provided with AWStats (6.9+) |
| 274 | |
| 275 | <br><br><span style="font-weight: bold;">GeoIP_Region_Maxmind |
| 276 | (Commercial Only)</span><br><span style="font-style: italic;">Required Modules:</span> Geo::IP or Geo::IP::PurePerl (from Maxmind) |
| 277 | <br><span style="font-style: italic;">Parameters:</span> [GEOIP_STANDARD | GEOIP_MEMORY_CACHE] [/pathto/GeoIPRegion.dat] </pathto/override.txt><br><span style="font-style: italic;">Description: </span>This plugin adds a chart of hits by regions. Only regions for US and Canada can be detected at this time. |
| 278 | <br>By enabling this plugin, you will see a new link called 'Regions' on reports menu. For |
| 279 | the moment this link works only when AWStats reports are build as CGI (static built not yet |
| 280 | supported). |
| 281 | <br>Example <span style="font-style: italic;">LoadPlugin="geoip_region_maxmind GEOIP_STANDARD /usr/local/GeoIPRegion.dat /usr/local/geoip_override.txt" |
| 282 | |
| 283 | </span><br>Plugin provided with AWStats (6.2+) |
| 284 | |
| 285 | <br><br><span style="font-weight: bold;">GeoIP_ISP_Maxmind |
| 286 | (Commercial Only)</span><br><span style="font-style: italic;">Required Modules:</span> Geo::IP or Geo::IP::PurePerl (from Maxmind) |
| 287 | <br><span style="font-style: italic;">Parameters:</span> [GEOIP_STANDARD | GEOIP_MEMORY_CACHE] [/pathto/GeoIPISP.dat] </pathto/override.txt><br><span style="font-style: italic;">Description:</span> This plugin adds a chart of hits by ISP. |
| 288 | <br>By enabling this plugin, you will see a new link called 'ISP' on reports menu. For |
| 289 | the moment this link works only when AWStats reports are build as CGI (static built not yet |
| 290 | supported). |
| 291 | <br>Example <span style="font-style: italic;">LoadPlugin="geoip_isp_maxmind GEOIP_STANDARD /usr/local/GeoIPISP.dat </span><span style="font-style: italic;">/usr/local/geoip_override.txt"</span><br>Plugin provided with AWStats (6.3+) |
| 292 | |
| 293 | <br><br><span style="font-weight: bold;">GeoIP_Org_Maxmind |
| 294 | (Commercial Only)</span><br><span style="font-style: italic;">Required Modules:</span> Geo::IP or Geo::IP::PurePerl (from Maxmind) |
| 295 | <br><span style="font-style: italic;">Parameters:</span> [GEOIP_STANDARD | GEOIP_MEMORY_CACHE] [/pathto/GeoIPOrg.dat] </pathto/override.txt><br><span style="font-style: italic;">Description:</span> This plugin adds a chart of hits by Organization names. |
| 296 | <br>By enabling this plugin, you will see a new link called 'Organizations' on reports menu. For |
| 297 | the moment this link works only when AWStats reports are build as CGI (static built not yet |
| 298 | supported). |
| 299 | <br>Example <span style="font-style: italic;">LoadPlugin="geoip_org_maxmind GEOIP_STANDARD /usr/local/GeoIPOrg.dat </span><span style="font-style: italic;">/usr/local/geoip_override.txt"</span><br>Plugin provided with AWStats (6.3+) |
| 300 | |
| 301 | <br><br><a name="CONTRIB"></a><br> |
| 302 | <font color="#665544" size="3"><b>Other AWStats contribs/tools/package</b></font><br> |
| 303 | <hr> |
| 304 | |
| 305 | <br> |
| 306 | All following files/products were developped and submitted by contributors. |
| 307 | I haven't tried them, so I can't tell you if they work and how they work...<br> |
| 308 | They can enhance AWStats use or save you time giving you a start for a new development.<br> |
| 309 | <br> |
| 310 | |
| 311 | <!-- |
| 312 | <b>Other available packages (provided by contributors):</b><br> |
| 313 | <a href="http://nx.dyndns.info/sme/awstats/awstats.php" target=new>A SME (E-Smith) package</a> (Based on AWStats 6.0 version)<br> |
| 314 | <a href="http://www.nuonce.net/awstats-cobalt.php" target=new> Cobalt RaQ 3/4/550 Package Files </a> (Based on AWStats 5.9)<br> |
| 315 | <a href="http://www.turro.org/Portal?xpc=1$@8$@1$@1&folder=20050104154634840" target=new> A war package</a><br> |
| 316 | <br> |
| 317 | --> |
| 318 | |
| 319 | <b>Other tools:</b><br> |
| 320 | <br> |
| 321 | |
| 322 | <i>Replacement Frontend:</i><br> |
| 323 | <br> |
| 324 | |
| 325 | <a href="http://betterawstats.com">BetterAWStats</a> is a PHP Frontend to show you AWStats data file differently.<br> |
| 326 | |
| 327 | <a href="http://phpnuke.org/modules.php?name=News&file=article&sid=7041" target="_new">AWStats PhpNuke module</a> is a module for the open source CMS PHP Nuke.<br> |
| 328 | |
| 329 | <a href="http://www.ravencore.com/" target="_new">Ravencore</a> is an Open Source Hosting Control Panel that include AWStats as part of its statistics solutions.<br> |
| 330 | |
| 331 | <a href="/files/summary4severaldomains.pl" target="_new">summary4severaldomains.pl</a> is a small perl script that build an index.html page |
| 332 | with AWStats txt summary information for each domains on same page (number of pages, hits and bandwith for month).<br> |
| 333 | |
| 334 | <a href="http://www.telartis.nl/xcms/awstats" target="_new">AWStats Totals</a> is a php page |
| 335 | that use AWStats database to show a summary for several config files, on the same page.<br> |
| 336 | |
| 337 | <br> |
| 338 | <i>Miscellanous:</i><br> |
| 339 | <br> |
| 340 | |
| 341 | <a href="http://wordpress.org/extend/plugins/awstats-script/">A plugin for WordPress</a> that allow WordPress users |
| 342 | to add tags required by AWStats to report the "miscellanous chart".<br> |
| 343 | |
| 344 | <a href="http://sourceforge.net/projects/exim2awstats/">Exim2Awstats</a> is a tool to convert Exim MTA log file to a format readable by AWSTats.<br> |
| 345 | |
| 346 | <a href="http://www.digievo.co.uk/software.asp?category=2">Logprocess</a> automate the collection, merging, processing and archiving of IIS |
| 347 | log files in a hosting (mult-domain) environment using AWStats to generate and manage stats/reports.<br> |
| 348 | |
| 349 | <a href="http://www.xlenc.com/portfolio.do" target="_new">XlencArlm</a> is a tool to enhance use of AWStats with IIS (Catching log files from FTP, |
| 350 | doing GMT correction on log files, ...). Don't know if it works correctly but seems to be interesting.<br> |
| 351 | |
| 352 | <a href="/files/configurador.tgz" target="_new">Configurador</a> is a piece of CGI perl scripts to allow you to edit an AWStats config file from |
| 353 | the web. Code comments are in Spanish but it may be a goo start to develop your own tool. |
| 354 | <i>Hector Garcia Alvarez</i><br> |
| 355 | |
| 356 | <a href="/files/logtrans.py" target="_new">logtrans.py</a> is a python small example on how to convert an old |
| 357 | log file from IIS4.0 to a new format compatible with AWStats. Don't know if it works, just here |
| 358 | to provide you a code sample if you like python.<br> |
| 359 | |
| 360 | <a href="/files/isa2w3c.pl" target="_new">isa2w3c.pl</a>, is a convertor to have a more standard |
| 361 | log file from an ISA log file.<br> |
| 362 | |
| 363 | <a href="http://www.ruwenzori.net/code/go_awstats/" target="_new">go_awstats</a>, is a tool to automate build of |
| 364 | AWStats statics reports for all config files but also for all month.<br> |
| 365 | |
| 366 | <a href="http://forum.topflood.com/referencement/logiciel-stat-5015.html">Stats Letter</a>, is a Perl tool to |
| 367 | send AWStats reports to one or several user for one or several reports. Documentation in French only.<br> |
| 368 | |
| 369 | |
| 370 | <br><a name="RELATED"></a><br> |
| 371 | <font color="#665544" size="3"><b>Other Non AWStats contribs/tools (not related to AWStats but related to log analysis)</b></font><br> |
| 372 | <hr> |
| 373 | |
| 374 | <a href="/files/maillog2commonlog.pl" target="_new">maillog2commonlog.pl</a> converts mail logs in |
| 375 | smail or qmail format to the common log format. |
| 376 | Note that if you want to analyze, with AWStats, mail log files from postfix, sendmail or qmail, |
| 377 | a better solution is to use instead maillogconvert.pl preprocessor (See AWStats |
| 378 | <a href="awstats_faq.html#MAIL">F.A.Q</a> about analyzing mail logs).<br> |
| 379 | <i>Joey Hess, freeware.</i><br> |
| 380 | |
| 381 | <a href="http://www.kristoffersen.us/software/" target="_new">maillogconv.pl</a> is another mail log processor that |
| 382 | can be used to change mail log files into a log file that AWStats can understand.<br> |
| 383 | Note that a derivated and enhanced tool called maillogconvert.pl is provided with AWStats |
| 384 | since 5.7. See <a href="awstats_faq.html#MAIL">F.A.Q</a> about analyzing mail logs to know |
| 385 | how to setup AWStats with maillogconv.pl or maillogconvert.pl to analyze |
| 386 | Postfix, Sendmail, Qmail or MDaemon log files.<br> |
| 387 | |
| 388 | <a href="http://mlc.anzac.at%20" target="_new">mlc</a> is another postfix mail logs converter (written in C). |
| 389 | Try it if the maillogconvert.pl tool provided with AWStats does not work on your postfix log file.<br> |
| 390 | |
| 391 | <a href="/files/access_referer_agent2combined.pl" target="_new">access_referer_agent2combined.pl</a> is a perl script that converts a |
| 392 | directory of common log format (CLF) access-files, referer-files and agent-files to a single combined.log |
| 393 | This is usefull if you have seperate access/referer/agent logfiles and want to use all features of a loganalyzer |
| 394 | that require a combined log file.<br> |
| 395 | <a href="http://anonlog.sourceforge.net/" target="_new">anonlog</a> "anonymizes" your logfile by encoding sensitive information.<br> |
| 396 | <i>Stephen Turner, freeware.</i><br> |
| 397 | |
| 398 | <br> |
| 399 | <u>If you don't like AWStats, you can try thoose other popular similar tools :</u><br> |
| 400 | <a href="http://www.analog.cx/" target="_new">Analog</a>. A very old log analyzer (written in C).<br> |
| 401 | <i>Stephen Turner, free software.</i><br> |
| 402 | <a href="http://www.mrunix.net/webalizer/" target="_new">Webalizer</a>. Another very old log analyzer (written in C).<br> |
| 403 | <br> |
| 404 | There is also commercial products you can find doing a search on 'log file analyzer' with <a href="http://www.google.com">Google</a>.<br> |
| 405 | <br> |
| 406 | |
| 407 | |
| 408 | |
| 409 | <br><a name="DOC"></a><br> |
| 410 | <font color="#665544" size="3"><b>Documents on AWStats or related to log analysis</b></font><br> |
| 411 | <hr> |
| 412 | <!--<img src="/images/us.png">-->AWStats official documentation for last version can be found here: <a href="index.html">HTML On line</a> or <a href="awstats.pdf">PDF file</a><br> |
| 413 | <br> |
| 414 | <a href="http://www.antezeta.com/awstats.html" title="Contains installation and usage tips, additional ExtraSection examples, patches and other resources">Additional resources for AWStats</a> provided by Antezeta (<a href="http://www.antezeta.it/awstats.html" title="Contiene suggerimenti per l'installazione ed utilizzo; esempi di ExtraSection, patch ed altri risorse" lang="it">or in Italian</a>)<br> |
| 415 | An intro and install doc 'Using AWStats on GNU/Linux or Windows' in <a href="http://www.chedong.com/tech/awstats.html">Chinese</a><br> |
| 416 | A setup tutorial in <a href="http://www.showsource.dk/artikler/vis_artikel.php?id=1065375981" target="_new">Danish</a><br> |
| 417 | A setup tutorial in <a href="http://www.funix.org/fr/linux/main-linux.php3?ref=logapache&page=menu" target="_doc">French from Funix: How to install AWStats and Webalizer</a><br> |
| 418 | A setup tutorial in <a href="http://www.baudelet.net/awstats.htm" target="_doc">French for Windows users</a><br> |
| 419 | A setup tutorial in <a href="http://www.fpoeserv.com/?Select=Awstats" target="_new">French from Fpoeserv</a><br> |
| 420 | A setup tutorial for debian users with a logrotate tool in <a href="http://amaris.cybernd.at/awstats.html" target="_new">German</a><br> |
| 421 | Another way to explain <a href="http://www.raoul.shacknet.nu/2005/11/29/configure-awstats/">AWStats setup</a><br> |
| 422 | <br> |
| 423 | |
| 424 | |
| 425 | <br> |
| 426 | <hr> |
| 427 | |
| 428 | <script language="javascript"> |
| 429 | var lastmod = new Date(document.lastModified); |
| 430 | if (lastmod.getDate() > 0) { |
| 431 | if (lastmod.getDate()<10) zerod="0" |
| 432 | else zerod=""; |
| 433 | if (lastmod.getMonth()<9) zerom="0" |
| 434 | else zerom="" |
| 435 | year2kok=lastmod.getYear(); |
| 436 | if (year2kok<100) year2kok+=2000; |
| 437 | if ((year2kok>=100) && (year2kok < 1970)) year2kok+=1900; |
| 438 | document.writeln("Last revision: "+year2kok+"-"+zerom+(lastmod.getMonth()+1)+"-"+zerod+lastmod.getDate()); |
| 439 | } |
| 440 | </script> |
| 441 | |
| 442 | <script language="javascript"> |
| 443 | var doc=document.location.href; |
| 444 | if (doc.match(/^http/i)!=null) { |
| 445 | document.write('<scr' + 'ipt language="javascript" src="/cgi-bin/pslogger.pl?loc='+escape(document.location)+'&ref='+escape(document.referrer)); |
| 446 | if (document.all) { document.write('&size='+document.fileSize); } |
| 447 | document.write('"></scr' + 'ipt>'); |
| 448 | } |
| 449 | </script> |
| 450 | |
| 451 | <a href="http://www.chiensderace.com"> </a> |
| 452 | <a href="http://www.chatsderace.com"> </a> |
| 453 | |
| 454 | </body></html> |
