Readme for analog -- computer output style

[ Top | Up | Prev | Next | Map | Index ]

# Analog 4.16: Computer-readable output style

This section describes the computer-readable output style. You can select this style by the command

    OUTPUT COMPUTER

This 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

    COMPSEP ,

for CSV (comma separated value) format. 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 `RrPpBbDdN` 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.

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 first line of most reports has `f` instead of the normal column letters, followed by the floor for the report, in the form it would be written for a `FLOOR` command, followed by the `SORTBY` using the code letters

`r`
  `REQUESTS`
`p`
  `PAGES`
`b`
  `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.

Need help with analog? Use the analog-help mailing list.

[ Top | Up | Prev | Next | Map | Index ]