Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
apachetop(1)			  USER COMMANDS 		    apachetop(1)

NAME
     apachetop - display real-time web server statistics

SYNOPSIS
     apachetop	[-f  filename]	[-H hits | -T time] [-q] [-l] [-s segments] [-p]
     [-r secs]

DESCRIPTION
     ApacheTop watches a logfile generated by Apache (in standard common or com-
     bined logformat, and generates human-parsable output in realtime.

     -f logfile
	    Select which file to watch.  Specify this option multiple  times  to
	    watch multiple files.

     -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	informa-
	    tion  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  ei-
	    ther:  Use	-H to say "remember <this many> hits" or   Use -T to say
	    "remember all hits in <this many> seconds" The default (at	the  mo-
	    ment)  is  to  remember hits for 30 seconds.  Setting this too large
	    (whichever option you choose) will cause ApacheTop to use more  mem-
	    ory  and more CPU time. My experimentation finds that remembering no
	    more than around 5000 requests works well.

     -q     Instructs ApacheTop to keep the querystrings, not remove them.

     -l     Instructs ApacheTop to lowercase all URLs, thus /FOO  and  /foo  are
	    treated as the same and accumulate the same statistics.

     -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.

     -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.

     -r secs
	    Set default refresh delay, in seconds.

EXAMPLES
     apachetop -f /var/logs/httpd/access.log

AUTHOR
     Chris Elsworth <chris@cae.me.uk>

REPORTING BUGS
     Report bugs at: https://github.com/tessus/apachetop/issues

SEE ALSO
     https://www.cae.me.uk/projects/apachetop

version 0.15.6			   June, 2015			    apachetop(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=apachetop&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help