iisstat -- Distribution Information

The iisstat ( Internet Information Services Statistics ) program will process a WU-FTP xferlog log, a httpd Common Log Format access log (NCSA, CERN, etc.), EMWAC http access log, a Gopher log, or a TBBS log and output statistics in printed or HTML form with the option of graphs. The program is written in Perl and should work on any UNIX-based sytem with Perl 4.0x

iisstat can create reports on hourly usage, daily usage, day of week usage, day of month usage, month usage, usage by hosts, usage by domain, usage by company, usage by section of server, usage by file, and usage by file type. It also has a number of options to customize the reports, including: filters on IP addresses/Domain names, file names, and date ranges, etc. Both include and exclude filters are available for IP addresses/Domain names and file names.

Sample output from iisstat, both HTML and graphs.

For distribution, the iisstat program is available as a gzip tar file from ftp.support.lotus.com in the directory /pub/utils/InternetServices/iisstat

The distribution consists of the following files:

iisstat.pl -- the program
stats.cfg -- configuration file
CHANGELOG -- List of the program change history
LOGFORMATS -- Server log format documentation
TODO -- List of things to do to iisstat

To run iisstat, you need:

Perl, the Practical Extraction and Report Language.

To produce graphs with iisstat, you must have:

xmgr, v3.01. This is the plotting package that creates the graphs.
ImageMagick, used to do image file conversion. Creates the final GIF image file.
Ghostscript, needed by ImageMagick.

iisstat does not make any changes to or write any files in the server directories. Thus, it can be safely run by any user that has read access to the log. This allow users to run there own customized reports.


=======================================================================================
  NOTE: It does not currently work on 5.0.
        Since 5.0 does not execute the Report subroutine correctly
	on 5.001e the report will run sometimes and core dump at other times
=======================================================================================

Version History

Known problems: Still having problems under Perl 5.0, but it is better with 5.001e
Version 1.05a -- September 21, 1995: Minor changes: added -o and changed -Y to report percentages instead of hits
Version 1.05 -- September 13, 1995: There are some new configurable variables in iisstat and new settings in the configuration file. Please look at both before using -R or -z options; New options: -z ( report by company name ); Added databases to store HostNames and Company Names found ( -R & -z ); Bug fixes
Version 1.04 -- August 1, 1995: New options: -Y ( file report with HTML links to the files ), -X ( process EMWAC log ), -n ( No report summary ), -L ( limit number of items in the report ); Improved invalid line checking for Gopher logs
Version 1.03 -- May 26, 1995: New option: -G ( process Gopher log ); Changed temp file names to allow multiple reports to run and create graphs at the same time
Version 1.02 -- May 10, 1995: Changed some options: n -> N, G -> C, z -> Z. This was for consistency and preparation for new options; New option: -g ( only include guest users { for FTP only }); New features: address/host & file/path include pattern lists; Moved configuration file to program directory; Fixed Start & End dates options; Changed name truncation in reports
Version 1.01 -- April 25, 1995: First public release on the Internet

Wanted!!

Suggestions for new features that are desired by administrators
Comments, improvements, bug reports, patches, and enhancements are appreciated. Please send them to Steven Nemetz at [email protected]

This program is provided "AS IS" with absolutely no express or implied warranties of any type.

Steven Nemetz <[email protected]>
Lotus Development Corporation
IBM Corporation