742N/A<!
DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
742N/A <
TITLE>Apache module mod_status</
TITLE>
742N/A<!-- Background white, links blue (unvisited), navy (visited), red (active) --> 742N/A<
H1 ALIGN="CENTER">Module mod_status</
H1>
742N/AThe Status Module is only available in Apache 1.1 and later.<
P>
2852N/AThe Status module allows a server administrator to find out how well
742N/Atheir server is performing. A HTML page is presented that gives
742N/Athe current server statistics in an easily readable form. If required
2946N/Athis page can be made to automatically refresh (given a compatible
1116N/Abrowser). Another page gives a simple machine-readable list of the current
2662N/A<
LI>The number of children serving requests
742N/A<
LI>The number of idle children
1116N/A<
LI>The status of each child, the number of requests that child has
742N/Aperformed and the total number of bytes served by the child (*)
742N/A<
LI>A total number of accesses and byte count served (*)
742N/Atime it has been running for
742N/A<
LI>Averages giving the number of requests per second,
742N/Athe number of bytes served per second and the average number
742N/A<
LI>The current percentage CPU used by each child and in total by
742N/A<
LI>The current hosts and requests being processed (*)
1116N/AA compile-time option must be used to display the details marked "(*)" as
1116N/Athe instrumentation required for obtaining these statistics does not
1116N/Aexist within standard Apache.
1116N/A<
H2><
A NAME="extendedstatus">ExtendedStatus directive</
A></
H2>
1116N/A<!--%plaintext <?INDEX {\tt ExtendedStatus} directive> --> 1116N/A><
STRONG>Syntax:</
STRONG></
A> ExtendedStatus <
EM>On|Off</
EM><
BR>
1116N/A><
STRONG>Default:</
STRONG></
A> <
CODE>ExtendedStatus Off</
CODE><
BR>
1116N/A><
STRONG>Context:</
STRONG></
A> server config <
BR>
1116N/A><
STRONG>Status:</
STRONG></
A> Base<
BR>
1431N/A ><
STRONG>Module:</
STRONG></
A> mod_status<
BR>
1431N/A><
STRONG>Compatibility:</
STRONG></
A> ExtendedStatus is only available
1116N/AThis directive controls whether the server keeps track of extended
1116N/Astatus information for each request. This is only useful if the status module
1116N/AThis setting applies to the entire server, and cannot be enabled or
1116N/Adisabled on a virtualhost-by-virtualhost basis.
1116N/A<
H2>Enabling Status Support</
H2>
1116N/A <Location /server-status>
1116N/AYou can now access server statistics by using a Web browser to access the
1116N/ANote that mod_status will only work when you are running Apache in
1116N/AYou can get the status page to update itself automatically if you have
1116N/Aa browser that supports "refresh". Access the page
1116N/A<
H3>Machine Readable Status File</
H3>
1116N/AA machine-readable version of the status file is available by accessing the
2028N/Awhen automatically run, see the Perl program in the <
CODE>/support</
CODE>
2028N/Adirectory of Apache, <
CODE>log_server_status</
CODE>.
2028N/A It should be noted that if <
SAMP>mod_status</
SAMP> is compiled into
1116N/A the server, its handler capability is available in <
EM>all</
EM>
1116N/A configuration files, including <
EM>per</
EM>-directory files
1116N/A (<
EM>
e.g.</
EM>, <
SAMP>.htaccess</
SAMP>). This may have
1116N/A security-related ramifications for your site.