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...
- -desc
-
reverse sorting.
- -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 3087command line:
ata -file logs -gb req_user -gb date_day -gb lstatus -txtresult:
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 Mcommand line:
ata -file logs -gb req_user -gb req_name -txtresult:
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 Mcommand line:
ata -txt -file logs -gb req_user -gb req_ext -order_by req_user -order_by countresult:
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 MNOTES
'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 = 3087any names from first column may be used with parameter `-gb`.
AUTHOR
Okunev Igor V. mailto:igor@prv.mts-nn.ru
http://www.mts-nn.ru/~gosha
ICQ 106183300OFFICIAL SITE
http://www.mts-nn.ru/~gosha/perl-scripts/ata/
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.