Wusage: Silly Name, Serious Stats!

Wusage 8.0 Manual

documents Option

To reach this option in the configuration file editor, follow these steps:

1. Edit Configuration
2. Configure Reports...
3. Top Documents Report...
4. Chart Top Documents

If you prefer to manually edit your configuration files, use the following syntax for this option:



Example
#Include the top documents report
documents on
#Include the report, but don't draw a pie chart
documents nopie
#Don't include the report
documents off

Description

If turned on, the Chart Top Documents (documents) option indicates that wusage should output information about the most frequently accessed documents on the server. If the Chart Top Documents (documents) option is set to nopie, no pie chart will be generated. This option is useful to determine which documents on your server are most popular. The Chart Top Documents (documents) option defaults to on.

Beginning with Wusage 8.0, the directories report requires Javascript support in your web browser. If Javascript is turned off in your browser, turn it on.

Beginning in Wusage 8.0, each page of the directories report is broken down into subreports for each object type. By default, Wusage 8.0 reports on object types such as Web Pages, Images, Audio, and Video, and also includes a catch-all object type for URLs that do not match these types, called Other. The definitions of these types can be changed; see Object Types for more information.

The documents report presents several pieces of information about each URL mentioned. Depending on your configuration choices, you may see all or only some of the following:

URL
The URL (location) of each document is always displayed.
Title
The title of each web page is displayed, if the Show Document Titles In Reports (documenttitles) option is enabled, and the program was able to successfully access the web site during report generation.
Components
The components that make up a particular web page, such as images and frames, can be listed by clicking on the Components link. This displays a separate, smaller report window which reveals similar information for each of the components of the page.
Accesses
Accesses, or "hits," measure individual requests for the document in question. If a web browser reloads the page five times, this counts as five accesses.
Bytes
The number of bytes (characters) sent in response to requests for the document in question. The larger the file is, the more bytes must be transferred to satisfy a particular number of requests. If your web site's connection has become overloaded, look here for possible culprits.
Visits
The number of distinct user sessions which included at least one access to the document in question. If the user reloads the page five times, this is still only one visit. Visits to several different pages cannot be added together, because a single visit may touch on one or more pages. Visitors are uniquely identified using several criteria, including IP address, web browser, authenticated user name, and user-identifying cookie, when available.
% of Complete Downloads
The percentage of attempted accesses which actually succeeded in obtaining all components of the document in question, including images, frames, and so forth. If a page contains 20 images, and the visitor requests only 15 of them, this counts as an incomplete download. If all 20 images are requested, but the program can determine that the images were not completely sent, this is also an incomplete download. If the user obtains the page only, and NO components at all are requested, this is considered a complete download from a text-based browsing device, indexing agent, web-exploring robot, et cetera. This method is valid because graphics-capable browsers will virtually always attempt to request at least one component of the page. The percentage of complete downloads for an individual image takes into account instances in which the image should have been requested but was not, such as a case in which a page containing the image is requested and that particular image is not requested. Again, if the page is accessed but none of its components are requested, this does not count as a failed attempt to obtain the image.
See also Top Documents Report: Alphabetize Report (documentsalpha), Top Documents Report: Show Bytes (documentsbytes), Top Documents Report: Sort by (documentsorder), Top Documents Report: Show Visits (documentsvisits), Chart Documents by Directory (directories), Object Types (directories), Allowed Documents (allow), and Ignored Documents (ignore).
Table of Contents
Topical Configuration Editor Reference
Alphabetical Configuration Editor Reference
Alphabetical Configuration File Reference
Glossary of Frequently Used Terms

Copyright 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, Boutell.Com, Inc.
wusage@boutell.com
Boutell.Com, Inc - PO Box 16716, Seattle WA, 98116, USA
Phone/Fax +1 206 658-8176
Copyright Statement

All material, including images, on this web site is Copyright 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, Boutell.Com, Inc. unless otherwise noted.
Need more information? Wondering who to contact? Visit our whom page.

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