File: apachetop.1

package info (click to toggle)
apachetop 0.19.7-3
  • links: PTS, VCS
  • area: main
  • in suites: bookworm, bullseye, sid
  • size: 324 kB
  • sloc: cpp: 3,005; makefile: 25; sh: 1
file content (56 lines) | stat: -rw-r--r-- 2,079 bytes parent folder | download | duplicates (2)
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
.TH apachetop 1  "June, 2015" "version 0.15.6" "USER COMMANDS"
.SH NAME
apachetop \- display real-time web server statistics
.SH SYNOPSIS
.B apachetop [-f filename] [-H hits | -T time] [-q] [-l] [-s segments] [-p] [-r secs]
.SH DESCRIPTION
ApacheTop watches a logfile generated by Apache (in standard common or
combined logformat, and generates human-parsable output in realtime.
.SH .OPTIONS
.TP
\-f logfile
Select which file to watch.
Specify this option multiple times to watch multiple files.
.TP
\-H hits | \-T time
These options are mutually exclusive. Specify only one, if any at
all. They work as follows. ApacheTop maintains a table of
information internally containing all the relevant information about
the hits it's seen. This table can only be a finite size, so you
need to decide how big it's going to be. You have two options.
You can either:
Use \-H to say "remember <this many> hits"
or	Use \-T to say "remember all hits in <this many> seconds"
The default (at the moment) is to remember hits for 30 seconds.
Setting this too large (whichever option you choose) will cause
ApacheTop to use more memory and more CPU time. My experimentation
finds that remembering no more than around 5000 requests works well.
.TP
\-q
Instructs ApacheTop to keep the querystrings, not remove them.
.TP
\-l
Instructs ApacheTop to lowercase all URLs, thus /FOO and /foo are
treated as the same and accumulate the same statistics.
.TP
\-s segments
Instructs ApacheTop to only keep the first <segments> parts of the
path. Trailing slashes are kept if present. Statistics are then
merged for each truncated url.
.TP
\-p
Instructs ApacheTop to keep the protocol (http:// usually) at the
front of its' referrer strings. Normal behaviour is to remove them
to give more room to more useful information.
.TP
\-r secs
Set default refresh delay, in seconds.
.SH EXAMPLES
.TP
apachetop \-f /var/logs/httpd/access.log
.SH AUTHOR
Chris Elsworth <chris@cae.me.uk>
.SH REPORTING BUGS
Report bugs at: https://github.com/tessus/apachetop/issues
.SH SEE ALSO
https://www.cae.me.uk/projects/apachetop