NAME

NAME
ata - Apache Transfer-log Analyzer.

DESCRIPTION
ata is the report generator of traffic size and request count.

SYNOPSIS
ata <OPTIONS>

OPTIONS
-file < file_name >
log file name.

-format < regexp >
regular expression for parsing log file.

-f < field_name >
names of the fields a log file. Number of the `()`
into regexp must correspond with number of the
parameters `-f`. Multiple parameter.

-gb < field_name >
group by... Fields names for groupping report file
records... Any names from parameter `-f`. For example
`... -gb req_user -gb method` group by req_user (
/~user_name ) and method ( GET || POST | HEAD ... etc
). Multiple parameter. See examples for more info.

-order_by < field_name >
order by... Ordering output report records. Any names
from parameter `-gb` and two reserved words: 'count' -
request count, 'size' - traffic size. Multiple
parameter.

-txt output report into plain-text format.

-help help.

-unit < unit_name >
unit of traffic ( B, K, M, G - Byte, Kilobyte,
Megabyte, Gigabyte ).

-tr_size_fld < field_name >
field name ( from parameters `-f` ) for traffic size
determination...

-show visible work.

-dump < log_file_name >
dump incorrect log strings to `log_file_name`

EXAMPLES
log file ( logs ):

cs4-mts-18.dialup.mts-nn.ru - - [09/Jun/2002:02:22:18 +0400] "GET /~gosha/path/nidex.html?param HTTP/1.0" 200 1160
217.77.106.6 - - [09/Jun/2002:12:30:17 +0400] "GET /~gosha/hidden_index.html HTTP/1.0" 200 1704
66.28.250.171 - - [09/Jun/2002:20:18:28 +0400] "GET /~gosha/info.html HTTP/1.0" 200 2087
gorka.gcom.ru - - [13/Jun/2002:10:29:47 +0400] "GET /~gosha/ HTTP/1.0" 200 1160
66.28.210.71 - - [15/Jun/2002:10:18:21 +0400] "GET /~alex/cgi-bin/view.cgi?id=1 HTTP/1.0" 200 122087
66.28.210.71 - - [15/Jun/2002:10:19:21 +0400] "GET /~alex/cgi-bin/view.cgi?id=12 HTTP/1.0" 200 3087

command line:

ata -file logs -gb req_user -gb date_day -gb lstatus -txt

result:

Req_user, Date_day, Lstatus Count Size
-------------------------------------------------- ------- ----------
gosha,09,200 3 0,004722 M
alex,15,200 2 0,119375 M
gosha,13,200 1 0,001106 M
------- ----------
6 0,125203 M

command line:

ata -file logs -gb req_user -gb req_name -txt

result:

Req_user, Req_name Count Size
-------------------------------------------------- ------- ----------
alex,view.cgi 2 0,119375 M
gosha,nidex.html 1 0,001106 M
gosha,- 1 0,001106 M
gosha,hidden_index.html 1 0,001625 M
gosha,info.html 1 0,001990 M
------- ----------
6 0,125203 M

command line:

ata -txt -file logs -gb req_user -gb req_ext -order_by req_user -order_by count

result:

Req_user, Req_ext Count Size
-------------------------------------------------- ------- ----------
alex,cgi 2 0.119375 M
gosha,- 1 0.001106 M
gosha,html 3 0.004722 M
------- ----------
6 0,125203 M

NOTES
'Count' and 'Size' - reserved words, do not use this with
parameter `-f`.

Percent calculating only for html report format.

regexp ( `-format` ) matching next log file format ( by default
):

66.28.210.71 gosha - [15/Jun/2002:10:19:21 +0400] "GET /~alex/cgi-bin/view.cgi?id=12 HTTP/1.0" 200 3087

`-f` contain names of the fields ( for ^^^ this string, by
default ):

host = 66.28.210.71
login = gosha
user = -
datetime = 15/Jun/2002:10:19:21 +0400
date = 15/Jun/2002
date_day = 15
date_mon = Jun
date_year = 2002
time = 10:19:21
time_hour = 10
time_min = 19
time_sec = 21
method = GET
request = /~alex/cgi-bin/view.cgi?id=12
req_user = alex
req_path = /cgi-bin
req_name = view.cgi
req_ext = cgi
req_qstring= id=12
proto = HTTP/1.0
lstatus = 200
byte = 3087

any names from first column may be used with parameter `-gb`.

AUTHOR
Okunev Igor V. mailto:[email protected]
http://www.mts-nn.ru/~gosha
ICQ 106183300

OFFICIAL SITE
http://www.mts-nn.ru/~gosha/perl-scripts/ata/hidden_index.html

COPYRIGHT
Copyright (c) 2004 Okunev Igor

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2 of
the License, or (at your option) any later version.