Improve company productivity with a Business Account.Sign Up


How do I get Awstats to report a specific period from the history of the weblog?

Posted on 2010-08-28
Medium Priority
Last Modified: 2012-05-10
Other than capturing or copying  ongoing web html pages of the awstat web reports monthly how do I get the Search engine referral report to
output a snapshot back in time on the fly??

 /usr/bin/perl -config=testweb -output=refererse -staticlinks > /tmp/testwebJuly2010
when the current reporting has been done for August 2010???
 /usr/bin/perl -config=testweb -output=refererse -staticlink   -magicparameterDateRange=07012010-07312010  > /tmp/testwebJuly2010
Question by:Robert Silver
  • 2
  • 2

Accepted Solution

mcuk_storm earned 2000 total points
ID: 33550914
its not quite as fine grain as you specified but there is -month=07 -year=2010

Author Comment

by:Robert Silver
ID: 33551261
I will try that and see what happens

Author Closing Comment

by:Robert Silver
ID: 33552821
Great job - That was what I was looking for
If you can I would appreciate a link to the complete man page or documentation for

Expert Comment

ID: 33552860
You can get the command options by running with no options, for convienience here it is:

----- awstats 6.7 (build 1.892) (c) 2000-2007 Laurent Destailleur -----
AWStats is a free web server logfile analyzer to show you advanced web
AWStats comes with ABSOLUTELY NO WARRANTY. It's a free software distributed
with a GNU General Public License (See LICENSE file for details).

Syntax: -config=virtualhostname [options]

  This runs awstats in command line to update statistics of a web site, from
   the log file defined in AWStats config file (with -update option), or build
   a HTML report (with -output option).
  First, awstats tries to read awstats.virtualhostname.conf as the config file.
  If not found, awstats tries to read awstats.conf
  Note 1: Config files (awstats.virtualhostname.conf or awstats.conf) must be
   in /etc/awstats, /usr/local/etc/awstats, /etc or same directory than 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
  -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
  -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
  Those '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)

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
  Number of times site is 'added to favorites bookmarks'
  Ratio of Browsers with support of: Java, Flash, RealG2 reader,
                        Quicktime reader, WMA reader, PDF reader
  Configurable personalized reports
  271 domains/countries
  617 robots
  5 worm's families
  49 operating systems
  168 browsers (514 with phone browsers database)
  220 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

Featured Post

What Kind of Coding Program is Right for You?

There are many ways to learn to code these days. From coding bootcamps like Flatiron School to online courses to totally free beginner resources. The best way to learn to code depends on many factors, but the most important one is you. See what course is best for you.

Question has a verified solution.

Are you are experiencing a similar issue? Get a personalized answer when you ask a related question.

Have a better answer? Share it in a comment.

Join & Write a Comment

Tech spooks aren't just for those who are tech savvy, it also happens to those of us running a business. Check out the top tech spooks for business owners.
Have a Cisco router that you forgot the password or maybe you bought a used router that is locked with a password? This article will guide you through the steps on how to recover the password on your Cisco gear.
Michael from AdRem Software outlines event notifications and Automatic Corrective Actions in network monitoring. Automatic Corrective Actions are scripts, which can automatically run upon discovery of a certain undesirable condition in your network.…
Monitoring a network: why having a policy is the best policy? Michael Kulchisky, MCSE, MCSA, MCP, VTSP, VSP, CCSP outlines the enormous benefits of having a policy-based approach when monitoring medium and large networks. Software utilized in this v…

606 members asked questions and received personalized solutions in the past 7 days.

Join the community of 500,000 technology professionals and ask your questions.

Join & Ask a Question