1 <?xml version="1.0" encoding="UTF-8" ?>
2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
3 <?xml-stylesheet type="text/xsl" href="../style/manual.ja.xsl"?>
4 <modulesynopsis metafile="mod_status.xml.meta">
5 <!-- English Revision: 668628:1174747 (outdated) -->
8 Licensed to the Apache Software Foundation (ASF) under one or more
9 contributor license agreements. See the NOTICE file distributed with
10 this work for additional information regarding copyright ownership.
11 The ASF licenses this file to You under the Apache License, Version 2.0
12 (the "License"); you may not use this file except in compliance with
13 the License. You may obtain a copy of the License at
15 http://www.apache.org/licenses/LICENSE-2.0
17 Unless required by applicable law or agreed to in writing, software
18 distributed under the License is distributed on an "AS IS" BASIS,
19 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
20 See the License for the specific language governing permissions and
21 limitations under the License.
24 <name>mod_status</name>
25 <description>サーバの活動状況と性能に関する情報を提供する</description>
27 <sourcefile>mod_status.c</sourcefile>
28 <identifier>status_module</identifier>
32 <p>この Status モジュールによりサーバ管理者はサーバがどのくらい
33 の性能で動作しているかを知ることができるようになります。
34 現時点でのサーバの統計情報を読みやすい形式で表した HTML ページが
35 表示されます。必要であれば、このページは自動的にリフレッシュさせる
36 こともできます (互換性のあるブラウザを使用している場合)。
37 別に、現時点でのサーバの状態を単純な機械読み取り可能なリストで
43 <li>リクエストを扱っているワーカーの数</li>
45 <li>アイドル (訳注: リクエストを扱っていない) ワーカーの数</li>
47 <li>各ワーカーの状態、ワーカーが扱ったリクエストの数、
48 ワーカーが送った総バイト数 (*)</li>
50 <li>総アクセス数と総バイト数 (*)</li>
52 <li>サーバが起動もしくは再起動された時刻と動作している時間</li>
54 <li>平均の 1 秒あたりのリクエスト数、1 秒あたりの送られたバイト数、
55 リクエストあたりのバイト数 (*)</li>
57 <li>各ワーカーと Apache 全体で使用されている CPU の割合 (*)</li>
59 <li>現時点のホストと処理されているリクエスト (*)</li>
62 <p>"(*)" の付いている情報を表示するには
63 <directive module="mod_status">ExtendedStatus</directive>
64 が <code>On</code> になっている必要があります。</p>
68 <title>Status を使用可能にする</title>
70 <p>example.com ドメインからのブラウザのみに対して
72 以下のコードを <code>httpd.conf</code> 設定ファイルに追加します</p>
74 <Location /server-status><br />
75 SetHandler server-status<br />
77 Order Deny,Allow<br />
79 Allow from .example.com<br />
83 <p>これで、サーバの統計情報をウェブブラウザを使って
84 <code>http://your.server.name/server-status</code> をアクセスすることにより
88 <section id="autoupdate">
91 <p>ブラウザが「リフレッシュ」機能をサポートしていれば、ステータスページを
92 自動的に更新するようにできます。N 秒毎に更新させるためには
93 <code>http://your.server.name/server-status?refresh=N</code>
94 というページをアクセスしてください。</p>
98 <section id="machinereadable">
100 <title>機械読み取り可能なステータスファイル</title>
101 <p><code>http://your.server.name/server-status?auto</code> を
102 アクセスすることにより、ステータスファイルの機械読み取り可能なバージョンを
103 得ることができます。これは自動的に実行されるときに便利です。
104 Apache の <code>/support</code> ディレクトリにある
105 Perl プログラム <code>log_server_status</code> を見てください。</p>
108 <strong><module>mod_status</module> がサーバに組み込まれている
109 場合、ハンドラの機能はディレクトリ<em>毎</em>のファイル
110 (<em>すなわち</em>、<code>.htaccess</code>) も含む<em>すべて</em>の
111 設定ファイルで使用可能になることには注意をしておく必要があります。
112 これは、サイトによってはセキュリティに関する望ましくない結果を
113 もたらすことがあるかもしれません。</strong>
120 <name>ExtendedStatus</name>
121 <description>各リクエストに対して拡張ステータス情報を保存する</description>
122 <syntax>ExtendedStatus On|Off</syntax>
123 <default>ExtendedStatus Off</default>
124 <contextlist><context>server config</context></contextlist>
127 <p>この設定はサーバ全体に対して適用され、バーチャルホスト毎に
128 変更することはできません。拡張ステータス情報の収集はサーバの
135 <name>SeeRequestTail</name>
136 <description>リクエストの最初の 63 文字か最後の 63 文字
137 のどちらを mod_status が表示するかを決める</description>
138 <syntax>SeeRequestTail On|Off</syntax>
139 <default>SeeRequestTail Off</default>
140 <contextlist><context>server config</context></contextlist>
141 <compatibility>Apache 2.2.7 以降</compatibility>
144 <p><code>ExtendedStatus On</code> に設定すると mod_status
145 は処理中のリクエスト<transnote>の文字列</transnote>を表示します。
146 歴史的な理由で、リクエストのうちの63文字だけが表示用に記録されます。
147 このディレクティブで、最初の63文字を記録する(従来からの動作、
148 そして現在もデフォルト)か、最後の63文字を記録するかを決めます。
149 もちろん、リクエストの長さが64文字以上のときに効果があります
150 <transnote>63文字以下だと結果的に同じ動作</transnote>。</p>
153 >GET /disk1/storage/apache/htdocs/images/imagestore1/food/apples.jpg HTTP/1.1</code
154 > というリクエストを扱っているとき、 mod_status は以下のように表示します:
160 <td>GET /disk1/storage/apache/htdocs/images/imagestore1/food/fruits</td>
164 <td>orage/apache/htdocs/images/imagestore1/food/apples.jpg HTTP/1.1</td>