Analog CE 6.0: Analog's reports

You can get descriptions of each report within the output by using the DESCRIPTIONS and DESCFILE commands.

Note: The examples below are in the HTML output style. Most people are using the XHTML output style, but I've used the HTML output style for the documentation to make sure that it works on all browsers.

Top lines

General Summary

The figures in parentheses represent the seven days given at the top of this report: it's the seven days before the TO time if there was a TO command, or if not the seven days before the program was run.

You can't find out the number of visitors or visits you've had, and don't believe any program which tells you that you can. See the section on How the web works for a discussion of this.

You can turn this report on or off with the GENERAL command. You can control which lines are included using the GENSUMLINES command. You can include or exclude the figures for the last seven days with the LASTSEVEN command. You may get slightly different lines to those above, depending on exactly what's in your logfile.

Time reports

week beg.: #reqs: pages: 
---------: -----: -----: 
13/Sep/98: 69614: 25277: 
20/Sep/98: 10032:  5861: 

The timezone is whatever your server records time in -- usually your server's local time, or sometimes GMT. You can adjust it to another timezone with the LOGTIMEOFFSET command.

You can control whether each report is included or not with the appropriate ON or OFF command. You can control which columns are listed by the COLS commands. You can control which measurement to use for the bar charts and the "busiest" line by the GRAPH commands. You can determine how many rows are displayed with the ROWS commands. You can display the lines backwards or forwards in time by the BACK commands. You can change the graphic used for the bar charts with the BARSTYLE command.

Time summaries

day: #reqs: pages: 
---: -----: -----: 
Sun:  2031:  1193: 
Mon:  8001:  4668: 
Tue:     0:     0: 
Wed: 13934:  5915: 
[etc.]

You can control whether each report is included or not with the appropriate ON or OFF command. You can control which columns are listed by the COLS commands. You can control which measurement to use for the bar charts by the GRAPH commands. You can change the graphic used for the bar charts with the BARSTYLE command.

Other reports

#reqs: %bytes:       last date: file
-----: ------: ---------------: ----
 4123:  2.29%: 21/Sep/98 01:57: /~sret1/analog/
 3064:  0.15%: 21/Sep/98 01:54: /~sret1/analog/analogo.gif
 1737:  0.01%: 21/Sep/98 01:53: /~sret1/images/bar1.gif
 1692:  0.01%: 21/Sep/98 01:53: /~sret1/images/bar16.gif
 1685:  0.01%: 21/Sep/98 01:53: /~sret1/images/bar8.gif
67345: 97.54%: 21/Sep/98 02:04: [not listed: 8,175 files]

• The Host Report lists all computers which downloaded files from you.
• The Domain Report lists which countries those computers came from. (If you only get "unresolved numerical addresses", see the FAQ.)
• The Organisation Report attempts to list the organisations (companies, institutions, ISPs etc.) which the computer was registered under.
• The Host Redirection Report and Host Failure Report list all computers which encountered redirections or errors.
• The Request Report (the example above) lists which files were downloaded.
• The Directory Report lists which directories those files came from.
• The File Type Report lists the file types (actually, extensions) of those files.
• The File Size Report breaks them down by size.
• The Processing Time Report shows the time taken to serve each file.
• The Redirection Report lists the filenames which resulted in redirections: mainly directories without the final slash, and "click-thru"'s.
• The Failure Report lists the filenames which caused errors.
• The Referrer Report lists which pages linked to your files (and also pages which included your images).
• The Referring Site Report lists the servers those referrers were on.
• The Search Query Report and the Search Word Report list which search terms people used to find your site (provided you've used the appropriate SEARCHENGINE commands).
• The Internal Search Query Report and Internal Search Word Report list the search terms people used on scripts within your site (provided you've used the appropriate INTSEARCHENGINE commands).
• The Redirected Referrer Report lists the referrers which led to redirections.
• The Failed Referrer Report is essentially a broken link report.
• The Browser Report lists the detailed versions of browsers used, and the Browser Summary collects them by vendor. You should be aware that browsers can lie about what sort of browser they are.
• The Operating System Report lists the operating systems of the visitors whose browser types you know (as far as possible: it's not always possible to distinguish accurately between different Windows versions, for example, because the same browser can run on more than one Windows version). Which browsers count as robots is controlled by the ROBOTINCLUDE and ROBOTEXCLUDE commands.
• The Virtual Host Report lists the activity of your various virtual domains.
• The Virtual Host Redirection Report and Virtual Host Failure Report give the number of redirections and errors on each of those domains.
• The User Report lists your visitors if your server requires authentication; or perhaps the visitors' cookies or session ids.
• The User Redirection Report and User Failure Report list the users who encountered redirections or errors.
• The Status Code Report lists the number of each HTTP status code that you had.

There are lots of commands which control these reports. As usual, you can control whether each report is included or not with the appropriate ON or OFF command. You can control which columns are listed with the COLS commands. You can change how the reports are sorted with the SORTBY commands. You can control how many items are listed with the FLOOR commands. You can control whether and how the pie charts are plotted with the CHART commands. You can list the time period covered by each report with the REPORTSPAN command. You can include or exclude individual items with the output INCLUDE and EXCLUDE commands. You can change the names of items in the reports with the output alias commands. Which files are linked to in the reports is controlled by the LINKINCLUDE and LINKEXCLUDE commands. The links are also affected by the BASEURL command.

The "not listed" line at the bottom counts those items which didn't get enough traffic to get above the FLOOR for the report. (It doesn't include items which you've explicitly excluded.)

Most of these reports have a hierarchical structure, like this example for the Domain Report:

no.: #reqs: %bytes: domain
---: -----: ------: ------
  1: 13243: 16.23%: .com (Commercial)
   :  1262:  1.26%:   aol.com
  2: 11783: 25.64%: .jp (Japan)
   :  9592: 22.19%:   ad.jp
   :  1043:  1.97%:   co.jp
  3: 10073: 11.62%: .net (Network)
   :  1926:  1.71%:   uu.net
  4:  9657: 13.31%: [unresolved numerical addresses]
  5:  7388:  8.04%: .uk (United Kingdom)
   :  5792:  5.74%:   ac.uk
   :  1510:  1.99%:   co.uk
   : 18502: 25.16%: [not listed: 82 domains]

You can control which items are listed on the lower levels by the SUB family of commands. There are also separate sub-SORTBY and sub-FLOOR commands for the lower levels. (These commands are called ARGSSORTBY and ARGSFLOOR for some reports, such as the Request Report.) You can plot the lower levels instead of the top-level items on the pie charts using the CHARTEXPAND commands.

Bottom lines