Generating Statistics

First, note that you usually will not want to run Wusage more often than once per day. It is recommended that you run Wusage shortly after midnight. However, you can run the program as often as you like, and you can "rotate" (remove or archive) your log files immediately afterwards if you wish. Removing old log files will help performance!

If you have just created a new configuration file through the user interface, and you have not used the Edit Configuration File pages to make any changes, then you are currently configured to produce daily, weekly, monthly, annual and cumulative summary reports.

You will find that Wusage generates reports for the epoch in progress, as well as for time periods that have ended. These reports are useful advance information about the day, week, month, quarter, or year in progress. These figures are also "scaled up" and included in historical graphs, if a significant fraction of the data is already available. You can, however, turn off this feature using the No Partial Reports ^(nopartial) option.

VERY, VERY, VERY IMPORTANT: you may want to keep backups of your log data in case you change your mind about what types of analysis are important to you. What if you decide a year from now that it is very important to see how often a certain document was accessed? Log data is important to your organization -- make a backup copy when you remove it.

Generating Statistics through the User Interface

SECURITY NOTE

We do NOT recommend running the Wusage web-based user interface as root under Unix. Under Windows NT, the web-based user interface should only be used as the administrative user once, in order to unlock the software so that it can be accessed by the AT scheduling command; see the Running Wusage Automatically section. Although Wusage is not designed to provide access to any unrelated information, it is never a good idea to run applications as root when this can be easily avoided by using another account.

Control Page	Up to Main Menu Page
Open Configuration Is:	/home/www/wusage7.0/tests/smallbcom/skbyserver.conf
Use this button to update your statistics to reflect the latest available log data. You must use this option at least once before you can view any statistics.	Update Statistics Now
Use this button to re-generate your statistics from the beginning. Use this button ONLY if you want to discard your previous results completely!	Re-Generate COMPLETELY
Use this button to view your latest statistics. Depending on your configuration, you can also do this via a regular web server.	View Statistics Now
Use this button to answer a question that is not already answered by the reports you have generated. For example, using this button, you can find out how many accesses were made to a specific document, or how many visits came from a particular address.	Quick Queries
Use this button to edit any aspect of your configuration, including filtering, log file locations, report settings, and so on.	Edit Configuration

Fill out these fields if you wish to re-generate reports for a specific period of time. Then click Update Statistics For Time Period, below.

	Month	Day	Year
From	__	__	__
To	__	__	__

Update Statistics For Time Period

---

Wusage 7.0 BETA RELEASE 7

Manual

At least 99% of the time, you will simply want to click on the Update Statistics Now button. When you do this, Wusage will begin to analyze your log data. The length of time this takes can vary depending on the options you have selected and the amount of log data you have, as well as the speed of the computer that is running Wusage. The program will display the number of log file lines that have been analyzed so far as it proceeds. Depending on how many lines have been analyzed previously, you may not see feedback from the program often. Nothing is wrong. Do not press stop!

In rare situations, such as when you have changed your configuration and you want to re-generate reports that have already been written, you will want to fill in the starting and ending dates that need to be re-analyzed and click on the Update Statistics For Time Period button. This feature is mainly used after making a configuration file change. It is also useful if the program was mistakenly used to analyze the wrong log data. If you edit your configuration file and run wusage again, the program will NOT re-generate reports it has already written unless you use Update Statistics For Time Period, or the Re-Generate COMPLETELY button.

Moving On

Generating Statistics From The Command Line

To generate statistics from the command line instead of through the user interface, cd to the directory containing the program and enter the following command:

wusage -c wusage.conf    (or wusage.con under DOS)

Important Unix note: Unix users may need to type ./wusage, not just wusage, to be sure that the program is found.

Note: here it is assumed that your configuration file has been created and has the name wusage.conf (or wusage.con under DOS). See the Configuring Wusage section for more information.

If this is the first time you have run the program, a welcoming message will be displayed. Under normal circumstances, no output will be printed on the screen by Wusage! If your log file is large, it may take some time for wusage to complete its run, especially if the DNS option has been turned on. If your log already contains hostnames for most sites, or if speed is an issue, do not select the DNS option in your configuration file, or set the DNS option to fast, which looks up names that appear in your reports only but does not work with the Ignored Sites ^{(ignoresites)} and Chart Top Domains ^(domains) options.

Note: if your log file is empty, Wusage may indicate that no input was available. This is normal and the message will go away when your log file actually contains accesses. If you do have accesses in log file and you still get this message, your log file may not be in a format that Wusage supports.

Boutell.Com, Inc.
PO Box 16716
Seattle WA 98116
USA
+1 206 658 8176