Apache HTTP サーバ バージョン 2.2

Apache > HTTP サーバ > ドキュメンテーション > バージョン 2.2 > モジュール

# Apache モジュール mod_status

Available Languages: en | ja | ko | tr

This translation may be out of date. Check the English version for recent changes.

説明: | サーバの活動状況と性能に関する情報を提供する
ステータス: | Base
モジュール識別子: | status_module
ソースファイル: | mod_status.c

### 概要

この Status モジュールによりサーバ管理者はサーバがどのくらい の性能で動作しているかを知ることができるようになります。 現時点でのサーバの統計情報を読みやすい形式で表した HTML ページが 表示されます。必要であれば、このページは自動的にリフレッシュさせる こともできます (互換性のあるブラウザを使用している場合)。 別に、現時点でのサーバの状態を単純な機械読み取り可能なリストで 表すページもあります。

表示される情報は:

- リクエストを扱っているワーカーの数
- アイドル (訳注: リクエストを扱っていない) ワーカーの数
- 各ワーカーの状態、ワーカーが扱ったリクエストの数、 ワーカーが送った総バイト数 (*)
- 総アクセス数と総バイト数 (*)
- サーバが起動もしくは再起動された時刻と動作している時間
- 平均の 1 秒あたりのリクエスト数、1 秒あたりの送られたバイト数、 リクエストあたりのバイト数 (*)
- 各ワーカーと Apache 全体で使用されている CPU の割合 (*)
- 現時点のホストと処理されているリクエスト (*)

"(*)" の付いている情報を表示するには `ExtendedStatus` が `On` になっている必要があります。

### ディレクティブ

### トピック

- Status を使用可能にする
- 自動更新
- 機械読み取り可能なステータスファイル

## Status を使用可能にする

example.com ドメインからのブラウザのみに対して ステータスの報告を使用可能にするには 以下のコードを `httpd.conf` 設定ファイルに追加します

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

これで、サーバの統計情報をウェブブラウザを使って `http://your.server.name/server-status` をアクセスすることにより 知ることができるようになります。

## 自動更新

ブラウザが「リフレッシュ」機能をサポートしていれば、ステータスページを 自動的に更新するようにできます。N 秒毎に更新させるためには `http://your.server.name/server-status?refresh=N` というページをアクセスしてください。

## 機械読み取り可能なステータスファイル

`http://your.server.name/server-status?auto` を アクセスすることにより、ステータスファイルの機械読み取り可能なバージョンを 得ることができます。これは自動的に実行されるときに便利です。 Apache の `/support` ディレクトリにある Perl プログラム `log_server_status` を見てください。

`mod_status` がサーバに組み込まれている 場合、ハンドラの機能はディレクトリ毎のファイル (すなわち、`.htaccess`) も含むすべての 設定ファイルで使用可能になることには注意をしておく必要があります。 これは、サイトによってはセキュリティに関する望ましくない結果を もたらすことがあるかもしれません。

## ExtendedStatus ディレクティブ

説明: | 各リクエストに対して拡張ステータス情報を保存する
構文: | `ExtendedStatus On|Off`
デフォルト: | `ExtendedStatus Off`
コンテキスト: | サーバ設定ファイル
ステータス: | Base
モジュール: | mod_status
互換性: | ExtendedStatus は Apache 1.3.2 以降でのみ使用可能

この設定はサーバ全体に対して適用され、バーチャルホスト毎に 変更することはできません。拡張ステータス情報の収集はサーバの 動作を遅くすることがあります。

## SeeRequestTail ディレクティブ

説明: | リクエストの最初の 63 文字か最後の 63 文字 のどちらを mod_status が表示するかを決める
構文: | `SeeRequestTail On|Off`
デフォルト: | `SeeRequestTail Off`
コンテキスト: | サーバ設定ファイル
ステータス: | Base
モジュール: | mod_status
互換性: | Apache 2.2.7 以降

`ExtendedStatus On` に設定すると mod_status は処理中のリクエスト(訳注: の文字列)を表示します。 歴史的な理由で、リクエストのうちの63文字だけが表示用に記録されます。 このディレクティブで、最初の63文字を記録する(従来からの動作、 そして現在もデフォルト)か、最後の63文字を記録するかを決めます。 もちろん、リクエストの長さが64文字以上のときに効果があります (訳注: 63文字以下だと結果的に同じ動作)。

Apache が `GET /disk1/storage/apache/htdocs/images/imagestore1/food/apples.jpg HTTP/1.1` というリクエストを扱っているとき、 mod_status は以下のように表示します:

Off (デフォルト) | GET /disk1/storage/apache/htdocs/images/imagestore1/food/fruits
On | orage/apache/htdocs/images/imagestore1/food/apples.jpg HTTP/1.1

Available Languages: en | ja | ko | tr