Apache Module mod_status

Available Languages: en | + ja | + ko | + tr

+ + + +

Description:	Provides information on server activity and +performance
Status:	Base
Module Identifier:	status_module
Source File:	mod_status.c

Summary

+ +

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.

+ +

The details given are:

+ +

The number of worker serving requests
The number of idle worker
The status of each worker, the number of requests that + worker has performed and the total number of bytes served by + the worker (*)
A total number of accesses and byte count served (*)
The time the server was started/restarted and the time it + has been running for
Averages giving the number of requests per second, the + number of bytes served per second and the average number of + bytes per request (*)
The current percentage CPU used by each worker and in + total by Apache (*)
The current hosts and requests being processed (*)

+ +

The lines marked "(*)" are only available if + ExtendedStatus + is On.

Directives

ExtendedStatus

Enabling Status Support

+ + +

To enable status reports only for browsers from the foo.com + domain add this code to your httpd.conf + configuration file

+ <Location /server-status> + SetHandler server-status + + Order Deny,Allow + Deny from all + Allow from .foo.com + </Location> +

+ +

You can now access server statistics by using a Web browser + to access the page + http://your.server.name/server-status

Automatic Updates

+ + +

You can get the status page to update itself automatically if + you have a browser that supports "refresh". Access the page + http://your.server.name/server-status?refresh=N to + refresh the page every N seconds.

+ +

Machine Readable Status File

+ + +

A machine-readable version of the status file is available by + accessing the page + http://your.server.name/server-status?auto. This + is useful when automatically run, see the Perl program in the + /support directory of Apache, + log_server_status.

+ +

+ It should be noted that if mod_status is + compiled into the server, its handler capability is available + in all configuration files, including + per-directory files (e.g., + .htaccess). This may have security-related + ramifications for your site. +

+ +

ExtendedStatus Directive

+ + + + + + + + +

Description:	Keep track of extended status information for each +request
Syntax:	`ExtendedStatus On\|Off`
Default:	`ExtendedStatus Off`
Context:	server config
Status:	Base
Module:	mod_status
Compatibility:	ExtendedStatus is only available in Apache 1.3.2 and +later.

This setting applies to the entire server, and cannot be + enabled or disabled on a virtualhost-by-virtualhost basis. + The collection of extended status information can slow down + the server.

+ +