granicus.if.org Git - apache/blob - docs/manual/mod/mod_status.xml.ja

   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:1086578 (outdated) -->
   6
   7 <!--
   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
  14
  15      http://www.apache.org/licenses/LICENSE-2.0
  16
  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.
  22 -->
  23
  24 <name>mod_status</name>
  25 <description>サーバの活動状況と性能に関する情報を提供する</description>
  26 <status>Base</status>
  27 <sourcefile>mod_status.c</sourcefile>
  28 <identifier>status_module</identifier>
  29
  30
  31 <summary>
  32     <p>この Status モジュールによりサーバ管理者はサーバがどのくらい
  33     の性能で動作しているかを知ることができるようになります。
  34     現時点でのサーバの統計情報を読みやすい形式で表した HTML ページが
  35     表示されます。必要であれば、このページは自動的にリフレッシュさせる
  36     こともできます (互換性のあるブラウザを使用している場合)。
  37     別に、現時点でのサーバの状態を単純な機械読み取り可能なリストで
  38     表すページもあります。</p>
  39
  40     <p>表示される情報は:</p>
  41
  42     <ul>
  43       <li>リクエストを扱っているワーカーの数</li>
  44
  45       <li>アイドル (訳注: リクエストを扱っていない) ワーカーの数</li>
  46
  47       <li>各ワーカーの状態、ワーカーが扱ったリクエストの数、
  48       ワーカーが送った総バイト数 (*)</li>
  49
  50       <li>総アクセス数と総バイト数 (*)</li>
  51
  52       <li>サーバが起動もしくは再起動された時刻と動作している時間</li>
  53
  54       <li>平均の 1 秒あたりのリクエスト数、1 秒あたりの送られたバイト数、
  55       リクエストあたりのバイト数 (*)</li>
  56
  57       <li>各ワーカーと Apache 全体で使用されている CPU の割合 (*)</li>
  58
  59       <li>現時点のホストと処理されているリクエスト (*)</li>
  60     </ul>
  61
  62     <p>"(*)" の付いている情報を表示するには
  63     <directive module="mod_status">ExtendedStatus</directive>
  64     が <code>On</code> になっている必要があります。</p>
  65 </summary>
  66
  67 <section id="enable">
  68     <title>Status を使用可能にする</title>
  69
  70     <p>example.com ドメインからのブラウザのみに対して
  71     ステータスの報告を使用可能にするには
  72     以下のコードを <code>httpd.conf</code> 設定ファイルに追加します</p>
  73 <example>
  74     &lt;Location /server-status&gt;<br />
  75     SetHandler server-status<br />
  76 <br />
  77     Order Deny,Allow<br />
  78     Deny from all<br />
  79     Allow from .example.com<br />
  80     &lt;/Location&gt;
  81 </example>
  82
  83     <p>これで、サーバの統計情報をウェブブラウザを使って
  84     <code>http://your.server.name/server-status</code> をアクセスすることにより
  85     知ることができるようになります。</p>
  86 </section>
  87
  88 <section id="autoupdate">
  89
  90     <title>自動更新</title>
  91     <p>ブラウザが「リフレッシュ」機能をサポートしていれば、ステータスページを
  92     自動的に更新するようにできます。N 秒毎に更新させるためには
  93     <code>http://your.server.name/server-status?refresh=N</code>
  94     というページをアクセスしてください。</p>
  95
  96 </section>
  97
  98 <section id="machinereadable">
  99
 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>
 106
 107     <note>
 108       <strong><module>mod_status</module> がサーバに組み込まれている
 109       場合、ハンドラの機能はディレクトリ<em>毎</em>のファイル
 110       (<em>すなわち</em>、<code>.htaccess</code>) も含む<em>すべて</em>の
 111       設定ファイルで使用可能になることには注意をしておく必要があります。
 112       これは、サイトによってはセキュリティに関する望ましくない結果を
 113       もたらすことがあるかもしれません。</strong>
 114     </note>
 115
 116 </section>
 117
 118 <directivesynopsis>
 119
 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>
 125
 126 <usage>
 127     <p>この設定はサーバ全体に対して適用され、バーチャルホスト毎に
 128     変更することはできません。拡張ステータス情報の収集はサーバの
 129     動作を遅くすることがあります。</p>
 130 </usage>
 131
 132 </directivesynopsis>
 133 <directivesynopsis>
 134
 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>
 142
 143 <usage>
 144     <p><code>ExtendedStatus On</code> に設定すると mod_status
 145     は処理中のリクエスト<transnote>の文字列</transnote>を表示します。
 146     歴史的な理由で、リクエストのうちの63文字だけが表示用に記録されます。
 147     このディレクティブで、最初の63文字を記録する(従来からの動作、
 148     そして現在もデフォルト)か、最後の63文字を記録するかを決めます。
 149     もちろん、リクエストの長さが64文字以上のときに効果があります
 150     <transnote>63文字以下だと結果的に同じ動作</transnote>。</p>
 151
 152     <p>Apache が <code
 153     >GET&nbsp;/disk1/storage/apache/htdocs/images/imagestore1/food/apples.jpg&nbsp;HTTP/1.1</code
 154     > というリクエストを扱っているとき、 mod_status は以下のように表示します:
 155     </p>
 156
 157     <table border="1">
 158       <tr>
 159         <th>Off (デフォルト)</th>
 160         <td>GET&nbsp;/disk1/storage/apache/htdocs/images/imagestore1/food/fruits</td>
 161       </tr>
 162       <tr>
 163         <th>On</th>
 164         <td>orage/apache/htdocs/images/imagestore1/food/apples.jpg&nbsp;HTTP/1.1</td>
 165       </tr>
 166     </table>
 167
 168 </usage>
 169
 170 </directivesynopsis>
 171
 172 </modulesynopsis>
 173