blob: 6fd11dff31fe601b3491f4f1e59a83db45a98b9d (
plain)
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
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
|
<html><head>
<title>Apache module mod_status</title>
</head><body>
<!--#include virtual="header.html" -->
<h1>Module mod_status</h1>
The Status Module is only available in Apache 1.1 and later.<p>
<h2>Function</h2>
The Status module allows a server administrator to find out how well
their server is performing. A HTML page is presented that gives
the current server statistics in an easily readable form. If required
this page can be made to automatically refresh (given a compatible
browser). Another page gives a simple machine-readable list of the current
server state.
<p>
The details given are:
<ul>
<li>The number of children serving requests
<li>The number of idle children
<li>The status of each child, the number of requests that child has
performed and the total number of bytes served by the child (*)
<li>A total number of accesses and byte count served (*)
<li>The time the server was started/restarted and the
time it has been running for
<li>Averages giving the number of requests per second,
the number of bytes served per second and the average number
of bytes per request (*)
<li>The current percentage CPU used by each child and in total by
Apache (*)
<li>The current hosts and requests being processed (*)
</ul>
A compile-time option must be used to display the details marked "(*)" as
the instrumentation required for obtaining these statistics does not
exist within standard Apache.
<h2>Enabling Status Support</h2>
To enable status reports only for browsers from the foo.com
domain add this code to your <code>access.conf</code> configuration file
<pre>
<Location /server-status>
SetHandler server-status
<Limit GET POST>
order deny,allow
deny from all
allow from .foo.com
</Limit>
</Location>
</pre>
<p>
You can now access server statistics by using a Web browser to access the
page <code>http://your.server.name/server-status</code>
<h3>Automatic Updates</h3>
You can get the status page to update itself automatically if you have
a browser that supports "refresh". Access the page
<code>http://your.server.name/server-status?refresh=N</code> to refresh the page
every N seconds.
<h3>Machine Readable Status File</h3>
A machine-readable version of the status file is available by accessing the
page <code>http://your.server.name/server-status?auto</code>. This is useful
when automatically run, see the Perl program in the <code>/support</code>
directory of Apache, <code>log_server_status</code>.
<h2>Full Instrumentation</h2>
To obtain full statistics you must compile Apache with a special
directive. On some machines there may be a small performance loss
if you do this. Try full statistics and see if you notice any
difference. If you do please contact <a href="mailto:mark@ukweb.com">
mark@ukweb.com</a> and tell me your configuration.
<p>
Do this by adding the following to the AUX_CFLAGS line in the
"Configuration" file and then recompiling as usual.
<pre>
AUX_CFLAGS= (something) -DSTATUS
</pre>
<!--#include virtual="footer.html" -->
</BODY>
</HTML>
|
