What are log files,
and how do I use them?
I get an error from Analyzer that says there is no referrer information. How to I get Analyzer to recognize my referrer information?
If you are receiving this error and are not using an Apache server, there is little you can do, other than to try to get your Web Hosting provider or Webmaster to switch your log files into Combined Log File format. The referrer information is simply not in the log file.
Apache web servers often store the log file data in separate files, generally called 'access.log', 'agent.log', and 'referer.log'. You must configure Analyzer to recognize these files. To do this, simply edit your report and check the "Apache multiple file format" button (on the second page of the report wizard). You can read more about configuring the Apache web server for use with Analyzer.
Analyzer reports that my IIS log files are unrecognized. How do I fix this?
You can read more information about configuring IIS.
Is there any
way I can automatically run a report from the command line?
To use this feature, simply type the following:
Analyzer.exe /AUTOREPORT "Report Name"
Analyzer will automatically run your report. Note that if the report name is enclosed in quotation marks ö you should include quotation marks too. The "Report Name" should be the name of the report as listed in the Report List dialog. Analyzer will not close after the report has been processed.
The times reported in my log file are off by several hours. How do I adjust them?
It is common for the time data in your log files to be recorded in an inappropriate time zone. To correct this, Analyzer allows you to add or subtract an offset to the hour recorded in the log file. This problem is common if a thirty party hosts your web site; the third partyâs servers may be located on the opposite side of the country, and in a completely different time zone. You can adjust the offset to any value between -12 and 12. The best way to determine the offset for your log files is to examine the times recorded near the beginning of your log file. If you know what time your web-hosting provider generates the log files, then you can just subtract to determine the offset. It may take some experimentation. Note that some servers record their log files in GMT time (which is 5-8 hours off times in the continental US).
To change the offset, go to the Report menu and choose Options.
The dates reported in my log files are grossly incorrect. I think Analyzer might be confusing the day and month. How do I fix it?
You should check your log files; the time data may be written in European (DD-MM-YY) format. Analyzer, by default, reads log files in United States (MM-DD-YY) date format.
To change the offset, go to the Report menu and choose Options. Make sure "All log files are in European date format" is checked. The changes will take effect when the report is regenerated.
What are the various directories that have been created in my Analyzer directory?
If you have told Analyzer to download your log files from an FTP server, Analyzer will cache the log files that have already been downloaded onto the hard drive. The log files (both compressed and uncompressed, if applicable) are stored in subdirectories of the main Analyzer directory. The name of the subdirectory corresponds to the name of the report the log files are from.
Why can't I
edit Word Documents exported by Analyzer?
Analyzing only a Certain Range of Dates
Often, you only want to analyze, say, the current month of log files. There are several ways to do this:
Often, the filename of a log
file includes the date in it. You can use wildcards in Analyzer to only
analyze a certain month. Take, for example, a directory that contained
the following log files:
Analyzer lets you filter by a range of dates. You should tell Analyzer to analyze all of the log files, but you should click the 'Filter' tab while editing a report. Add a filter for the 'Range of Dates' you desire.
How Do I Move Analyzer To Another Computer?
There are several stages of the transfer:
onto the New Computer
Copy the Reverse DNS
Copy Your Existing Reports
This is the most complicated step. Future versions of Analyzer will be able to do this step automatically. This step is recommended only for advanced users.
Analyzer stores information about your reports in the Windows Registry. You can access the registry by clicking the Start button, clicking Run, and then typing "regedit". Press Enter. Then navigate the "keys" (they look like directories) on the left of the screen and go to HKEY_CURRENT_USER\Software\Mach5 Development\Analyzer\. Select the Analyzer folder on the left. Go to the Registry menu and then click "Export Registry File". Tell regedit where to save the file. Make sure to end the file name in a .REG extension.
Copy the .REG file to your new computer and double-click on it. It should automatically run and restore all of your old Analyzer reports and settings (including your registration code). If double-clicking on the .REG file gives you an error, you should load regedit on the new machine, click the Registry menu, and then choose "Import Registry File".
Can I Schedule Analyzer to Automatically Generate Reports at, say, Midnight?
Yes, you can. Scheduling is not built into Analyzer, but Analyzer can be scheduled by other 3rd party programs. We recommend using the Windows Scheduler (available with Internet Explorer, we believe), and the Windows NT AT.EXE scheduler. Note: Mach5 Development cannot provide support for 3rd party scheduling programs.
You most likely want to export .HTML or .DOC reports to your hard drive or a FTP site. Here's how to set up a Analyzer report so that it can be scheduled:
1. Start Analyzer
2. Select the report you want to schedule. We will be modifying this report to automatically export a report -- you may want to click Copy Report and edit a copy of the report.
3. Click Edit Report.
4. Click the Export tab, select Automatically Export Report and then click the Export Options button.
5. Choose HTML or Word and click Next. (CSV is generally not really appropriate for automatic export).
6. Click Location.
7. Choose either Save the report to my hard drive or Upload to a FTP server. Most of the time, your web site is accessible via FTP -- by uploading your file via FTP, you can often publish reports that are then accessible over the web.
If you choose "Save
the report to my hard drive"
If you choose "Upload
to a FTP server"
You must also specify a username and password for the FTP server. If you would like to log in anonymously, type ãAnonymousä as the username, and enter your e-mail address in the password field. Note that on most servers, an anonymous login will not enable you to upload files, and Analyzer may report an error.
Note about naming files
Note that case does matter. For example, %m is different from %M.
For example, if you specified ãc:\reports\website-stats-%m-%d-%Y.htmlä, it would, depending on the date, evaluate to something like: ãc:\reports\website-stats-02-14-1999.htmlä.
Advanced Tip: programmers may recognize this formatting from the strftime function. Any valid formatting strftime string will work here.
8. Click Ok until you are back to the main Analyzer Report Picker screen.
9. Configure your 3rd party scheduling tool to run the following:
Analyzer.exe /AUTOREPORT "Report Name"
Analyzer will automatically run your report. Note that the report name is enclosed in quotation marks ö you should include quotation marks too. The "Report Name" should be the name of the report as listed in the Report List dialog.
Does Analyzer Show Visitor's Screen Resolutions?
Analyzer does not track screen resolutions for a variety of reasons:
My Web Hosting Provider Doesn't Provide Log Files. Can I use Analyzer?
Yes, you can, thanks to our partnerships with two excellent sites:
Both services are free, and we encourage you to check out both web sites.
© Mach5 Development, 2001