Analog 5.24:
Computer-readable output style
This section describes the computer-readable output style. You can select this style by the command
OUTPUT COMPUTERThis style is designed to be easy to read into spreadsheets, or post-process with graphics creation tools, for example. You can find some programs which use this style on the helper applications page. However, the computer-readable output style is not suitable for reading back into analog to create later reports: for that job, use the cache files described in the next section.
Each line in the output is separated into fields by means of a special string. You can specify this string by means of the COMPSEP command; for example, you could use
COMPSEP ,for CSV (comma separated value) format. Or you can use
COMPSEP \tto separate fields with a tab. Make sure not to use anything that might occur in the output: for example, a single or double space would not be suitable.
Each line in the preformatted output begins with a letter indicating which report the line is part of. (The code letters for the reports are listed in the section on Configuring the Output.)
After that, there follows a field indicating the remaining columns in the report (using the letters RrSsPpQqBbCcDdEeN as usual). In hierarchical reports (including the reports which can show search arguments) there is an additional column l at the beginning, indicating the level in the hierarchy.
Finally there are the numerical data for each column and then the name of the item. Times actually take up several fields: year, month, date, hour & minute, or as many of those as are necessary to identify the time. (Year and quarter in the case of the Quarterly Report).
So here is an example line from the Domain Report, showing the third-level domain cam.ac.uk with 43 requests and 3.516% of the bytes.
o lRb 3 43 3.516 cam.ac.uk
The last line of most time reports indicates the busiest time period. After the report letter comes *BT, followed by the letter R, P or B for the GRAPH method, followed by the number of requests, pages or bytes respectively for the busiest time period, followed by the time period itself.
The first lines of non-time reports can also contain overall information about the report. First, if the REPORTSPAN for the report is wanted, it will be listed in lines with *FR and *LR instead of the normal column letters. Then there is a line listing the floor and sortby for the report. It has *f instead of the normal column letters, followed by the floor in the form it would be written for a FLOOR command, followed by the SORTBY using the code letters
- r
- REQUESTS
- s
- REQUESTS
- p
- PAGES
- q
- PAGES
- b
- BYTES
- c
- BYTES
- d
- DATE
- a
- ALPHABETICAL
- x
- RANDOM
The general summary is a bit different. After an initial x, there is a two-character code saying what the line contains. The possible codes are
- VE
- Version of analog
- HN
- HOSTNAME
- HU
- HOSTURL
- PS
- Program start time
- FR
- Time of first request
- LR
- Time of last request
- E7
- Time last 7 days ends
- SR
- Total successful requests
- S7
- Total successful requests in last 7 days
- PR
- Total successful requests for pages
- P7
- Total successful requests for pages in last 7 days
- FL
- Total failed requests
- F7
- Total failed requests in last 7 days
- RR
- Total redirected requests
- R7
- Total redirected requests in last 7 days
- NC
- Logfile lines without status code
- C7
- Lines without status code in last 7 days
- NF
- Number of distinct files requested
- N7
- Number of distinct files requested in last 7 days
- NH
- Number of distinct hosts served
- H7
- Number of distinct hosts served in last 7 days
- CL
- Number of corrupt lines in the logfile
- UL
- Number of unwanted lines in the logfile
- BT
- Total number of bytes transferred
- B7
- Total number of bytes transferred in last 7 days
Go to the analog home page.
Stephen Turner
25 June 2002
Need help with analog? Use the analog-help mailing list.