|
Usage: cat log | ./calamaris [switches]
Reports:
-a all (extracts all reports available,
-a equals -D 10 -d 20 -P 60 -r 20 -s -t 20)
-d n domain (show n Top-level and n second-level destinations,
-1 = unlimited)
-p type peak (measure peak requests)
old = make old request-peak mesurement
new = make new request&byte-peak measurement
(both slow Calamaris significantly down.)
-P n Performance (show throughput data for every n minutes)
-r n requester (show n Requesters, -1 = unlimited)
-R n targets for requester (show n targets for every Requester,
-1 = unlimited), implies -r (*)
-s status (show verbose status reports)
-t n type (show n content-type, n extensions and requested protocols,
-1 = unlimited)
-D n Distribution Histogram (shows size-based distribution of requested
objects, smaller numbers result in more verbose reports.
choose 2, 10 or 100 for useful output. (You can also play
with this ;-))
Input:
-z zero (no input via stdin)
-f type format (sets the type of input logfiles)
auto = tries to guess the input format
(This is the Default)
squid = Native-Logfile derived from Squid V1.1.beta26-V2.x
squid-extended = Native-Logfile with log_mime_hdrs enabled
derived from Squid V1.1.beta26-V2.x (*)
or Cisco Content Engines (*)
or Squid with SmartFilter-patch (*)
squid-old = Native-Logfile derived from Squid
V1.1.alpha1-V1.1.beta25
nc = Squid-style Logfiles derived from NetCache V?? (<5.x)
its = Logfiles derived from Inktomi Traffic Server
elff = Extended Logfile Format (i.e Compaq Tasksmart, Novell
Internet Caching System, NetCache 5.x)
nse = Netscape Extended-1/2 Logfile Format
Output: (Default is plain formatted text)
-F type Format (output format (comma-seperated list))
mail = mail format
html = HTML format
html-embed = HTML format without HTML-headers
unformatted = plain unformatted output
-l string logo (add this string to the head of the report. works only in
combination with -F html)
-M string Meta (includes the given strings in html-<head>. works only in
combination with -F html)
-H name Host-name (a name for the Output, -H 'lookup' issues a lookup for
the current host)
-O Order (changes the sort order in the reports to request size,
default is sorting by number of requests)
-N n N-level (change all 2nd-level-reports to N-level-reports. N can be
any number from 2 up. -1 means full report.)
-U string Unit (define the Unit for the Byte-values, else it will be auto)
K(ilo), M(ega), G(iga), T(era)
-S list Show (Shows only the defined reports (comma-seperated list) in the
specified order.) The following numbers are defined:
0 Summary
1 Incoming request peak per protocol
2 Incoming transfer volume per protocol
3 Incoming requests by method
4 Incoming UDP-requests by status
5 Incoming TCP-requests by status
6 Outgoing requests by status
7 Outgoing requests by destination
8 Request-destinations by 2nd-level-domain
9 Request-destinations by toplevel-domain
10 TCP-Request-protocol
11 Requested content-type
12 Requested extensions
13 Incoming UDP-requests by host
14 Incoming TCP-requests by host
15 Distribution Histogram
16 Performance in 60 minute steps
(Note: only putting out one report does not speed up Calamaris
as the internal operations were done based on the
report-switches. Default: Reports are displayed based on
activated reports.)
Caching:
-i file input-file (input-datafile for caching, to add many files separate
them with a ':')
-o file output-file (output-datafile for caching, can be the same as -i)
Misc:
-n no-lookup (don't look IP-Numbers up)
-T n Time (adjust the Performance-Report in minutes)
-c case (switch to case-insensitive (useful for extensions-report))
-u user (use ident information if available) (*)
-I t-t Interval (defines which time-interval should be parsed)
t has to be the format yyyymmddhhmmss
omitting the beginning or ending is allowed.
-b n benchmark (prints a hash-sign (#) to stderr for each n lines
processed)
-v verbose (print information what Calamaris is doing. Useful for
debugging.)
-L Loop (dumps the generated internal loop to STDERR for debugging.)
-C copyright (prints the copyright)
-h help (prints out this message)
-V Version (prints version-info)
(*) These options break the privacy of your users. Please read the README
on this.
Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004 Cord Beermann.
Calamaris comes with ABSOLUTELY NO WARRANTY. It is free software, and you are
welcome to redistribute it under certain conditions. See source for details.
Calamaris-Homepage: http://Calamaris.Cord.de/ |
