Sophie

Sophie

distrib > Mandriva > 2010.0 > i586 > media > contrib-release > by-pkgid > af2117b3d480cb88896677b7199e316e > files > 202

analog-6.0-5mdv2010.0.i586.rpm

<!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 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 &amp;
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 &quot;last 7 days&quot;
version too.

<hr size=2 noshade>
Go to the <a href="http://www.analog.cx/">analog home page</a>.
<p>
<address>Stephen Turner
<br>19 December 2004</address>
<p><em>Need help with analog? <a href="mailing.html">Use the analog-help
mailing list</a>.</em>
<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>