Wusage 8.0 Manual: totalsgroup

Wusage HomeDownloadRegister!FAQManualsExamplesNewsNew in 8.0UpgradeBoutell.Com, Inc.

Wusage 8.0 Manual

`totalsgroup` Option

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

1. Edit Configuration
2. Configure Reports...
3. Historical Totals (Bar Charts)...
4. Items to be Charted...

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

totalsgroup
#One or more entries, one per line.
#Options and category are not required. If the category
#does not appear, documents is assumed.

[options] [category] pattern label

#Permissible options are: nograph nototal function yeartoyear subtype [keyword]
#Permissible categories are: documents notfound sites proxysites
#useragents referrers referringsites authusers domains os visits trails
end totalsgroup

Example

#Simple examples
totalsgroup
#All accesses to the entire site
* Overall Accesses
end totalsgroup

#All accesses to the home page of the site;
#note that the Remove These Suffixes ^(suffixes) option must be
#set correctly for this to work well
totalsgroup
/ Home Page Accesses
end totalsgroup

#Compare accesses to three different directories, in a single graph.
totalsgroup
@/marketing|/marketing/*
/sales|/sales/*
/shipping|/shipping/*
end totalsgroup

#Intermediate example, analyzing more than just documents
totalsgroup
#Compare AOL users to Earthlink users. Works only if 
#the DNS Resolution (IPs->Names) ^(dns) option is set to on
#(or if full hostname data is already in the log files).
#Note the use of the sites keyword.
sites *aol.com
sites *earthlink.com
end totalsgroup

#Advanced example: advertising clickthroughs
totalsgroup
/images/bobsad.gif Views of Bob's Ad
end totalsgroup
totalsgroup
/cgi-bin/clickthrough.cgi/CT=http_3a_2f_2fwww_2ebobs_2ecom_2f Clickthroughs
end totalsgroup
totalsgroup
function {Clickthroughs}/{Views of Bob's Ad}*100.0 Clickthrough Rate (%)
end totalsgroup

#Default settings of Wusage 8.0: note the use of subtypes.
#The 'totals' option is a convenient shortcut which places 
#each entry in its own totalsgroup and is otherwise
#identical to totalsgroup.

totals
yeartoyear * All Files Served
yeartoyear documents subtype pages * Page Views
yeartoyear sites unique Unique IP Addresses
yeartoyear users unique Cookies Used At Least Twice
yeartoyear visitors unique Unique Visitors (Best Method)
yeartoyear / Home Page Views
end totals

Description

Note: in the web-based user interface, all of the totals entries are edited on a single page. when you add a "separator" using the Add Group Separator button, you are creating a new "totalsgroup--" a separate bar graph.

The Items to be Charted ^{(totalsgroup)} option, which can appear more than once in a configuration file, is used to generate charts showing how certain items have changed over time. Each entry in the totalsgroup option contains a pattern or regular expression and a title for that pattern. See the Patterns and Regular Expressions section for more information. Wusage will count the total number of accesses to, and bytes served of, and user visits featuring that pattern, and (except for Summary Reports ^(summary) reports) a single bar graph comparing the popularity of those patterns over time will be generated. Unlike the older ^(totals) option, one combined bar chart is generated for all of the items. This is useful for making comparisons. To present a separate bar chart for each item, use a separate Items to be Charted ^{(totalsgroup)} option for each item (in the user interface, just use the Add Separator button to add a graph separator after each item). Or use the ^(totals) option, which is identical except that each entry receives its own separate chart.

Tracking More Than Just Documents

In addition to document accesses, the following additional types of information can be measured using the totals option. Patterns which track sites, referring URLs, and so on look just like patterns used to track documents, except for the identifying keyword which appears first on the line. Note that separate reports are also available that provide more information about each of these topics. For your convenience, links to the appropriate sections of the documentation are provided in the table below.

To Measure...	Use This Keyword	See Also...
Documents	documents	Chart Top Documents ^(documents)
Missing Files	notfound	Chart Top Documents Not Found ^(notfound)
Accessing Sites	sites	Chart Top Sites ^(sites)
Sites Accessed via Proxy Server	proxysites	Chart Top Proxy Sites ^(proxysites)
User Agents (Web Browsers)	useragents	Chart Top Web Browsers ^(useragents)
Referring URLs	referrers	Chart Top Referring URLs ^(referrers)
Referring Sites	referringsites	Chart Top Referring Sites ^{(referringsites)}
Authorized Users	authusers	Chart Top Authorized Users ^(authusers)
Domains	domains	Chart Top Domains ^(domains)
Domains Accessed via Proxy Server	proxydomains	Chart Top Proxy Domains ^{(proxydomains)}
Operating Systems	os	Chart Top Operating Systems ^(os)
Visits	visits	Show Example Visits ^(visits)
Trails	trails	Chart Top Trails ^(trails)
Users (Cookies)	users	Chart Top Users as Determined by Cookies ^(users)
Unique Visitors (Best Method)	visitors	see note

Tracking Unique Sites (or Documents, or...)

Often it is desirable to know how many unique sites visited your server. That is, if the server is accessed a thousand times, this does not mean that 1,000 different people accessed the server. To track the number of unique items, use the special keyword unique instead of a normal pattern.

About Unique Visitors
Beginning with Wusage 8.0 P14, the best available measurement of the number of unique visitors is always available in a single location. When user-identifying cookies are accepted by at least 5% of visitors, this figure is calculated by determining the number of cookies logged at least twice, then adding the total number of accesses made by users not accepting cookies divided by the average number of accesses made by users who did accept cookies. The resulting figure is a highly useful projection of true unique visitors. When cookies are not available, the number of unique IP addresses is used. To use this value in the historical totals report, choose visitors under the Matches... heading and enter the pattern unique. If editing the configuration file directly, use visitors unique as the pattern to be matched.

About Trail and Visit Patterns
It is possible to match visits that included particular document. This results in a count of the number of visits that crossed that document. It is also possible to match trails that mention a particular document, in which case the number of unique paths crossing that document is measured. For example:
visits http://*yahoo.com*/product/download.html* Yahoo -> Product Download Page
This entry counts the number of visits that began on Yahoo and passed through a particular page. Note that "outside" URLs like this can be included only if referring URLs are present in your log files.

