| 1 | .TH apachetop 1 "February 13, 2004" "version 0.10" "USER COMMANDS" |
|---|
| 2 | .SH NAME |
|---|
| 3 | apachetop \- display real-time web server statistics |
|---|
| 4 | .SH SYNOPSIS |
|---|
| 5 | .B apachetop [-f filename] [-H hits | -T time] [-q] [-l] [-s segments] [-p] [-r secs] |
|---|
| 6 | .SH DESCRIPTION |
|---|
| 7 | ApacheTop watches a logfile generated by Apache (in standard common or |
|---|
| 8 | combined logformat, and generates human-parsable output in realtime. |
|---|
| 9 | .OPTIONS |
|---|
| 10 | .TP |
|---|
| 11 | -f logfile |
|---|
| 12 | Select which file to watch. |
|---|
| 13 | Specify this option multiple times to watch multiple files. |
|---|
| 14 | .TP |
|---|
| 15 | -H hits | -T time |
|---|
| 16 | These options are mutually exclusive. Specify only one, if any at |
|---|
| 17 | all. They work as follows. ApacheTop maintains a table of |
|---|
| 18 | information internally containing all the relevant information about |
|---|
| 19 | the hits it's seen. This table can only be a finite size, so you |
|---|
| 20 | need to decide how big it's going to be. You have two options. |
|---|
| 21 | You can either: |
|---|
| 22 | Use -H to say "remember <this many> hits" |
|---|
| 23 | or Use -T to say "remember all hits in <this many> seconds" |
|---|
| 24 | The default (at the moment) is to remember hits for 30 seconds. |
|---|
| 25 | Setting this too large (whichever option you choose) will cause |
|---|
| 26 | ApacheTop to use more memory and more CPU time. My experimentation |
|---|
| 27 | finds that remembering no more than around 5000 requests works well. |
|---|
| 28 | .TP |
|---|
| 29 | -q |
|---|
| 30 | Instructs ApacheTop to keep the querystrings, not remove them. |
|---|
| 31 | .TP |
|---|
| 32 | -l |
|---|
| 33 | Instructs ApacheTop to lowercase all URLs, thus /FOO and /foo are |
|---|
| 34 | treated as the same and accumulate the same statistics. |
|---|
| 35 | .TP |
|---|
| 36 | -s segments |
|---|
| 37 | Instructs ApacheTop to only keep the first <segments> parts of the |
|---|
| 38 | path. Trailing slashes are kept if present. Statistics are then |
|---|
| 39 | merged for each truncated url. |
|---|
| 40 | .TP |
|---|
| 41 | -p |
|---|
| 42 | Instructs ApacheTop to keep the protocol (http:// usually) at the |
|---|
| 43 | front of its' referrer strings. Normal behaviour is to remove them |
|---|
| 44 | to give more room to more useful information. |
|---|
| 45 | .TP |
|---|
| 46 | -r secs |
|---|
| 47 | Set default refresh delay, in seconds. |
|---|
| 48 | .SH EXAMPLES |
|---|
| 49 | .TP |
|---|
| 50 | apachetop -f /var/logs/httpd/access.log |
|---|
| 51 | .SH AUTHOR |
|---|
| 52 | Chris Elsworth <chris@shagged.org> |
|---|
| 53 | .SH SEE ALSO |
|---|
| 54 | http://clueful.shagged.org/apachetop/ |
|---|
