awstats --version (return code: 0)
awstats 7.6 (build 20161204)
awstats -HELP (return code: 2)
----- awstats 7.6 (build 20161204) (c) 2000-2016 Laurent Destailleur -----
AWStats is a free web server logfile analyzer to show you advanced web
statistics.
AWStats comes with ABSOLUTELY NO WARRANTY. It's a free software distributed
with a GNU General Public License (See LICENSE file for details).
Syntax: awstats.awstats -config=virtualhostname [options]
This runs awstats in command line to update statistics (-update option) of a
web site, from the log file defined in AWStats config file, or build a HTML
report (-output option).
First, awstats tries to read awstats.virtualhostname.conf as the config file.
If not found, awstats tries to read awstats.conf, and finally the full path passed to -config=
Note 1: Config files (awstats.virtualhostname.conf or awstats.conf) must be
in /etc/awstats, /usr/local/etc/awstats, /etc or same directory than
awstats.pl script file.
Note 2: If AWSTATS_FORCE_CONFIG environment variable is defined, AWStats will
use it as the "config" value, whatever is the value on command line or URL.
See AWStats documentation for all setup instrutions.
Options to update statistics:
-update to update statistics (default)
-showsteps to add benchmark information every 8192 lines processed
-showcorrupted to add output for each corrupted lines found, with reason
-showdropped to add output for each dropped lines found, with reason
-showunknownorigin to output referer when it can't be parsed
-showdirectorigin to output log line when origin is a direct access
-updatefor=n to stop the update process after parsing n lines
-LogFile=x to change log to analyze whatever is 'LogFile' in config file
Be care to process log files in chronological order when updating statistics.
Options to show statistics:
-output to output main HTML report (no update made except with -update)
-output=x to output other report pages where x is:
alldomains to build page of all domains/countries
allhosts to build page of all hosts
lasthosts to build page of last hits for hosts
unknownip to build page of all unresolved IP
allemails to build page of all email senders (maillog)
lastemails to build page of last email senders (maillog)
allemailr to build page of all email receivers (maillog)
lastemailr to build page of last email receivers (maillog)
alllogins to build page of all logins used
lastlogins to build page of last hits for logins
allrobots to build page of all robots/spider visits
lastrobots to build page of last hits for robots
urldetail to list most often viewed pages
urldetail:filter to list most often viewed pages matching filter
urlentry to list entry pages
urlentry:filter to list entry pages matching filter
urlexit to list exit pages
urlexit:filter to list exit pages matching filter
osdetail to build page with os detailed versions
browserdetail to build page with browsers detailed versions
unknownbrowser to list 'User Agents' with unknown browser
unknownos to list 'User Agents' with unknown OS
refererse to build page of all refering search engines
refererpages to build page of all refering pages
keyphrases to list all keyphrases used on search engines
keywords to list all keywords used on search engines
errors404 to list 'Referers' for 404 errors
allextraX to build page of all values for ExtraSection X
-staticlinks to have static links in HTML report page
-staticlinksext=xxx to have static links with .xxx extension instead of .html
-lang=LL to output a HTML report in language LL (en,de,es,fr,it,nl,...)
-month=MM to output a HTML report for an old month MM
-year=YYYY to output a HTML report for an old year YYYY
The 'date' options doesn't allow you to process old log file. They only
allow you to see a past report for a chosen month/year period instead of
current month/year.
Other options:
-debug=X to add debug informations lesser than level X (speed reduced)
-version show AWStats version
Now supports/detects:
Web/Ftp/Mail/streaming server log analyzis (and load balanced log files)
Reverse DNS lookup (IPv4 and IPv6) and GeoIP lookup
Number of visits, number of unique visitors
Visits duration and list of last visits
Authenticated users
Days of week and rush hours
Hosts list and unresolved IP addresses list
Most viewed, entry and exit pages
Files type and Web compression (mod_gzip, mod_deflate stats)
Screen size
Ratio of Browsers with support of: Java, Flash, RealG2 reader,
Quicktime reader, WMA reader, PDF reader
Configurable personalized reports
279 domains/countries
1068 robots
5 worm's families
88 operating systems
212 browsers (592 with phone browsers database)
1284 search engines (and keyphrases/keywords used from them)
All HTTP errors with last referrer
Report by day/month/year
Dynamic or static HTML or XHTML reports, static PDF reports
Indexed text or XML monthly database
And a lot of other advanced features and options...
New versions and FAQ at http://www.awstats.org