------------- AWStats -------------- Advanced Web Statistics ------------------------------------ Advanced Web Statistics (AWStats) is a powerfull and featurefull web server logfile analyzer that shows you all your Web statistics including visitors, pages, hits, hours, search engines, keywords used to find your site, broken links, robots and more... It works with IIS 5.0+, Apache and all major web, wap, proxy, streaming server log files (and even syslog, ftp servers or mail logs) on all Operating Systems. License: GNU GPL (GNU General Public License. See LICENSE file) Version : 5.6 Release date: July 2003 Platforms: All (Linux, NT, SCO, BSD, Solaris and other *NIX's, BeOS, OS/2...) Author: Laurent Destailleur AWStats official web site and latest version: http://awstats.sourceforge.net I - Features and requirements of AWStats I - 1) Features, what AWStats can show you I - 2) Requirements for using AWStats I - 3) Files II - Install, Setup and Use AWStats III - Benchmark IV - About the author, license and support I - FEATURES AND REQUIREMENTS ------------------------------------ I - 1) Features A full log analysis enables AWStats to show you the following information: * Number of VISITS and UNIQUE VISITORS, * Visits duration and last visits, * Authenticated users, and last authenticated visits, * Days of week and rush hours (pages, hits, KB for each day and hour), * Domains/countries of hosts visitors (pages, hits, KB), * Hosts list, last visits and unresolved IP addresses list, * Most viewed, entry and exit pages, * File types, * Web compression statistics (for mod_gzip or mod_deflate), * Browsers used (pages, hits, kb for each browser), * OS used (pages, hits, KB for each OS), * Visits of robots, * Search engines, keyphrases and keywords used to find your site, * HTTP errors (Page not found with last referer, ...), * Other personalized reports, * Screen size report, * Ratio of Browsers that support: Java, Flash, RealG2 reader, Quicktime reader, WMA reader, PDF reader It supports the following features as well: * Can analyze all log formats. * Works from command line and from a browser as a CGI (with dynamic filters capabilities for some charts), * Update of statistics can be made on demand from the web interface and not only from your scheduler, * Unlimited log file size, support split log files (load balancing system), * Support 'nearly sorted' log files even for entry and exit pages, * Reverse DNS lookup before or during analysis, support DNS cache files, * Country detection from IP location or domain name. * WhoIS Links, * A lot of options/filters and plugins can be used, * Multi-named web sites supported (virtual servers), * Cross Site Scripting Attacks protection, * Several languages, * No need of rare perl libraries, * Graphical one page or framed reports, * Look and colors can match your site design, can use CSS, * Help and tooltips on HTML reported pages, * Easy to use (Just one configuration file to edit), * Free (GNU GPL), with sources (perl scripts), * Available on all platforms. I - 2) Requirements To use AWStats CGI script, you need the following requirements: * Your server must log web access in a log file you can read. * To run awstats, from command line, your operating system must be able to run perl scripts (.pl files). To run awstats as a CGI (for real-time statistics), your web server must also be able to run such scripts. If not, you can solve this by downloading last Perl version at: http://www.activestate.com/ActivePerl/ (Windows) http://www.perl.com/pub/language/info/software.html (All OS) I - 3) Files The distribution of AWStats package includes the following files: README.TXT This file docs/LICENSE GNU General Public Licence docs/* AWStats documentation (setup/usage...) tools/* Ohter provided tools wwwroot/cgi-bin/awstats.pl The main CLI/CGI program wwwroot/cgi-bin/awstats.model.conf An example of AWStats configure file wwwroot/cgi-bin/lang Directory with languages files wwwroot/cgi-bin/lib Directory with awstats reference info wwwroot/cgi-bin/plugins Directory with optional plugins wwwroot/icon/browser Directory with browsers icons wwwroot/icon/clock Directory with clocks icons wwwroot/icon/cpu Directory with cpu icons wwwroot/icon/flags Directory with country flags icons wwwroot/icon/os Directory with os icons wwwroot/icon/other Directory with all others icons wwwroot/css Samples of CSS files wwwroot/js Javascript sources for "Misc" feature II - INSTALL, SETUP AND USE AWSTATS ----------------------------------- The documentation available as of the date of this release is included, in HTML format, in the docs/ directory. You can find a most up-to-date documentation at: http://awstats.sourceforge.net III - BENCHMARK ----------------------------------- Tests and results are available in AWStats documentation, in docs/ directory. IV - ABOUT THE AUTHOR, LICENSE AND SUPPORT ----------------------------------------- Copyright (C) 2000-2003 - Laurent Destailleur - eldy@users.sourceforge.net This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License version 2 as published by the Free Software Foundation. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details, in COPYING.TXT file. If you have not received a copy of this file along with this program, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.