Administrator's Guide - Statistics

Contents

Overview

Perl scripts compile user usage and streaming statistics from log files. A cgi-bin perl script provides a web interface to view these compiled statistics.

The usage statistics are based on all users, admin and non-admin, on the production server. Streaming statistics are based on all streaming done by Darwin Streaming Server which includes both the production and cataloging server.

Statistics Generation

Two perl scripts,bin/generateQTstats.pl and bin/generateStats.pl, generate comma-deliminated files containing general statistics on user usage and streaming by crawling log files. For information on usage see this page. These scripts should be setup to run as cron jobs to automatically update the statistics files.

The statistics generated have the notion of three different classifications of users: In Library, On Campus, and Off Campus. In order for the statistics to be generated correctly, text files listing ip addresses in the first two groups need to be made. Wildcard expansion can be used in these files like the example below.

############################################
#    On campus Machine IP Ranges           #
#                                          #
############################################

129.79.[0-9]*.[0-9]*
156.56.[0-9]*.[0-9]*

viewStats.cgi

To view the compiled statistics, access the perl cgi-bin page viewStats.cgi located at public_html/stats/ and online at http://yourdomain.edu/variations/stats/viewStats.cgi. Usage information can be found here.

To keep unauthorized viewing of statistics, default .htaccess and .htpasswd files require a username/password (dmlstats/stats) for access to viewStats.cgi. This default should be changed for optimal security.