1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head>
<link rel=stylesheet type="text/css" href="anlgdocs.css">
<LINK REL="SHORTCUT ICON" HREF="favicon.ico">
<title>Readme for analog -- computer output style</title>
</head>
<body>
[ <a href="Readme.html">Top</a> | <a href="custom.html">Up</a> |
<a href="domfile.html">Prev</a> | <a href="cache.html">Next</a> |
<a href="map.html">Map</a> | <a href="indx.html">Index</a> ]
<h1><img src="analogo.gif" alt=""> Analog CE 6.0:
Computer-readable output style</h1>
<hr size=2 noshade>
This section describes the computer-readable output style. You can select
this style by the command
<pre>
OUTPUT COMPUTER
</pre>
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 <a href="helpers.html">helper applications</a> page.
However, the computer-readable output style is not suitable for reading back
into analog to create later reports: for that job, use the
<a href="cache.html">cache files</a> described in the next section.
<p>
Each line in the output is separated into fields by means of a special string.
You can specify this string by means of the <kbd>COMPSEP</kbd> command; for
example, you could use
<pre>
COMPSEP ,
</pre>
for CSV (comma separated value) format. Or you can use
<pre>
COMPSEP \t
</pre>
to 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.
<hr size=1 noshade>
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 <cite><a href="output.html#replist">Configuring the
Output</a></cite>.)
<p>
After that, there follows a field indicating the remaining columns in the
report (using the letters <kbd>RrSsPpQqBbCcDdEeN</kbd> as usual). In
<a href="hierreps.html">hierarchical reports</a> (including the reports which
can show search arguments) there is an additional column <kbd>l</kbd> at the
beginning, indicating the level in the hierarchy.
<p>
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).
<p>
So here is an example line from the Domain Report, showing the third-level
domain <kbd>cam.ac.uk</kbd> with 43 requests and 3.516% of the bytes.
<pre>o lRb 3 43 3.516 cam.ac.uk</pre>
<hr size=1 noshade>
The last line of most time reports indicates the busiest time period. After the
report letter comes <kbd>*BT</kbd>, followed by the letter <kbd>R</kbd>,
<kbd>P</kbd> or <kbd>B</kbd> for the
<kbd><a href="timereps.html#GRAPH">GRAPH</a></kbd> method, followed by the
number of requests, pages or bytes respectively for the busiest time period,
followed by the time period itself.
<p>
The first lines of non-time reports can also contain overall information about
the report. First, if the
<kbd><a href="othreps.html#REPORTSPAN">REPORTSPAN</a></kbd> for the report is
wanted, it will be listed in lines with <kbd>*FR</kbd> and <kbd>*LR</kbd>
instead of the normal column letters. Then there is a line listing the floor
and sortby for the report. It has <kbd>*f</kbd> instead of the normal
column letters, followed by the floor in the form it would be written
for a <kbd><a href="othreps.html#FLOOR">FLOOR</a></kbd> command, followed by
the <kbd>SORTBY</kbd> using the code letters
<dl compact>
<dt><kbd>r</kbd><dd><kbd>REQUESTS</kbd>
<dt><kbd>s</kbd><dd><kbd>REQUESTS</kbd>
<dt><kbd>p</kbd><dd><kbd>PAGES</kbd>
<dt><kbd>q</kbd><dd><kbd>PAGES</kbd>
<dt><kbd>b</kbd><dd><kbd>BYTES</kbd>
<dt><kbd>c</kbd><dd><kbd>BYTES</kbd>
<dt><kbd>d</kbd><dd><kbd>DATE</kbd>
<dt><kbd>a</kbd><dd><kbd>ALPHABETICAL</kbd>
<dt><kbd>x</kbd><dd><kbd>RANDOM</kbd>
</dl>
<hr size=1 noshade>
The general summary is a bit different. After an initial <kbd>x</kbd>, there is
a two-character code saying what the line contains. The possible codes are
<dl compact>
<dt><kbd>VE</kbd><dd>Version of analog
<dt><kbd>HN</kbd><dd><kbd>HOSTNAME</kbd>
<dt><kbd>HU</kbd><dd><kbd>HOSTURL</kbd>
<dt><kbd>PS</kbd><dd>Program start time
<dt><kbd>FR</kbd><dd>Time of first request
<dt><kbd>LR</kbd><dd>Time of last request
<dt><kbd>E7</kbd><dd>Time last 7 days ends
<dt><kbd>SR</kbd><dd>Total successful requests
<dt><kbd>S7</kbd><dd>Total successful requests in last 7 days
<dt><kbd>PR</kbd><dd>Total successful requests for pages
<dt><kbd>P7</kbd><dd>Total successful requests for pages in last 7 days
<dt><kbd>FL</kbd><dd>Total failed requests
<dt><kbd>F7</kbd><dd>Total failed requests in last 7 days
<dt><kbd>RR</kbd><dd>Total redirected requests
<dt><kbd>R7</kbd><dd>Total redirected requests in last 7 days
<dt><kbd>NC</kbd><dd>Logfile lines without status code
<dt><kbd>C7</kbd><dd>Lines without status code in last 7 days
<dt><kbd>NF</kbd><dd>Number of distinct files requested
<dt><kbd>N7</kbd><dd>Number of distinct files requested in last 7 days
<dt><kbd>NH</kbd><dd>Number of distinct hosts served
<dt><kbd>H7</kbd><dd>Number of distinct hosts served in last 7 days
<dt><kbd>CL</kbd><dd>Number of corrupt lines in the logfile
<dt><kbd>UL</kbd><dd>Number of unwanted lines in the logfile
<dt><kbd>BT</kbd><dd>Total number of bytes transferred
<dt><kbd>B7</kbd><dd>Total number of bytes transferred in last 7 days
</dl>
Which lines are listed is still controlled by the
<kbd><a href="output.html#GENSUMLINES">GENSUMLINES</a></kbd> command. This
implies that if you turn a line off, you turn off its "last 7 days"
version too.
<hr size=2 noshade>
Go to the <a href="https://www.c-amie.co.uk/software/analog/">Analog CE home page</a>.
<p>
<address>Stephen Turner
<br>19 December 2004</address>
</p>
[ <a href="Readme.html">Top</a> | <a href="custom.html">Up</a> |
<a href="domfile.html">Prev</a> | <a href="cache.html">Next</a> |
<a href="map.html">Map</a> | <a href="indx.html">Index</a> ]
</body> </html>
|