Functions

The advanced example shown here includes a special function line. Instead of matching a certain document, this line's value is computed by performing arithmetic on the other entries. Functions can use the + (addition), - (subtraction and negation), * (multiplication), and / (division) operators. Numbers can appear, with or without a decimal point. Calculations are carried out according to the normal rules of algebra. Parentheses are also allowed. Most importantly, references to the results of of earlier lines are allowed, much like references to another cell in a spreadsheet program. Functions can make a reference to the result of any prior entry. In the above example, {Clickthroughs} refers to the result of the previous line which matched all outgoing clicks going to a particular advertiser's site. The clicks are counted through the use of the provided clickthrough.cgi CGI program.

If you wish to refer to the number of bytes measured by a previous entry, instead of the number of accesses, add a space and the word "bytes" after the name of the previous entry, before the closing }.

NOTE THAT THERE SHOULD BE NO SPACES IN A FUNCTION, EXCEPT BETWEEN { AND }. Otherwise the function will be confused with its label.

When You Don't Want A Graph

If you do not want a particular line's result to be graphed, put the special keyword nograph in front of the line:

nograph /cgi-bin/bob Accesses to Bob

This line's value will still be calculated, and it will appear in the table of results, but it will not be graphed.

When You Don't Want A Total (in the Table of Results)

If you do not want the values over time for a particular line to be summed for a grand total in the table of numeric results, which normally shows the average, total and latest values for each line, put the special keyword nototal in front of the line:

nototal /cgi-bin/bob Accesses to Bob

This is useful when it would be meaningless to add up the values from different days, weeks or months. (For instance, it does not make sense to add up each week's clickthrough percentages for a "grand total.")

Putting It All Together

Note that you can use nograph, nototal and function together, if you wish to do so. This is useful when you wish to compute something in several steps and refer to the results of each step in another function later in the configuration file.

Year-To-Year Comparison

Wusage 7.0 adds the option of year-to-year comparison. When you select this option, each year of data will receive its own bar chart color, allowing years to be compared. When you choose this option, each entry in the Items to be Charted ^{(totalsgroup)} option will receive its own bar chart. If you are editing your configuration file by hand, you will specify this option by inserting the word yeartoyear at the beginning of the line, follwed by a space:

yeartoyear / Home Page Accesses

Important note: the yeartoyear option automatically disables itself when only one year appears in the data set. This ensures readability.

yeartoyear can be combined with other options.

Specifying an Object Type

Wusage 8.0 adds the option of matching only accesses to documents of a particular subtype (object type). For more information about object types, see Object Types ^(subreports).

If you are editing your configuration file by hand, you will specify this option by inserting the keyword subtypes in the list of options at the beginning of the line, follwed by a space, followed by the keyword of the appropriate subtype and another space:

yeartoyear documents subtype pages * Page Views

subtype can be combined with other options.

See also Include Totals Report ^{(totalsemail)}, Historical Totals (Bar Charts): Chart by ^{(totalsorder)} and Historical Totals (Bar Charts): Show Visits ^{(totalsvisits)}.

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

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