AWStats

For further information see the AWStats website - http://awstats.sourceforge.net/

Installation

1. Install the package
   • apt-get install awstats
2. Edit the the generic template config file if required
   • /etc/awstats/awstats.conf
3. Create apache config file for site with contents show below
   • eg /etc/apache2/sites-enabled/awstats
4. Restart apache
   • service apache2 restart
5. Site should now be available via URL similar to
   • http://yourserver/awstats/awstats.pl

Alias /awstatsclasses "/usr/share/awstats/lib/"
Alias /awstats-icon/ "/usr/share/awstats/icon/"
Alias /awstatscss "/usr/share/doc/awstats/examples/css"
ScriptAlias /awstats/ /usr/lib/cgi-bin/

<Directory /usr/lib/cgi-bin/>
        Options ExecCGI -MultiViews +SymLinksIfOwnerMatch
        Order allow,deny
        Allow from all
</Directory>

<Directory /usr/share/awstats/>
        Order allow,deny
        Allow from all
</Directory>

Add a Web Site

1. Create a specific config file for the site to monitor
   • cp /etc/awstats/awstats.conf /etc/awstats/awstats.mysite.com.conf
2. Edit the config file for the site, specifically (see below for further options)
   • LogFile=”/path/to/your/domain/access.log”
   • LogFormat=1 (this will give you more detailed stats)
   • SiteDomain=”mysite.com”
   • HostAliases=”www.mysite.com localhost 127.0.0.1" (example for a local site)
3. Perform an initial stats gather for the site
   • /usr/lib/cgi-bin/awstats.pl -config=mysite.com -update
4. Test that you can see some stats, using URL similar to
   • http://yourserver/awstats/awstats.pl?config=mysite.com
5. Add a scheduled job to crontab to update automatically
   • crontab -e
   • EG every 30 mins */30 * * * * /bin/perl /usr/lib/cgi-bin/awstats.pl -config=mysite.com -update >/dev/null

Further options

• Wiki sites (and other sites where an URL parameter can specify a specific page)
  • URLWithQuery=1 - useful for Wiki's etc where query param indicates a different page
  • URLWithQueryWithOnlyFollowingParameters="title" - only treats variances in param title as distinct pages
  • URLReferrerWithQuery=1 follows on from two above

IIS Servers

By default, IIS server logs do not contain enough fields. Make sure the following are included (those in bold are the usually omitted culprits)..

• date
• time
• c-ip
• cs-username
• cs-method
• cs-uri-stem
• cs-uri-query
• sc-status
• sc-bytes
• cs-version
• cs(User-Agent)
• cs(Referer)

To change the above in IIS7, in IIS Manager

1. Highlight the webserver (not a web site)
2. Double-click the Logging feature
3. Click on the Select Fields button

One-off Update

To perform a one-off update from a specific log file...

• /usr/lib/cgi-bin/awstats.pl -config=server -LogFile=access.log
  • Updates can only be added in chronological order, therefore you may need to delete the data file for a particular month, and rebuild it entirely.

Scheduled updates are configured in /etc/cron.d/awstats