Note... FastStats Configuration info has moved. Please update your bookmarks or links accordingly.

Up-to-date info on configuring FastStats is here. You will be redirected in 3 seconds.

This information is incorporated into the help pages distributed with FastStats.

 

                            

FastStats Configuration

FastStats And Specific Web Servers
    An Optimal IIS 4.0 Configuration
    All About Apache Multiple FileFormat
    An Optimal Apache Configuration

FastStats and Specific Web Hosting Providers
    How Do I Configure FastStats To WorkWith Best Internet?
    How Do I Configure FastStats To WorkWith Pair Networks?

 

FastStats and IIS 4.0

FastStats is compatible with any log file that contains a very bare minimum of data. You should only read this web page if you are getting a FastStats error or warning. The log file format described on this web page is the most optimal you can get -- it contains the least amount of information that will completely utilize all FastStats features.

The IIS 4.0 and 5.0 web servers allow you to pick and choose what information is put into your log file. Follow these steps to properly configure IIS:

1. Select a Web or FTP site, and click Properties.

2. On the Web Site property sheet, select the Enable Logging check box.

3. Choose W3C Extended Log File Format as the Active log format.

4. Click the Properties button.

5. The Extended Logging Properties dialog box appears. Click Extended Properties (in some versions of IIS, this tab may be called Advanced Properties). Make sure the following fields are selected. Any additional fields will not affect the analysis process. The fields are: Date, Time, Client IP Address, Method, URI Stem, HTTP Status, Bytes Received, Bytes Sent, User Agent, Referrer.

6. Click Apply.

7. Click OK until you have closed all dialog boxes. FastStats will now recognize your log files.

Top


All About Apache Multiple File Format

How do I Tell If My Logs Are in Apache Multiple File Format

Most of the time, all of the log file data is stored in one log file. There may be a new log file for each day, but all of the information about each hit is generally stored in the same file. Apache multiple file format, as the name implies, stores log file data in multiple files:

1. access_log - general information about the page requested, time of the request, etc.
2. agent_log - information about the browser and operating system used to request the file 
3. referer_log - information about the pages that refer (i.e. link) to your web site.
4. error_log - this log is not used. If you tell FastStats to parse this log, it may crash!

Configuring FastStats to handle Apache Multiple File Format

Note: if you host your own web site and can change the log file format, you should read this document. Apache multiple file format is not the best format around (there is duplicate information, and you cannot run filters on an Apache multiple file format log).

Here is a short explanation:

1. Go to the report picker. This is the dialog that appears when FastStats starts up. Inside FastStats, click Report: Switch to Report Picker.

2. Select the report you want to edit (or read the FastStats tutorial for information on adding a new report). Click Edit Report.

3. Click the Apache tab.

4. Place a check in Apache multiple file format.

5. Click either Logs (Local), Logs (FTP), or Logs (Web).

6. You should make sure that FastStats is being told to analyze access_log (and only access_log). FastStats will look for the corresponding referer_log and agent_log. A common problem is to have a directory with access_log, agent_log, referer_log, and possibly error_log. If you tell FastStats to analyze this entire directory, it will give you an error and may even crash on the error_log file. You should tell FastStats to only analyze access_log.

Top


Configuring Apache

This help topic is for people who host their own web site or are allowed to configure their Apache log file format.

Apache lets you specify a custom log file format in the "httpd.conf" configuration file. Although there are a large number of log file formats you can specify, FastStats only supports three of them. However, they are standard formats and contain all of information you need to provide useful data about your web site. Apache can be configured to place the log file information in multiple log files (generally "access.log", "referer.log", and "agent.log"). This is not the most convenient format, although FastStats does support it.

The best format is known as Combined Log File Format and looks like the following:

207.34.71.205 - - [18/Jan/1998:00:02:22 -0500] "GET /index.html HTTP/1.0" 200 16384 "http://www.windows95.com/apps/encrypt-file.html" "Mozilla/2.0 (compatible; MSIE 3.02; Update a; AK; Windows 95)"

It is important to note the referrer and browser information at the end is enclosed by quotation marks. You can configure Apache to generate combined log files by editing the "httpd.conf" file in the \Apache\conf\ directory. Find the following lines in your .conf file (you may want to do a search for the string "LogFormat"). You should change the log file to read as follows:

# This defines a "nickname" for the specified log file format.
# The nickname is "combined".
LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined

# Specify that we want to store the combined log file in the location "logs/combined.log".
CustomLog logs/combined.log combined

Apache should now generate FastStats-readable data in the combined.log file. The other two log file formats are either inconvenient (Apache Multiple Log File Format) or will produce reports that do not contain some very useful information (Apache Common Information).

Top



How Do I Configure FastStats To Work With Best Internet?

This technical support topic describes how to configure FastStats to automatically analyze and download your log files from your account at Best Internet (www.best.com).

1. Make sure that your web site is configured to generate log files. Best has a web page on this topic.

2. Start FastStats.

3. Click Add Report

4. We will be downloading the log files from the Best Internet FTP server, so choose The log files are stored on a FTP site and click Next.

5. Best does not store the log files in the Apache Multiple File Format. So leave the checkbox empty and click Next.

6. FastStats will download your log files from the Best FTP server. For FTP Site Name, type the shell account address Best provided you. This will look like ftpX.ba.best.com or fpage1.ba.best.com. In the Username and Password fields, type your username and password.

7. Best stores its log files in the public_html directory. The log files look like this: httpd_access.x, where 'x' is generally a number from 1 to 30. If your log files are compressed, they will have a .gz file extension. FastStats will automatically recognize and decompress these .gz files. So select Parse all logs that match this wildcard and type public_html/httpd_access.*

8. The rest of the report should be relatively straightforward to configure. You can read a walkthrough here.

Top


How Do I Configure FastStats To Work With Pair Networks?

This technical support topic describes how to configure FastStats to automatically analyze and download your log files from your account at Pair Networks (www.pair.com).

1. In order to get the most out of FastStats (and any other log file analysis tool, for that matter), you should configure your log files to generate Agent and Referrer information. Pair has a technical support document on this.

2. Start FastStats.

3. Click Add Report

4. We will be downloading the log files from the Pair Networks FTP server, so choose The log files are stored on a FTP site and click Next.

5. Pair  does not store the log files in the Apache Multiple File Format. So leave the checkbox empty and click Next.

6. FastStats will download your log files from the Pair FTP server. For FTP Site Name, type the shell account address Pair  provided you. This will look like gao.pair.com or upsilon.pair.com. In the Username and Password fields, type your username and password.

7. Pair stores its log files in the www_logs directory. The log files look like this: www.date. Pair will automatically compress your log files if they are greater than a threshold (typically 100 kilbytes). Compressed log files have .gz at the end of their filenames. FastStats will recognize and automatically decompress any .gz files. Select Parse all logs that match this wildcard and type www_logs/www*

8. The rest of the report should be relatively straightforward to configure. You can read a walkthrough here.

If you have any questions, e-mail support@mach5.com. We'll get back to you ASAP.

Top

 

Home | Products | Support | Download Software | Resources | Search
FastStats | Introduction Tutorial | General Tutorial | Filters Tutorial | Configuration | Troubleshooting
Mach5 Mailer | FAQ | Troubleshooting
Spam Policy | About this Site

© Mach5 Development, 2000