Check out my first novel, midnight's simulacra!

AWStats

From dankwiki
Revision as of 15:51, 5 February 2012 by Dank (talk | contribs) (apache log perms for awstats)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

AWStats provides some nice web log visualization, but can be painful to set up...

Packages

  • awstats, obviously
  • libgeo-ipfree-perl if you want GeoIP lookups, and a database...
    • geoip-database, from master (GeoLiteCountry) and Geo::IPfree
    • geoip-database-contrib, from contrib (binary versions of Country, IPv6 Country, City, and ASN) and Geo::IP or Geo::IP::PurePerl
      • run geoip-database-contrib_update to update this latter
  • libnet-xwhois-perl if you want to use the hostinfo plugin

/etc/logrotate.d/apache

By default, apache log files are created root adm 640. AWStats runs as www-user. You'll either need change adm to www-user, or 640 to 644.

/etc/awstats/awstats.conf

  • You want LogFormat 1 rather than 4 (assuming you're using Apache), but this requires some apache config changes...
    • FIXME detail?
  • Set SiteDomain appropriately (use your ServerName from apache config).
    • Consider rewriting all URI's to your ServerName using mod-rewrite.
  • Add ::1 to HostAliases, along with any values from your ServerAliases directive
    • Use "REGEX[expr]" for regexes here
  • Set EnableLockForUpdate, KeepBackupOfHistoricFiles, IncludeInternalLinksInOriginSection, MetaRobot
  • Copy /usr/share/doc/awstats/examples/js/awstats_misc_tracker.js to /js/ relative to your webroot
script type="text/javascript" src="/js/awstats_misc_tracker.js"></script>
<noscript><img src="/js/awstats_misc_tracker.js?nojs=y" height=0 width=0 border=0 style="display: none"></noscript>