AWStats is a log analyzer that can generate statistics and charts from your site access logs.

Here's how to install it on Opalstack:

Create a new PHP+Apache app for to host AWStats and make a note of the app name. Be sure to use the same shell user that owns the site you want to track.
Attach the app to a site. You can serve AWStats from its own site, or on a sub-URI as an additional app route on an existing site.

SSH to your app's shell user and run the following commands to download and extract AWStats into the app directory:

cd ~/apps/appname
wget https://prdownloads.sourceforge.net/awstats/awstats-7.8.tar.gz
tar zxf awstats-7.8.tar.gz --strip 1
cp wwwroot/cgi-bin/awstats.model.conf wwwroot/cgi-bin/awstats.conf
mkdir data
touch .htaccess awstats_cron
chmod 700 awstats_cron

Edit ~/apps/appname/awstats_cron to make it like this:

#!/bin/bash

# change these to your site and stats app names
SITE=sitename
STATSAPP=appname

# no need to edit further
APPDIR=$HOME/apps/$STATSAPP
LOGDIR=$HOME/logs/sites/$SITE
TODAY=$( date '+%Y%m%d' )
LOG="$LOGDIR/access.log-$TODAY.gz"

echo "processing $LOG"

cd $APPDIR
$APPDIR/tools/logresolvemerge.pl $LOG > $APPDIR/data/log
$APPDIR/wwwroot/cgi-bin/awstats.pl -config=awstats -u

Edit ~/apps/appname/.htaccess to make it like this:

AddHandler cgi-script .pl

RewriteEngine On

RewriteCond %{HTTP:X-Forwarded-SSL} !on
RewriteRule ^$ http://%{HTTP_HOST}%{REQUEST_URI}cgi-bin/awstats.pl [R,L]
RewriteCond %{HTTP:X-Forwarded-SSL} on
RewriteRule ^$ https://%{HTTP_HOST}%{REQUEST_URI}cgi-bin/awstats.pl [R,L]

# If you are serving AWStats on the root of its own site:
RewriteCond %{REQUEST_URI} !^/wwwroot/
RewriteRule ^(.*)$ /wwwroot/$1 [P,L]

# If you are serving stats from a sub-URL then replace the 2 lines above
# with these (using `/stats` as the example URI here)
# RewriteCond %{REQUEST_URI} !^/stats/wwwroot/
# RewriteRule ^(.*)$ /stats/wwwroot/$1 [P,L]

Edit ~/apps/appname/wwwroot/cgi-bin/awstats.conf to set the following variables:
- LogFile="/home/shelluser/apps/appname/data/log" - replace shelluser and appname with your own.
- SiteDomain="domain.com" - replace domain.com with the domain of the site you are tracking
- DirIcons="../icon"
Run the awstats_cron script to get your initial data:
```
~/apps/appname/awstats_cron
```

Run crontab -e to make a cron job to keep awstats updated. Daily log rotation runs between 0300 and 0400 daily, so be sure to schedule it some time after 0400:
```
# update awstats at 0500 UTC daily
0 5 * * * ~/apps/appname/awstats_cron
```

You're done! Your AWStats should now be available at the site you set up in step 2 above.