4.8 Displaying the operation status (Status information display)

Display number of running processes, number of standby processes, and the status of each process (such as R, W, and L) in the Web browser (number of server threads for Windows version). On the basis of this information, you can tune the StartServers, MinSpareServers, MaxSpareServers, and the MaxClients directive (the ThreadsPerChild directive for Windows version). For details on each directive, see 4.1 Relationship between processes and directives of Cosminexus HTTP Server.

When you set the ExtendedStatus directive to On, more detailed information is displayed.

Organization of this section
(1) Specifying the server-status handler
(2) Specifying URL
(3) Information that can be acquired
(4) Note

(1) Specifying the server-status handler

Specify the server-status handler as follows to use the display functionality of status information:

<Location /server-status>
     SetHandler server-status
</Location>

However, generally the access to the status information of the Web server is controlled and the information is not disclosed to the end-user.

(2) Specifying URL

To display the status information, specify the URL from Web browser in the following format. Note that the server status may be displayed incorrect temporarily depending upon the timings:

http://Host-name[:Port-number]/server-status[?{refresh=Update interval|auto|notable}]

You can specify refresh=updated interval, auto, and notable respectively with the conjunction &. However, the auto is in the plain text, and hence there is no significance of specifying auto together with notable.

example-of-specification

http://www.example.com/server-status?refresh=60&notable

example-of-display

http://www.example.com/server-status

The following figure shows the example of status information display, when the URL is specified as above. The display format varies slightly for UNIX version and Windows version.

Figure 4-11 Example of status information display

[Figure]

(3) Information that can be acquired

The following table describes the information that you can acquire by the status information display functionality. You can acquire the detailed information by setting the ExtendedStatus directive to On.

Table 4-13 Information which can be acquired by using the status information display functionality (without the auto specification)

No.ContentsExplanationValue and acquisition of ExtendedStatus
OffOn
1Server VersionServer versionYY
2Server BuiltServer building timeYY
3Current TimeCurrent timeYY
4Restart TimeStart timeYY
5Parent Server GenerationNumber of times the server process is restarted (initial value 0)YY
6Server uptimeServer process running timeYY
7Total accessesNumber of total accessesNY
8Total TrafficTotal amount of trafficNY
9CPU Usage: u vvv s www cu xxx cs yyy - zzz% CPU loadUser time, system time, user time of the child process, system time of the child process, CPU usage rate (UNIX version)NY
10xxx requests/sec - yyy B/second - zzz B/requestNumber of requests per second, traffic per second, traffic per requestNY
11xxx requests currently being processed, yyy idle workersThe number of server processes during request processing (threads), the number of server processes in the status of request waiting (threads)YY
12ScoreboardOperation status of a single threadYY
13Scoreboard KeyLegend of scoreboardYY
14PID KeyServer process ID and the operation status of a single threadYY
15SrvIdentifiers and restart frequency of server processNY
16PIDProcess IDNY
17AccAccess count (connection-wise/ thread-wise/ slot-wise)NY
18MOperation statusNY
19CPUCPU time (in seconds) (UNIX version)NY
20SSElapsed seconds from the starting of last processNY
21ReqMilliseconds required for the last processNY
22ConnTraffic for the connectionNY
23ChildTraffic of processNY
24SlotTraffic of slotNY
25ClientClient of last processNY
26VHostVirtual host nameNY
27RequestRequest line of last processNY
Legend:
Y: Can be acquired.
N: Cannot be acquired.

Table 4-14 Information which can be acquired by using the status information display functionality (with the auto specification)

NoContentsExplanationValue and acquisition of ExtendedStatus
OffOn
1Total accessesTotal number of accessesNY
2Total kBytesTotal amount of trafficNY
3CPULoadCPU usage rate (UNIX version)NY
4UptimeServer process running time (in seconds)NY
5ReqPerSecThe number of requests per secondNY
6BytesPerSecAmount of traffic per secondNY
7BytesPerReqAmount of traffic per requestNY
8BusyWorkersThe number of server processes during request processing (threads)YY
9IdleWorkersThe number of server processes in the status of request waiting (threads)YY
10ScoreboardOperation status of each threadYY
Legend:
Y: Can be acquired.
N: Cannot be acquired.

(4) Note

Multibyte characters might be set in the information for the time zones of Current Time and Restart Time displayed by using the server status display functionality. In this case, Cosminexus HTTP Server escapes all of the character strings (replaces them with the character strings configured with the prefixes which start with \x and hexadecimal codes).