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

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

directories on
directories nopie
directories off

If turned on, the Chart Documents by Directory ^{(directories)} option indicates that wusage should display a report which breaks down accesses to the server by subdirectory. If the Chart Documents by Directory ^{(directories)} option is set to nopie, no pie chart will be generated. This option is useful to determine which directories on your server are most popular. The Chart Documents by Directory ^{(directories)} option defaults to on.

Since the directories report can be quite large, it is opened in a separate web browser window. Keep that window open to avoid reformatting the report each time you wish to refer to it. Directories are distinguished from regular files by square brackets in the report.

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.

Since there can be many, many files on a web server, the directories option normally only descends to the second level, producing a report of manageable size. However, you can set the program to descend as far as you like using the How Many Levels Deep (Directory Depth)? ^{(directorydepth)} option. The new Javascript-based directory reports of Wusage 8.0 and above do not require as much space, so feel free to increase the directory depth setting, within reason.

The directories report includes several columns of information about the documents in each directory. Depending on your configuration settings, you may see some or all 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 Chart Top Documents ^(documents), How Many Levels Deep (Directory Depth)? ^{(directorydepth)}, Allowed Documents ^(allow), Ignored Documents ^(ignore), Top Directories Report: Show Bytes ^{(directoriesbytes)}, Top Directories Report: Alphabetize Report ^{(directoriesalpha)}, Include Directories Report ^{(directoriesemail)}, and Top Directories Report: Sort by ^{(directoriesorder)}.

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