Wusage 8.0 ManualServer Configuration Tips
Tips for the Apache serverThe free Apache web server, which we highly recommend for use on Unix platforms, can be easily configured to produce user agent and referrer logs. You may have already configured your server to log this information in separate log files, and Wusage can analyze these; see the Command Line Options section.However, this is not the best way. When your referrer and user agent logs are separate, Wusage cannot display these reports as part of your normal daily, weekly or monthly usage reports. We recommend that you take the following steps: 1. Make sure the mod_log_config and mod_usertrack Apache "modules" are compiled into your server. See the Apache documentation for details.
2. Add the following line to your FOR APACHE 1.2 OR BETTER, WITH THE MOD_USERTRACK MODULE:
LogFormat "%h %l %u %t \"%r\" %s %b %v \"%{Referer}i\" \"%{User-agent}i\" \"%{Cookie}n\""
FOR APACHE WITHOUT THE MOD_USERTRACK MODULE:
LogFormat "%h %l %u %t \"%r\" %s %b %v \"%{Referer}i\" \"%{User-agent}i\""
(Note that referrer must be spelled with only two r's when
configuring Apache. For Wusage, we chose to go with the spelling
in the dictionary.)
3. When you have done both of these things, restart
the Apache server on the fly using the
The Apache server will now log information in the usual "common log format,"
with the addition of three new fields, virtual
server name, referrer and user agent, and a fourth "cookie field"
uniquely identifying the user if you have compiled Apache with
the For Microsoft IIS 3.0Microsoft IIS 3.0 does not have the option of logging user agent and referrer information in its basic form. However, a filter that adds this capability is freely available. The filter was written by Marc Grossman of Microsoft, who is in no way associated with Boutell.Com, Inc. Follow this link to obtain the filter. Instructions for installation are in the HTML documentdefault.htm which is included in the
zip file. The filter is distributed by the
ISAPI developer's
site, a useful service run by Steven Genusa. We are not associated
with the ISAPI developer's site in any way. We do not provide
technical support for software not written by Boutell.Com, Inc.
Please see the file default.htm included with
the filter software for installation instructions.
Once you have the filter installed, Wusage will recognize the user agent and referrer fields in the resulting log files. Be sure to turn on the Chart Top Referring URLs (referrers), Chart Top Referring Sites (referringsites), Chart Top Referring URLs by Document (referrersbydocument), (referrersbynotfound), Chart Top Web Browsers (useragents) and Chart Top Operating Systems (os) options in your configuration file. For Microsoft IIS 4.0Microsoft IIS 4.0 supports the new W3C extended log format. For best results, turn on this logging format with all of the optional fields. By default, IIS 4.0 only logs a very limited set of fields.For Other ServersMost web servers can be configured to log in a variety of different formats. For best results, configure your web server to log in the common log format, with the addition of the referrer and user agent fields. The referrer field should come first, followed by the user agent field. Both fields should be in quotes for best results, especially the user agent field, which can contain spaces. If the user agent field cannot be enclosed in quotes, configure your server to place it at the end of the line after all other fields. Wusage will also recognize a virtual server domain name field, if present, and compare this to the (servername) option to determine whether a particular access is relevant.Below is an example of the common log format, extended to include referrer and user agent information. foo.bar.com - - [20/Apr/1997:16:48:44 -0700] "GET /boutell/index.html HTTP/1.0" 200 5898 "http://www.altavista.digital.com/query" "Mozilla/3.01 (Macintosh; I; PPC)"Please note: Boutell.Com does not provide web server configuration technical support. This information is provided purely as a supplement to the manuals of your web server software.
Previous: Wusage and Local Internets (Intranets)
Next: Optimization Settings 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 |