rubbos/app/apache2/manual/logs.html.ja.utf8

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" lang="ja" xml:lang="ja"><head><!--
   4         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   5               This file is generated from xml source: DO NOT EDIT
   6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   7       -->
   8 <title>ログファイル - Apache HTTP サーバ</title>
   9 <link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
  10 <link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
  11 <link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
  12 <link href="./images/favicon.ico" rel="shortcut icon" /></head>
  13 <body id="manual-page"><div id="page-header">
  14 <p class="menu"><a href="./mod/">モジュール</a> | <a href="./mod/directives.html">ディレクティブ</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p>
  15 <p class="apache">Apache HTTP サーバ バージョン 2.0</p>
  16 <img alt="" src="./images/feather.gif" /></div>
  17 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
  18 <div id="path">
  19 <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP サーバ</a> &gt; <a href="http://httpd.apache.org/docs/">ドキュメンテーション</a> &gt; <a href="./">バージョン 2.0</a></div><div id="page-content"><div id="preamble"><h1>ログファイル</h1>
  20 <div class="toplang">
  21 <p><span>Available Languages: </span><a href="./en/logs.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  22 <a href="./es/logs.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
  23 <a href="./ja/logs.html" title="Japanese">&nbsp;ja&nbsp;</a> |
  24 <a href="./ko/logs.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
  25 <a href="./tr/logs.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
  26 </div>
  27 <div class="outofdate">This translation may be out of date. Check the
  28             English version for recent changes.</div>
  29
  30     <p>ウェブサーバを効果的に管理するためには、サーバの活動やパフォーマンス、
  31     今発生しているかもしれない問題に関するフィードバックを得ることが必要です。
  32     Apache HTTP サーバには非常に包括的で柔軟なロギング機能があります。
  33     この文書はロギング機能の設定の仕方と、ログに何が書かれているかを
  34     理解するための方法を説明します。</p>
  35   </div>
  36 <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#security">
  37     セキュリティに関する警告</a></li>
  38 <li><img alt="" src="./images/down.gif" /> <a href="#errorlog">エラーログ</a></li>
  39 <li><img alt="" src="./images/down.gif" /> <a href="#accesslog">アクセスログ</a></li>
  40 <li><img alt="" src="./images/down.gif" /> <a href="#rotation">ログの交替</a></li>
  41 <li><img alt="" src="./images/down.gif" /> <a href="#piped">パイプ経由のログ</a></li>
  42 <li><img alt="" src="./images/down.gif" /> <a href="#virtualhosts">バーチャルホスト</a></li>
  43 <li><img alt="" src="./images/down.gif" /> <a href="#other">他のログファイル</a></li>
  44 </ul></div>
  45 <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
  46 <div class="section">
  47 <h2><a name="security" id="security">
  48     セキュリティに関する警告</a></h2>
  49
  50     <p>Apache がログファイルを書いているディレクトリに書き込める人は、
  51     ほぼ確実にサーバが起動された uid へのアクセスを手に入れることができます。
  52     そして、それは通常は root ユーザです。
  53     ちゃんと結果を考えることなく、そのディレクトリへの
  54     書き込み権限を与え<em>ない</em>でください。詳しくは
  55     <a href="misc/security_tips.html">セキュリティのこつ</a>の文書を
  56     読んでください。</p>
  57
  58     <p>加えて、ログファイルにはクライアントからの情報がそのまま、
  59     エスケープされることなく書かれています。ですから、悪意のある
  60     クライアントがログファイルに制御文字を挿入することができます。
  61     生のログを扱うときは注意してください。</p>
  62   </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
  63 <div class="section">
  64 <h2><a name="errorlog" id="errorlog">エラーログ</a></h2>
  65
  66     <table class="related"><tr><th>関連モジュール</th><th>関連ディレクティブ</th></tr><tr><td /><td><ul><li><code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code></li><li><code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code></li></ul></td></tr></table>
  67
  68     <p><code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code> ディレクティブにより
  69     名前と場所が決まるサーバのエラーログは、一番重要なログファイルです。
  70     Apache の診断情報はここに送られ、リクエストを処理しているときに
  71     発生したエラーはすべてここに記録されます。サーバを起動したときや、
  72     サーバの動作に問題が起こったときは、一番最初に調べるべき
  73     ところです。間違いの詳細や修正方法がそこに書かれていることが
  74     よくあります。</p>
  75
  76     <p>エラーログは普通はファイルに書かれます (通常 unix システムでは
  77     <code>error_log</code>、Windows と OS/2 では <code>error.log</code>)。
  78     Unix システムではエラーを <code>syslog</code> や
  79     <a href="#piped">パイプでプログラムに送る</a> ことができます。</p>
  80
  81     <p>エラーログの書式は比較的自由度の高いもので、説明的に書かれています。
  82     ただし、いくつかの情報はほとんどのエラーログのエントリにあります。
  83     例えば、代表的なものに次のようなメッセージがあります。</p>
  84
  85     <div class="example"><p><code>
  86       [Wed Oct 11 14:32:52 2000] [error] [client 127.0.0.1]
  87       client denied by server configuration:
  88       /export/home/live/ap/htdocs/test
  89     </code></p></div>
  90
  91     <p>ログエントリの最初の項目はメッセージの日付と時刻です。
  92     二つめの項目は報告されているエラーの重要度です。
  93     <code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code> で重要度のレベルを
  94     制限することによりエラーログに送られるエラーの種類を制御することが
  95     できます。三つ目の項目はエラーを発生させたクライアントの IP アドレス
  96     です。残りはメッセージで、この場合はサーバがクライアントのアクセスを
  97     拒否するように設定されている、ということを示しています。
  98     サーバはリクエストされた文書の (ウェブのパスではなく) ファイルシステムの
  99     パスを報告します。</p>
 100
 101     <p>非常に広範囲のメッセージがエラーログに現れます。たいていのものは
 102     上の例のような感じです。エラーログには CGI スクリプトのデバッグ
 103     出力も書かれます。CGI スクリプトが <code>stderr</code> に書いた
 104     すべての情報は直接エラーログにコピーされます。</p>
 105
 106     <p>情報を追加したり削除したりしてエラーログをカスタマイズすることは
 107     できません。しかし、リクエストに対するエラーログのエントリは、
 108     対応するエントリが<a href="#accesslog">アクセスログ</a>にあります。
 109     例えば、上の例のエントリはアクセスログのステータスコード 403 の
 110     エントリに対応します。アクセスログはカスタマイズ可能ですので、
 111     そちらを使うことによりエラーの状況に関する情報をより多く
 112     手に入れることができます。</p>
 113
 114     <p>テストの最中は、問題が発生しているかどうかを見るために、
 115     常にエラーログを監視するのが役に立つ場合がよくあります。
 116     Unix システムでは、次のものを使うことができます。</p>
 117
 118     <div class="example"><p><code>
 119       tail -f error_log
 120     </code></p></div>
 121   </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 122 <div class="section">
 123 <h2><a name="accesslog" id="accesslog">アクセスログ</a></h2>
 124
 125
 126     <table class="related"><tr><th>関連モジュール</th><th>関連ディレクティブ</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code></li><li><code class="module"><a href="./mod/mod_setenvif.html">mod_setenvif</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code></li><li><code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code></li></ul></td></tr></table>
 127
 128     <p>サーバアクセスログはサーバが処理をしたすべてのリクエストを
 129     記録します。アクセスログの場所と内容は <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code>
 130     ディレクティブにより決まります。ログの内容の選択を簡潔にするために
 131     <code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code>
 132     ディレクティブを使用することができます。このセクションはアクセスログに
 133     情報を記録するためのサーバの設定方法を説明します。</p>
 134
 135     <p>もちろん、アクセスログに情報を蓄積することはログ管理の
 136     始まりに過ぎません。次の段階は有用な統計を取るためにこの情報を
 137     解析することです。一般的なログ解析はこの文書の範囲外で、
 138     ウェブサーバ自身の仕事というわけでもありません。この話や、
 139     ログ解析を行なうアプリケーションの情報を得るには、<a href="http://dmoz.org/Computers/Software/Internet/Site_Management/Log_analysis/">
 140     Open Directory</a> や <a href="http://dir.yahoo.com/Computers_and_Internet/Software/Internet/World_Wide_Web/Servers/Log_Analysis_Tools/">
 141     Yahoo</a> を調べてください。</p>
 142
 143     <p>いろんなバージョンの Apache httpd が mod_log_config,
 144     mod_log_agent, <code>TransferLog</code> ディレクティブといった、
 145     他のモジュールやディレクティブを使ってアクセスのロギングを
 146     制御してきました。今では、<code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> がすべての古い
 147     ディレクティブの機能を含むようになっています。</p>
 148
 149     <p>アクセスログの書式は非常に柔軟な設定が可能です。
 150     書式は C の printf(1) フォーマット文字列に非常に似た
 151     <code class="directive"><a href="./mod/mod_log_config.html#フォーマット文字列">フォーマット文字列</a></code>
 152     により指定されます。いくつか次の節で例を示します。
 153     フォーマット文字列に使用できる内容の一覧は <a href="mod/mod_log_config.html">mod_log_config の文書</a>
 154     を見てください。</p>
 155
 156     <h3><a name="common" id="common">Common Log Format</a></h3>
 157
 158
 159       <p>アクセスログのよくある設定に以下のものがあります。</p>
 160
 161       <div class="example"><p><code>
 162         LogFormat "%h %l %u %t \"%r\" %&gt;s %b" common<br />
 163          CustomLog logs/access_log common
 164       </code></p></div>
 165
 166       <p>これは、<em>ニックネーム</em> <code>common</code> を定義し、
 167       ログのフォーマット文字列の一つと関連付けます。フォーマット文字列は
 168       パーセントディレクティブからなり、それぞれのパーセントディレクティブは
 169       サーバにどの情報をロギングするかを指示します。フォーマット文字列に
 170       文字をそのまま入れることもでき、それらはログの出力に直接コピーされます。
 171       そこに引用文字 (<code>"</code>) を書くときは、
 172       フォーマット文字列の最後として解釈
 173       されることを防ぐためにバックスラッシュでエスケープする必要があります。
 174       フォーマット文字列には改行用の "<code>\n</code>"、タブ用の
 175       "<code>\t</code>" という特別な制御文字も含めることができます。</p>
 176
 177       <p><code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> ディレクティブは
 178       既に定義された
 179       <em>ニックネーム</em> を使って新しいログファイルを設定します。
 180       アクセスログのファイル名はスラッシュで始まらない限り、
 181       <code class="directive"><a href="./mod/core.html#serverroot">ServerRoot</a></code> からの相対パスとして
 182       扱われます。</p>
 183
 184       <p>上の設定は Common Log Format (CLF) と呼ばれる形式で
 185       ログエントリを書きます。この標準の形式は異なるウェブサーバの多くが
 186       生成することができ、多くのログ解析プログラムが読みこむことができます。
 187       CLF により生成されたログファイルのエントリは以下のようになります:</p>
 188
 189       <div class="example"><p><code>
 190         127.0.0.1 - frank [10/Oct/2000:13:55:36 -0700] "GET
 191         /apache_pb.gif HTTP/1.0" 200 2326
 192       </code></p></div>
 193
 194       <p>このログエントリのそれぞれの部分の意味は以下で説明します。</p>
 195
 196       <dl>
 197         <dt><code>127.0.0.1</code> (<code>%h</code>)</dt>
 198
 199         <dd>これはサーバへリクエストをしたクライアント (リモートホスト)
 200         の IP アドレスです。<code class="directive"><a href="./mod/core.html#hostnamelookups">HostnameLookups</a></code> が
 201         <code>On</code> の場合は、サーバはホスト名を調べて、
 202         IP アドレスが書かれているところに記録します。しかし、この設定は
 203         サーバをかなり遅くするので、あまりお勧めできません。
 204         そうではなく、<a href="programs/logresolve.html">logresolve</a> の
 205         ようなログの後処理を行なうプログラムでホスト名を調べるのが良いでしょう。
 206         ここに報告される IP アドレスは必ずしもユーザが使っているマシンの
 207         ものであるとは限りません。ユーザとサーバの間にプロキシサーバが
 208         あれば、このアドレスは元のマシンのものではなく、プロキシの
 209         アドレスになります。</dd>
 210
 211         <dt><code>-</code> (<code>%l</code>)</dt>
 212
 213         <dd>出力中の「ハイフン」は要求された情報が手に入らなかったということを
 214         意味します。この場合、取得できなかった情報はクライアントのマシンの
 215         <code>identd</code> により決まる RFC 1413 のクライアントの
 216         アイデンティティです。この情報はあまり信用することができず、
 217         しっかりと管理された内部ネットワークを除いては使うべきではありません。
 218         Apache は <code class="directive"><a href="./mod/core.html#identitycheck">IdentityCheck</a></code> が
 219         <code>On</code> になっていない限り、この情報を得ようとすらしません。</dd>
 220
 221         <dt><code>frank</code> (<code>%u</code>)</dt>
 222
 223         <dd>これは HTTP 認証による、ドキュメントをリクエストした人の
 224         ユーザ ID です。CGI スクリプトには通常同じ値が <code>REMOTE_USER</code>
 225         環境変数として与えられます。リクエストのステータスコード
 226         (以下を参照) が 401 であった場合は、ユーザは認証に失敗しているので、
 227         この値は信用できません。ドキュメントがパスワードで保護されていない
 228         場合は、このエントリは前のものと同じように "<code>-</code>" に
 229         なります。</dd>
 230
 231         <dt><code>[10/Oct/2000:13:55:36 -0700]</code>
 232         (<code>%t</code>)</dt>
 233
 234         <dd>
 235           サーバがリクエストの処理を終えた時刻です。書式は:
 236
 237             <p class="indent">
 238               <code>[day/month/year:hour:minute:second zone]<br />
 239                day = 2*digit<br />
 240                month = 3*letter<br />
 241                year = 4*digit<br />
 242                hour = 2*digit<br />
 243                minute = 2*digit<br />
 244                second = 2*digit<br />
 245                zone = (`+' | `-') 4*digit</code>
 246             </p>
 247           ログのフォーマット文字列に <code>%{format}t</code> を
 248           指定することで、別の形式で時刻を表示させることもできます。
 249           このとき、<code>format</code> は C の標準ライブラリの
 250           <code>strftime(3)</code> の形式になります。
 251         </dd>
 252
 253         <dt><code>"GET /apache_pb.gif HTTP/1.0"</code>
 254         (<code>\"%r\"</code>)</dt>
 255
 256         <dd>クライアントからのリクエストが二重引用符の中に示されています。
 257         リクエストには多くの有用な情報があります。まず、この場合クライアントが
 258         使ったメソッドは <code>GET</code> です。次に、クライアントは
 259         リソース <code>/apache_pb.gif</code> を要求しました。そして、
 260         クライアントはプロトコル <code>HTTP/1.0</code> を使用しました。
 261         リクエストの各部分を独立にログ収集することもできます。例えば、
 262         フォーマット文字列 "<code>%m %U%q %H</code>" は
 263         メソッド、パス、クエリ文字列、プロトコルをログ収集し、
 264         結局 "<code>%r</code>" とまったく同じ出力になります。</dd>
 265
 266         <dt><code>200</code> (<code>%&gt;s</code>)</dt>
 267
 268         <dd>サーバがクライアントに送り返すステータスコードです。
 269         この情報は、リクエストが成功応答 (2 で始まるコード) であったか、
 270         リダイレクション (3 で始まるコード) であったか、クライアントによる
 271         エラー (4 で始まるコード) であったか、サーバのエラー (5 で始まるコード)
 272         であったか、を現すので、非常に大切です。ステータスコードの
 273         完全なリストは <a href="http://www.w3.org/Protocols/rfc2616/rfc2616.txt">HTTP
 274         規格</a> (RFC2616 第 10 節) にあります。</dd>
 275
 276         <dt><code>2326</code> (<code>%b</code>)</dt>
 277
 278         <dd>この最後のエントリはクライアントに送信されたオブジェクトの、
 279         応答ヘッダを除いたサイズを現します。コンテントがクライアントに送られなかった
 280         場合は、この値は "<code>-</code>" になります。コンテントが無い場合に
 281         "<code>0</code>" をログ収集するには、<code>%b</code> ではなく
 282         <code>%B</code> を使ってください。</dd>
 283
 284       </dl>
 285
 286
 287     <h3><a name="combined" id="combined">Combined Log Format</a></h3>
 288
 289
 290       <p>もう一つのよく使われる書式は Combined Log Format と呼ばれています。
 291       以下のようにして使うことができます。</p>
 292
 293       <div class="example"><p><code>
 294         LogFormat "%h %l %u %t \"%r\" %&gt;s %b \"%{Referer}i\"
 295         \"%{User-agent}i\"" combined<br />
 296          CustomLog log/access_log combined
 297       </code></p></div>
 298
 299       <p>この書式の最初の方は Common Log Format とまったく同じで、最後に
 300       二つ追加のエントリがあります。追加のエントリはパーセントディレクティブ
 301       <code>%{<em>header</em>}i</code> を使っています。ここで
 302       <em>header</em> は HTTP のリクエストヘッダのどれかです。この書式による
 303       アクセスログは以下のような感じになります:</p>
 304
 305       <div class="example"><p><code>
 306         127.0.0.1 - frank [10/Oct/2000:13:55:36 -0700] "GET
 307         /apache_pb.gif HTTP/1.0" 200 2326
 308         "http://www.example.com/start.html" "Mozilla/4.08 [en]
 309         (Win98; I ;Nav)"
 310       </code></p></div>
 311
 312       <p>追加のエントリは:</p>
 313
 314       <dl>
 315         <dt><code>"http://www.example.com/start.html"</code>
 316         (<code>\"%{Referer}i\"</code>)</dt>
 317
 318         <dd>"Referer" (意図的な綴り間違い) HTTP リクエストヘッダです。
 319         これはクライアントが報告してくる参照元のサイトを表します。
 320         (この場合は、<code>/apache_pb.gif</code> にリンクしているか、
 321         それを含んでいるページです)。</dd>
 322
 323         <dt><code>"Mozilla/4.08 [en] (Win98; I ;Nav)"</code>
 324         (<code>\"%{User-agent}i\"</code>)</dt>
 325
 326         <dd>User-Agent HTTP リクエストヘッダです。これはクライアントのブラウザが
 327         自分自身のことを報告してくる情報です。</dd>
 328       </dl>
 329
 330
 331     <h3><a name="multiple" id="multiple">複数のアクセスログ</a></h3>
 332
 333
 334     <p>複数のアクセスログは単に設定ファイルに複数の <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code>
 335     ディレクティブを書くことで作成されます。例えば、以下のディレクティブは
 336     三つのアクセスログを作ります。最初のものは基本的な CLF の情報で、
 337     二つ目と三つ目は referer とブラウザの情報です。最後二つの
 338     <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> は
 339     <code>ReferLog</code> ディレクティブと
 340     <code>AgentLog</code> ディレクティブの効果をまねる方法を示しています。</p>
 341
 342       <div class="example"><p><code>
 343         LogFormat "%h %l %u %t \"%r\" %&gt;s %b" common<br />
 344         CustomLog logs/access_log common<br />
 345         CustomLog logs/referer_log "%{Referer}i -&gt; %U"<br />
 346         CustomLog logs/agent_log "%{User-agent}i"
 347       </code></p></div>
 348
 349     <p>この例は <code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code> で
 350     ニックネームを定義する必要がない、
 351     ということも示しています。ニックネームの代わりに、
 352     <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> ディレクティブに
 353     直接ログの書式を指定することができます。</p>
 354
 355
 356     <h3><a name="conditional" id="conditional">条件付きログ</a></h3>
 357
 358
 359     <p>クライアントのリクエストの特徴に基づいてアクセスログにエントリの
 360     一部をロギングしない方が便利なことがあります。これは <a href="env.html">環境変数</a> の補助により簡単に実現できます。まず、
 361     リクエストが何らかの条件に合うということを現すために環境変数が
 362     設定される必要があります。これは通常は <code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code> により
 363     行なわれます。そして、<code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> ディレクティブの
 364     <code>env=</code> 節を使って環境変数が設定されているリクエストを
 365     含めたり排除したりすることができます。いくつか例を挙げます:</p>
 366
 367       <div class="example"><p><code>
 368         # Mark requests from the loop-back interface<br />
 369         SetEnvIf Remote_Addr "127\.0\.0\.1" dontlog<br />
 370         # Mark requests for the robots.txt file<br />
 371         SetEnvIf Request_URI "^/robots\.txt$" dontlog<br />
 372         # Log what remains<br />
 373         CustomLog logs/access_log common env=!dontlog
 374       </code></p></div>
 375
 376     <p>他の例として、英語を話す人からのリクエストとそれ以外の人からのリクエストを
 377     分けたい、という場合を考えてみてください。</p>
 378
 379       <div class="example"><p><code>
 380         SetEnvIf Accept-Language "en" english<br />
 381         CustomLog logs/english_log common env=english<br />
 382         CustomLog logs/non_english_log common env=!english
 383       </code></p></div>
 384
 385     <p>ここまででは条件付きロギングが非常に強力で柔軟であることを示してきましたが、
 386     それがログの内容を制御する唯一の方法というわけではありません。ログファイルは
 387     サーバの活動の完全な記録である方がより役に立ちます。単純にログファイルを
 388     後処理して、考慮したくないログを削除する方が簡単であることがよくあります。</p>
 389
 390   </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 391 <div class="section">
 392 <h2><a name="rotation" id="rotation">ログの交替</a></h2>
 393
 394
 395     <p>普通の負荷のサーバでさえ、ログファイルに保存される情報の量は
 396     膨大になります。アクセスログのファイルは普通 10,000 リクエスト毎に
 397     1 MB 以上増えます。ですから、既存のログを移動したり、削除したりして、
 398     定期的にログを交替させることが必要になります。これはサーバの実行中には
 399     行なえません。というのは、Apache はファイルが open されている間は
 400     ずっと古いログファイルに書き続けるからです。
 401     新しいログファイルを open できるように、ログファイルが移動されたり
 402     削除された後に、サーバを<a href="stopping.html">再起動</a>する
 403     必要があります。</p>
 404
 405     <p><em>優雅な</em> 再起動を行なうことで、サーバは既存のコネクションや
 406     処理待ちのコネクションを失うことなく新しいログファイルを open させる
 407     ことができます。しかし、これを実現するために、サーバは古いリクエストを
 408     扱っている間は古いログファイルに書き続ける必要があります。
 409     ですから、再起動の後ではログファイルの処理を始める前に、しばらく待たなければ
 410     なりません。単にログを交替させて、ディスクの節約のために古いログを
 411     圧縮する普通のシナリオは:</p>
 412
 413     <div class="example"><p><code>
 414       mv access_log access_log.old<br />
 415       mv error_log error_log.old<br />
 416       apachectl graceful<br />
 417       sleep 600<br />
 418       gzip access_log.old error_log.old
 419     </code></p></div>
 420
 421     <p>ログの交替をするもう一つの方法は<a href="#piped">パイプ経由のログ</a>を使うもので、次の節で説明されています。</p>
 422   </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 423 <div class="section">
 424 <h2><a name="piped" id="piped">パイプ経由のログ</a></h2>
 425
 426
 427     <p>Apache httpd はエラーログとアクセスログをファイルに直接書く代わりに、
 428     パイプを通して別のプログラムに書き出すことができます。
 429     この機能により、主サーバにコードを追加することなく
 430     ロギングの柔軟性が非常に高まっています。パイプにログを書くためには、
 431     単にファイル名をパイプ文字 "<code>|</code>" に置き換え、その続きに
 432     標準入力からログのエントリを受けとる実行プログラムの名前を書くだけです。
 433     Apache はパイプ経由のログ用のプロセスをサーバの起動時に実行し、
 434     サーバの実行中にそのプログラムがクラッシュしたときはそれを再び
 435     実行します。(この最後の機能がこの技術が「信頼性のあるパイプ経由のロギング」
 436     と呼ばれている理由です。)</p>
 437
 438     <p>パイプ経由のログ用のプロセスは Apache httpd の親プロセスから起動され、
 439     そのプロセスのユーザ ID を継承します。これは、これは、パイプ経由のログ用の
 440     プログラムは普通 root として実行されることを意味します。
 441     ですから、プログラムを簡単で安全に保つことが非常に重要です。</p>
 442
 443     <p>パイプ経由のログの重要な利用法は、サーバの再起動なしでログの交替を
 444     することです。Apache HTTP サーバにはこのための  <a href="programs/rotatelogs.html">rotatelogs</a> と呼ばれる簡単な
 445     プログラムが付属しています。たとえば、24 時間毎にログを交替させるには、
 446     以下のものを使うことができます:</p>
 447
 448     <div class="example"><p><code>
 449       CustomLog "|/usr/local/apache/bin/rotatelogs
 450       /var/log/access_log 86400" common
 451     </code></p></div>
 452
 453     <p>パイプの先で呼ばれるコマンド全体が引用符で囲まれていることに注目して
 454     ください。この例はアクセスログを使っていますが、エラーログにも同じ技術を
 455     使うことができます。</p>
 456
 457     <p>似ているけれど、よりずっと柔軟な
 458     <a href="http://www.cronolog.org/">cronolog</a> というログ交替用の
 459     プログラムが外部のサイトにあります。</p>
 460
 461     <p>条件付きロギングと同様、パイプ経由のログは非常に強力な
 462     道具ですが、オフラインの後処理のような、より簡単な解決方法があるときは
 463     使わない方が良いでしょう。</p>
 464   </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 465 <div class="section">
 466 <h2><a name="virtualhosts" id="virtualhosts">バーチャルホスト</a></h2>
 467
 468
 469     <p>多くの <a href="vhosts/">バーチャルホスト</a> のあるサーバを実行している
 470     ときは、ログファイルの扱い方にいくつかの方法があります。
 471     まず、単独のホストのみのサーバとまったく同じようにログを使うことができます。
 472     ロギングディレクティブを主サーバのコンテキストの
 473     <code class="directive"><a href="./mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code> セクションの外に置くことで、
 474     すべてのログを同じアクセスログとエラーログにログ収集することができます。
 475     この手法では個々のバーチャルホストの統計を簡単にとることはできません。</p>
 476
 477     <p><code class="directive"><a href="./mod/mod_log_config.html#&gt;customlog">&gt;CustomLog</a></code> や
 478     <code class="directive"><a href="./mod/mod_log_config.html#errorlog">ErrorLog</a></code> ディレクティブが
 479     <code class="directive"><a href="./mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code> の中に
 480     置かれた場合は、そのバーチャル
 481     ホストへのすべてのリクエストやエラーがそこで指定されたファイルにのみ
 482     ログ収集されます。ロギングディレクティブのないバーチャルホストは
 483     依然としてリクエストが主サーバのログに送られます。この手法は少ない
 484     バーチャルホストに対しては非常に有用ですが、ホストの数が非常に多くなると
 485     管理が大変になります。さらに、<a href="vhosts/fd-limits.html">ファイル記述子の限界</a>の問題を起こすことが
 486     あります。</p>
 487
 488     <p>アクセスログには、非常に良い妥協案があります。バーチャルホストの
 489     情報をログのフォーマット文字列に加えることで、すべてのホストへの
 490     リクエストを同じログにログ収集して、後でログを個々のファイルに分割することが
 491     できます。たとえば、以下のディレクティブを見てください。</p>
 492
 493     <div class="example"><p><code>
 494       LogFormat "%v %l %u %t \"%r\" %&gt;s %b"
 495       comonvhost<br />
 496       CustomLog logs/access_log comonvhost
 497     </code></p></div>
 498
 499     <p><code>%v</code> がリクエストを扱っているバーチャルホストの名前を
 500     ログ収集するために使われています。そして、<a href="programs/other.html">split-logfile</a> のようなプログラムを
 501     使ってアクセスログを後処理することで、
 502     バーチャルホスト毎のファイルにログを分割することができます。</p>
 503
 504     <p>残念ながら、エラーログには同様の手法はありません。ですから、
 505     すべてのバーチャルホストを同じエラーログの中に混ぜるか、
 506     バーチャルホスト毎にエラーログを使うかを選ばなければなりません。</p>
 507   </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 508 <div class="section">
 509 <h2><a name="other" id="other">他のログファイル</a></h2>
 510
 511
 512     <table class="related"><tr><th>関連モジュール</th><th>関連ディレクティブ</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code></li><li><code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewritelog">RewriteLog</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewriteloglevel">RewriteLogLevel</a></code></li><li><code class="directive"><a href="./mod/mod_cgi.html#scriptlog">ScriptLog</a></code></li><li><code class="directive"><a href="./mod/mod_cgi.html#scriptlogbuffer">ScriptLogBuffer</a></code></li><li><code class="directive"><a href="./mod/mod_cgi.html#scriptloglength">ScriptLogLength</a></code></li></ul></td></tr></table>
 513
 514     <h3><a name="pidfile" id="pidfile">PID ファイル</a></h3>
 515
 516
 517       <p>起動時に、Apache は親 httpd プロセスのプロセス ID を
 518       <code>logs/httpd.pid</code> に保存します。この
 519       ファイル名は <code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code> ディレクティブを使って
 520       変更することができます。プロセス ID は管理者が親プロセスに
 521       シグナルを送ることでデーモンを再起動したり終了させたりするときに
 522       使用します。Windows では、代わりに -k コマンドオプションを
 523       使ってください。詳しい情報は <a href="stopping.html">終了と
 524       再起動</a> のページを見てください。</p>
 525
 526
 527     <h3><a name="scriptlog" id="scriptlog">スクリプトログ</a></h3>
 528
 529
 530       <p>デバッグの補助のために、<code class="directive"><a href="./mod/mod_cgi.html#scriptlog">ScriptLog</a></code> ディレクティブは
 531       CGI スクリプトの入力と出力を記録するようにできます。
 532       これはテスト用にのみ使用して、通常のサーバでは使用しないでください。
 533       詳しい情報は <a href="mod/mod_cgi.html">mod_cgi の文書</a> にあります。</p>
 534
 535
 536     <h3><a name="rewritelog" id="rewritelog">リライトログ</a></h3>
 537
 538
 539       <p><code class="directive"><a href="./mod/mod_rewrite.html#mod_rewrite">mod_rewrite</a></code> の強力で
 540       複雑な機能を
 541       使っているときは、ほぼいつもデバッグを簡単にするために
 542       <code class="directive"><a href="./mod/mod_rewrite.html#rewritelog">RewriteLog</a></code> の使用が
 543       必要でしょう。このログファイルにはリライトエンジンがリクエストを
 544       書き換える方法の詳細な解析が出力されます。詳しさの度合は <code class="directive"><a href="./mod/mod_rewrite.html#rewriteloglevel">RewriteLogLevel</a></code>
 545       で制御できます。</p>
 546
 547   </div></div>
 548 <div class="bottomlang">
 549 <p><span>Available Languages: </span><a href="./en/logs.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 550 <a href="./es/logs.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
 551 <a href="./ja/logs.html" title="Japanese">&nbsp;ja&nbsp;</a> |
 552 <a href="./ko/logs.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
 553 <a href="./tr/logs.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
 554 </div><div id="footer">
 555 <p class="apache">Copyright 2009 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
 556 <p class="menu"><a href="./mod/">モジュール</a> | <a href="./mod/directives.html">ディレクティブ</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p></div>
 557 </body></html>