6ae232055d4d8a97267517c5e50074c2c819941and<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
fd9abdda70912b99b24e3bf1a38f26fde908a74cnd<html xmlns="http://www.w3.org/1999/xhtml" lang="ja" xml:lang="ja"><head>
fd9abdda70912b99b24e3bf1a38f26fde908a74cnd<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
6ae232055d4d8a97267517c5e50074c2c819941and XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
6ae232055d4d8a97267517c5e50074c2c819941and This file is generated from xml source: DO NOT EDIT
6ae232055d4d8a97267517c5e50074c2c819941and XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
6ae232055d4d8a97267517c5e50074c2c819941and<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
6ae232055d4d8a97267517c5e50074c2c819941and<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
d29d9ab4614ff992b0e8de6e2b88d52b6f1f153erbowen<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="/style/css/prettify.css" />
2e545ce2450a9953665f701bb05350f0d3f26275nd<script src="/style/scripts/prettify.min.js" type="text/javascript">
6ae232055d4d8a97267517c5e50074c2c819941and<link href="/images/favicon.ico" rel="shortcut icon" /></head>
af33a4994ae2ff15bc67d19ff1a7feb906745bf8rbowen<p class="menu"><a href="/mod/">モジュール</a> | <a href="/mod/quickreference.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">用語</a> | <a href="/sitemap.html">サイトマップ</a></p>
6ae232055d4d8a97267517c5e50074c2c819941and<div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div>
b43f840409794ed298e8634f6284741f193b6c4ftakashi<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP サーバ</a> > <a href="http://httpd.apache.org/docs/">ドキュメンテーション</a> > <a href="./">バージョン 2.5</a></div><div id="page-content"><div id="preamble"><h1>ログファイル</h1>
b43f840409794ed298e8634f6284741f193b6c4ftakashi<p><span>翻訳済み言語: </span><a href="/en/logs.html" hreflang="en" rel="alternate" title="English"> en </a> |
af84459fbf938e508fd10b01cb8d699c79083813takashi<a href="/fr/logs.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
6ae232055d4d8a97267517c5e50074c2c819941and<a href="/ja/logs.html" title="Japanese"> ja </a> |
1d980e5489836e977ba59b419e27b0ec875c4bd3takashi<a href="/ko/logs.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
f086b4b402fa9a2fefc7dda85de2a3cc1cd0a654rjung<a href="/tr/logs.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
b43f840409794ed298e8634f6284741f193b6c4ftakashi 最近更新された内容を見るには英語版をご覧下さい。
6ae232055d4d8a97267517c5e50074c2c819941and <p>ウェブサーバを効果的に管理するためには、サーバの活動やパフォーマンス、
6ae232055d4d8a97267517c5e50074c2c819941and 今発生しているかもしれない問題に関するフィードバックを得ることが必要です。
6ae232055d4d8a97267517c5e50074c2c819941and Apache HTTP サーバには非常に包括的で柔軟なロギング機能があります。
6ae232055d4d8a97267517c5e50074c2c819941and この文書はロギング機能の設定の仕方と、ログに何が書かれているかを
6ae232055d4d8a97267517c5e50074c2c819941and 理解するための方法を説明します。</p>
6ae232055d4d8a97267517c5e50074c2c819941and<div id="quickview"><ul id="toc"><li><img alt="" src="/images/down.gif" /> <a href="#security">
6ae232055d4d8a97267517c5e50074c2c819941and<li><img alt="" src="/images/down.gif" /> <a href="#errorlog">エラーログ</a></li>
6ae232055d4d8a97267517c5e50074c2c819941and<li><img alt="" src="/images/down.gif" /> <a href="#accesslog">アクセスログ</a></li>
6ae232055d4d8a97267517c5e50074c2c819941and<li><img alt="" src="/images/down.gif" /> <a href="#rotation">ログの交替</a></li>
6ae232055d4d8a97267517c5e50074c2c819941and<li><img alt="" src="/images/down.gif" /> <a href="#piped">パイプ経由のログ</a></li>
6ae232055d4d8a97267517c5e50074c2c819941and<li><img alt="" src="/images/down.gif" /> <a href="#virtualhosts">バーチャルホスト</a></li>
6ae232055d4d8a97267517c5e50074c2c819941and<li><img alt="" src="/images/down.gif" /> <a href="#other">他のログファイル</a></li>
30471a4650391f57975f60bbb6e4a90be7b284bfhumbedooh</ul><ul class="seealso"><li><a href="#comments_section">コメント</a></li></ul></div>
6ae232055d4d8a97267517c5e50074c2c819941and<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
6ae232055d4d8a97267517c5e50074c2c819941and <p>Apache がログファイルを書いているディレクトリに書き込める人は、
6ae232055d4d8a97267517c5e50074c2c819941and ほぼ確実にサーバが起動された uid へのアクセスを手に入れることができます。
6ae232055d4d8a97267517c5e50074c2c819941and そして、それは通常は root ユーザです。
6ae232055d4d8a97267517c5e50074c2c819941and ちゃんと結果を考えることなく、そのディレクトリへの
6ae232055d4d8a97267517c5e50074c2c819941and 読んでください。</p>
6ae232055d4d8a97267517c5e50074c2c819941and <p>加えて、ログファイルにはクライアントからの情報がそのまま、
6ae232055d4d8a97267517c5e50074c2c819941and エスケープされることなく書かれています。ですから、悪意のある
6ae232055d4d8a97267517c5e50074c2c819941and クライアントがログファイルに制御文字を挿入することができます。
6ae232055d4d8a97267517c5e50074c2c819941and 生のログを扱うときは注意してください。</p>
6ae232055d4d8a97267517c5e50074c2c819941and </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
6ae232055d4d8a97267517c5e50074c2c819941and <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>
6ae232055d4d8a97267517c5e50074c2c819941and <p><code class="directive"><a href="/mod/core.html#errorlog">ErrorLog</a></code> ディレクティブにより
6ae232055d4d8a97267517c5e50074c2c819941and 名前と場所が決まるサーバのエラーログは、一番重要なログファイルです。
6ae232055d4d8a97267517c5e50074c2c819941and Apache の診断情報はここに送られ、リクエストを処理しているときに
6ae232055d4d8a97267517c5e50074c2c819941and 発生したエラーはすべてここに記録されます。サーバを起動したときや、
6ae232055d4d8a97267517c5e50074c2c819941and サーバの動作に問題が起こったときは、一番最初に調べるべき
6ae232055d4d8a97267517c5e50074c2c819941and ところです。間違いの詳細や修正方法がそこに書かれていることが
6ae232055d4d8a97267517c5e50074c2c819941and よくあります。</p>
4b3a8afbfcea8b265d179a122bf40dfedd1ce280takashi <p>エラーログは普通はファイルに書かれます (通常 Unix システムでは
6ae232055d4d8a97267517c5e50074c2c819941and <code>error_log</code>、Windows と OS/2 では <code>error.log</code>)。
6ae232055d4d8a97267517c5e50074c2c819941and <p>エラーログの書式は比較的自由度の高いもので、説明的に書かれています。
6ae232055d4d8a97267517c5e50074c2c819941and ただし、いくつかの情報はほとんどのエラーログのエントリにあります。
6ae232055d4d8a97267517c5e50074c2c819941and 例えば、代表的なものに次のようなメッセージがあります。</p>
6ae232055d4d8a97267517c5e50074c2c819941and [Wed Oct 11 14:32:52 2000] [error] [client 127.0.0.1]
6ae232055d4d8a97267517c5e50074c2c819941and client denied by server configuration:
6ae232055d4d8a97267517c5e50074c2c819941and <p>ログエントリの最初の項目はメッセージの日付と時刻です。
6ae232055d4d8a97267517c5e50074c2c819941and 二つめの項目は報告されているエラーの重要度です。
6ae232055d4d8a97267517c5e50074c2c819941and <code class="directive"><a href="/mod/core.html#loglevel">LogLevel</a></code> で重要度のレベルを
6ae232055d4d8a97267517c5e50074c2c819941and 制限することによりエラーログに送られるエラーの種類を制御することが
6ae232055d4d8a97267517c5e50074c2c819941and できます。三つ目の項目はエラーを発生させたクライアントの IP アドレス
6ae232055d4d8a97267517c5e50074c2c819941and です。残りはメッセージで、この場合はサーバがクライアントのアクセスを
6ae232055d4d8a97267517c5e50074c2c819941and 拒否するように設定されている、ということを示しています。
6ae232055d4d8a97267517c5e50074c2c819941and サーバはリクエストされた文書の (ウェブのパスではなく) ファイルシステムの
6ae232055d4d8a97267517c5e50074c2c819941and パスを報告します。</p>
6ae232055d4d8a97267517c5e50074c2c819941and <p>非常に広範囲のメッセージがエラーログに現れます。たいていのものは
6ae232055d4d8a97267517c5e50074c2c819941and 上の例のような感じです。エラーログには CGI スクリプトのデバッグ
6ae232055d4d8a97267517c5e50074c2c819941and すべての情報は直接エラーログにコピーされます。</p>
6ae232055d4d8a97267517c5e50074c2c819941and <p>情報を追加したり削除したりしてエラーログをカスタマイズすることは
6ae232055d4d8a97267517c5e50074c2c819941and できません。しかし、リクエストに対するエラーログのエントリは、
6ae232055d4d8a97267517c5e50074c2c819941and 例えば、上の例のエントリはアクセスログのステータスコード 403 の
6ae232055d4d8a97267517c5e50074c2c819941and エントリに対応します。アクセスログはカスタマイズ可能ですので、
6ae232055d4d8a97267517c5e50074c2c819941and そちらを使うことによりエラーの状況に関する情報をより多く
6ae232055d4d8a97267517c5e50074c2c819941and 手に入れることができます。</p>
6ae232055d4d8a97267517c5e50074c2c819941and <p>テストの最中は、問題が発生しているかどうかを見るために、
6ae232055d4d8a97267517c5e50074c2c819941and 常にエラーログを監視するのが役に立つ場合がよくあります。
6ae232055d4d8a97267517c5e50074c2c819941and Unix システムでは、次のものを使うことができます。</p>
6ae232055d4d8a97267517c5e50074c2c819941and tail -f error_log
6ae232055d4d8a97267517c5e50074c2c819941and </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
6ae232055d4d8a97267517c5e50074c2c819941and <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>
6ae232055d4d8a97267517c5e50074c2c819941and <p>サーバアクセスログはサーバが処理をしたすべてのリクエストを
6ae232055d4d8a97267517c5e50074c2c819941and 記録します。アクセスログの場所と内容は <code class="directive"><a href="/mod/mod_log_config.html#customlog">CustomLog</a></code>
6ae232055d4d8a97267517c5e50074c2c819941and ディレクティブにより決まります。ログの内容の選択を簡潔にするために
6ae232055d4d8a97267517c5e50074c2c819941and <code class="directive"><a href="/mod/mod_log_config.html#logformat">LogFormat</a></code>
6ae232055d4d8a97267517c5e50074c2c819941and ディレクティブを使用することができます。このセクションはアクセスログに
6ae232055d4d8a97267517c5e50074c2c819941and 情報を記録するためのサーバの設定方法を説明します。</p>
6ae232055d4d8a97267517c5e50074c2c819941and <p>もちろん、アクセスログに情報を蓄積することはログ管理の
6ae232055d4d8a97267517c5e50074c2c819941and 始まりに過ぎません。次の段階は有用な統計を取るためにこの情報を
6ae232055d4d8a97267517c5e50074c2c819941and 解析することです。一般的なログ解析はこの文書の範囲外で、
6ae232055d4d8a97267517c5e50074c2c819941and ウェブサーバ自身の仕事というわけでもありません。この話や、
6ae232055d4d8a97267517c5e50074c2c819941and ログ解析を行なうアプリケーションの情報を得るには、<a href="http://dmoz.org/Computers/Software/Internet/Site_Management/Log_analysis/">
6ae232055d4d8a97267517c5e50074c2c819941and Open Directory</a> や <a href="http://dir.yahoo.com/Computers_and_Internet/Software/Internet/World_Wide_Web/Servers/Log_Analysis_Tools/">
6ae232055d4d8a97267517c5e50074c2c819941and <p>いろんなバージョンの Apache httpd が mod_log_config,
6ae232055d4d8a97267517c5e50074c2c819941and 他のモジュールやディレクティブを使ってアクセスのロギングを
6ae232055d4d8a97267517c5e50074c2c819941and 制御してきました。今では、<code class="directive"><a href="/mod/mod_log_config.html#customlog">CustomLog</a></code> がすべての古い
6ae232055d4d8a97267517c5e50074c2c819941and ディレクティブの機能を含むようになっています。</p>
6ae232055d4d8a97267517c5e50074c2c819941and <p>アクセスログの書式は非常に柔軟な設定が可能です。
6ae232055d4d8a97267517c5e50074c2c819941and 書式は C の printf(1) フォーマット文字列に非常に似た
6ae232055d4d8a97267517c5e50074c2c819941and <code class="directive"><a href="/mod/mod_log_config.html#フォーマット文字列">フォーマット文字列</a></code>
6ae232055d4d8a97267517c5e50074c2c819941and により指定されます。いくつか次の節で例を示します。
6ae232055d4d8a97267517c5e50074c2c819941and フォーマット文字列に使用できる内容の一覧は <a href="mod/mod_log_config.html">mod_log_config の文書</a>
6ae232055d4d8a97267517c5e50074c2c819941and を見てください。</p>
6ae232055d4d8a97267517c5e50074c2c819941and <h3><a name="common" id="common">Common Log Format</a></h3>
6ae232055d4d8a97267517c5e50074c2c819941and LogFormat "%h %l %u %t \"%r\" %>s %b" common<br />
6ae232055d4d8a97267517c5e50074c2c819941and ログのフォーマット文字列の一つと関連付けます。フォーマット文字列は
6ae232055d4d8a97267517c5e50074c2c819941and パーセントディレクティブからなり、それぞれのパーセントディレクティブは
6ae232055d4d8a97267517c5e50074c2c819941and サーバにどの情報をロギングするかを指示します。フォーマット文字列に
6ae232055d4d8a97267517c5e50074c2c819941and 文字をそのまま入れることもでき、それらはログの出力に直接コピーされます。
6ae232055d4d8a97267517c5e50074c2c819941and フォーマット文字列の最後として解釈
6ae232055d4d8a97267517c5e50074c2c819941and されることを防ぐためにバックスラッシュでエスケープする必要があります。
6ae232055d4d8a97267517c5e50074c2c819941and <p><code class="directive"><a href="/mod/mod_log_config.html#customlog">CustomLog</a></code> ディレクティブは
6ae232055d4d8a97267517c5e50074c2c819941and アクセスログのファイル名はスラッシュで始まらない限り、
6ae232055d4d8a97267517c5e50074c2c819941and <code class="directive"><a href="/mod/core.html#serverroot">ServerRoot</a></code> からの相対パスとして
6ae232055d4d8a97267517c5e50074c2c819941and 扱われます。</p>
6ae232055d4d8a97267517c5e50074c2c819941and <p>上の設定は Common Log Format (CLF) と呼ばれる形式で
6ae232055d4d8a97267517c5e50074c2c819941and ログエントリを書きます。この標準の形式は異なるウェブサーバの多くが
6ae232055d4d8a97267517c5e50074c2c819941and 生成することができ、多くのログ解析プログラムが読みこむことができます。
6ae232055d4d8a97267517c5e50074c2c819941and CLF により生成されたログファイルのエントリは以下のようになります:</p>
6ae232055d4d8a97267517c5e50074c2c819941and <dd>これはサーバへリクエストをしたクライアント (リモートホスト)
6ae232055d4d8a97267517c5e50074c2c819941and の IP アドレスです。<code class="directive"><a href="/mod/core.html#hostnamelookups">HostnameLookups</a></code> が
6ae232055d4d8a97267517c5e50074c2c819941and IP アドレスが書かれているところに記録します。しかし、この設定は
6ae232055d4d8a97267517c5e50074c2c819941and サーバをかなり遅くするので、あまりお勧めできません。
6ae232055d4d8a97267517c5e50074c2c819941and そうではなく、<code class="program"><a href="/programs/logresolve.html">logresolve</a></code> の
6ae232055d4d8a97267517c5e50074c2c819941and ようなログの後処理を行なうプログラムでホスト名を調べるのが良いでしょう。
6ae232055d4d8a97267517c5e50074c2c819941and ここに報告される IP アドレスは必ずしもユーザが使っているマシンの
6ae232055d4d8a97267517c5e50074c2c819941and ものであるとは限りません。ユーザとサーバの間にプロキシサーバが
6ae232055d4d8a97267517c5e50074c2c819941and あれば、このアドレスは元のマシンのものではなく、プロキシの
6ae232055d4d8a97267517c5e50074c2c819941and アドレスになります。</dd>
6ae232055d4d8a97267517c5e50074c2c819941and <dd>出力中の「ハイフン」は要求された情報が手に入らなかったということを
6ae232055d4d8a97267517c5e50074c2c819941and 意味します。この場合、取得できなかった情報はクライアントのマシンの
6ae232055d4d8a97267517c5e50074c2c819941and アイデンティティです。この情報はあまり信用することができず、
6ae232055d4d8a97267517c5e50074c2c819941and しっかりと管理された内部ネットワークを除いては使うべきではありません。
6ae232055d4d8a97267517c5e50074c2c819941and Apache は <code class="directive"><a href="/mod/core.html#identitycheck">IdentityCheck</a></code> が
6ae232055d4d8a97267517c5e50074c2c819941and <dd>これは HTTP 認証による、ドキュメントをリクエストした人の
6ae232055d4d8a97267517c5e50074c2c819941and 環境変数として与えられます。リクエストのステータスコード
6ae232055d4d8a97267517c5e50074c2c819941and (以下を参照) が 401 であった場合は、ユーザは認証に失敗しているので、
6ae232055d4d8a97267517c5e50074c2c819941and この値は信用できません。ドキュメントがパスワードで保護されていない
6ae232055d4d8a97267517c5e50074c2c819941and なります。</dd>
6ae232055d4d8a97267517c5e50074c2c819941and サーバがリクエストを受け取った時刻です。書式は:
6ae232055d4d8a97267517c5e50074c2c819941and day = 2*digit<br />
6ae232055d4d8a97267517c5e50074c2c819941and month = 3*letter<br />
6ae232055d4d8a97267517c5e50074c2c819941and year = 4*digit<br />
6ae232055d4d8a97267517c5e50074c2c819941and hour = 2*digit<br />
6ae232055d4d8a97267517c5e50074c2c819941and minute = 2*digit<br />
6ae232055d4d8a97267517c5e50074c2c819941and second = 2*digit<br />
6ae232055d4d8a97267517c5e50074c2c819941and zone = (`+' | `-') 4*digit</code>
6ae232055d4d8a97267517c5e50074c2c819941and 指定することで、別の形式で時刻を表示させることもできます。
6ae232055d4d8a97267517c5e50074c2c819941and <dd>クライアントからのリクエストが二重引用符の中に示されています。
6ae232055d4d8a97267517c5e50074c2c819941and リクエストには多くの有用な情報があります。まず、この場合クライアントが
6ae232055d4d8a97267517c5e50074c2c819941and リクエストの各部分を独立にログ収集することもできます。例えば、
6ae232055d4d8a97267517c5e50074c2c819941and メソッド、パス、クエリ文字列、プロトコルをログ収集し、
6ae232055d4d8a97267517c5e50074c2c819941and <dd>サーバがクライアントに送り返すステータスコードです。
6ae232055d4d8a97267517c5e50074c2c819941and この情報は、リクエストが成功応答 (2 で始まるコード) であったか、
6ae232055d4d8a97267517c5e50074c2c819941and リダイレクション (3 で始まるコード) であったか、クライアントによる
6ae232055d4d8a97267517c5e50074c2c819941and エラー (4 で始まるコード) であったか、サーバのエラー (5 で始まるコード)
4b3a8afbfcea8b265d179a122bf40dfedd1ce280takashi であったか、を表すので、非常に大切です。ステータスコードの
6ae232055d4d8a97267517c5e50074c2c819941and 完全なリストは <a href="http://www.w3.org/Protocols/rfc2616/rfc2616.txt">HTTP
4b3a8afbfcea8b265d179a122bf40dfedd1ce280takashi <dd>この最後の部分はクライアントに送信されたオブジェクトの、
4b3a8afbfcea8b265d179a122bf40dfedd1ce280takashi 応答ヘッダを除いたサイズを表します。コンテントがクライアントに送られなかった
6ae232055d4d8a97267517c5e50074c2c819941and <h3><a name="combined" id="combined">Combined Log Format</a></h3>
6ae232055d4d8a97267517c5e50074c2c819941and <p>もう一つのよく使われる書式は Combined Log Format と呼ばれています。
6ae232055d4d8a97267517c5e50074c2c819941and 以下のようにして使うことができます。</p>
6ae232055d4d8a97267517c5e50074c2c819941and LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\"
6ae232055d4d8a97267517c5e50074c2c819941and \"%{User-agent}i\"" combined<br />
6ae232055d4d8a97267517c5e50074c2c819941and <p>この書式の最初の方は Common Log Format とまったく同じで、最後に
6ae232055d4d8a97267517c5e50074c2c819941and 二つ追加のエントリがあります。追加のエントリはパーセントディレクティブ
6ae232055d4d8a97267517c5e50074c2c819941and アクセスログは以下のような感じになります:</p>
6ae232055d4d8a97267517c5e50074c2c819941and (Win98; I ;Nav)"
6ae232055d4d8a97267517c5e50074c2c819941and <dd>"Referer" (意図的な綴り間違い) HTTP リクエストヘッダです。
6ae232055d4d8a97267517c5e50074c2c819941and これはクライアントが報告してくる参照元のサイトを表します。
6ae232055d4d8a97267517c5e50074c2c819941and それを含んでいるページです)。</dd>
6ae232055d4d8a97267517c5e50074c2c819941and <dd>User-Agent HTTP リクエストヘッダです。これはクライアントのブラウザが
6ae232055d4d8a97267517c5e50074c2c819941and 自分自身のことを報告してくる情報です。</dd>
6ae232055d4d8a97267517c5e50074c2c819941and <p>複数のアクセスログは単に設定ファイルに複数の <code class="directive"><a href="/mod/mod_log_config.html#customlog">CustomLog</a></code>
6ae232055d4d8a97267517c5e50074c2c819941and ディレクティブを書くことで作成されます。例えば、以下のディレクティブは
6ae232055d4d8a97267517c5e50074c2c819941and 三つのアクセスログを作ります。最初のものは基本的な CLF の情報で、
6ae232055d4d8a97267517c5e50074c2c819941and 二つ目と三つ目は referer とブラウザの情報です。最後二つの
6ae232055d4d8a97267517c5e50074c2c819941and <code class="directive"><a href="/mod/mod_log_config.html#customlog">CustomLog</a></code> は
6ae232055d4d8a97267517c5e50074c2c819941and LogFormat "%h %l %u %t \"%r\" %>s %b" common<br />
6ae232055d4d8a97267517c5e50074c2c819941and <p>この例は <code class="directive"><a href="/mod/mod_log_config.html#logformat">LogFormat</a></code> で
6ae232055d4d8a97267517c5e50074c2c819941and ニックネームを定義する必要がない、
6ae232055d4d8a97267517c5e50074c2c819941and ということも示しています。ニックネームの代わりに、
6ae232055d4d8a97267517c5e50074c2c819941and <code class="directive"><a href="/mod/mod_log_config.html#customlog">CustomLog</a></code> ディレクティブに
6ae232055d4d8a97267517c5e50074c2c819941and 直接ログの書式を指定することができます。</p>
6ae232055d4d8a97267517c5e50074c2c819941and <h3><a name="conditional" id="conditional">条件付きログ</a></h3>
6ae232055d4d8a97267517c5e50074c2c819941and <p>クライアントのリクエストの特徴に基づいてアクセスログにエントリの
6ae232055d4d8a97267517c5e50074c2c819941and 一部をロギングしない方が便利なことがあります。これは <a href="env.html">環境変数</a> の補助により簡単に実現できます。まず、
4b3a8afbfcea8b265d179a122bf40dfedd1ce280takashi リクエストが何らかの条件に合うということを表すために環境変数が
6ae232055d4d8a97267517c5e50074c2c819941and 設定される必要があります。これは通常は <code class="directive"><a href="/mod/mod_setenvif.html#setenvif">SetEnvIf</a></code> により
6ae232055d4d8a97267517c5e50074c2c819941and 行なわれます。そして、<code class="directive"><a href="/mod/mod_log_config.html#customlog">CustomLog</a></code> ディレクティブの
6ae232055d4d8a97267517c5e50074c2c819941and 含めたり排除したりすることができます。いくつか例を挙げます:</p>
6ae232055d4d8a97267517c5e50074c2c819941and # Mark requests from the loop-back interface<br />
6ae232055d4d8a97267517c5e50074c2c819941and SetEnvIf Remote_Addr "127\.0\.0\.1" dontlog<br />
6ae232055d4d8a97267517c5e50074c2c819941and SetEnvIf Request_URI "^/robots\.txt$" dontlog<br />
6ae232055d4d8a97267517c5e50074c2c819941and # Log what remains<br />
6ae232055d4d8a97267517c5e50074c2c819941and <p>他の例として、英語を話す人からのリクエストとそれ以外の人からのリクエストを
6ae232055d4d8a97267517c5e50074c2c819941and 分けたい、という場合を考えてみてください。</p>
6ae232055d4d8a97267517c5e50074c2c819941and SetEnvIf Accept-Language "en" english<br />
6ae232055d4d8a97267517c5e50074c2c819941and <p>ここまででは条件付きロギングが非常に強力で柔軟であることを示してきましたが、
6ae232055d4d8a97267517c5e50074c2c819941and それがログの内容を制御する唯一の方法というわけではありません。ログファイルは
6ae232055d4d8a97267517c5e50074c2c819941and サーバの活動の完全な記録である方がより役に立ちます。単純にログファイルを
6ae232055d4d8a97267517c5e50074c2c819941and 後処理して、考慮したくないログを削除する方が簡単であることがよくあります。</p>
6ae232055d4d8a97267517c5e50074c2c819941and </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
6ae232055d4d8a97267517c5e50074c2c819941and <p>普通の負荷のサーバでさえ、ログファイルに保存される情報の量は
6ae232055d4d8a97267517c5e50074c2c819941and 膨大になります。アクセスログのファイルは普通 10,000 リクエスト毎に
6ae232055d4d8a97267517c5e50074c2c819941and 1 MB 以上増えます。ですから、既存のログを移動したり、削除したりして、
6ae232055d4d8a97267517c5e50074c2c819941and 定期的にログを交替させることが必要になります。これはサーバの実行中には
6ae232055d4d8a97267517c5e50074c2c819941and 行なえません。というのは、Apache はファイルが open されている間は
6ae232055d4d8a97267517c5e50074c2c819941and ずっと古いログファイルに書き続けるからです。
6ae232055d4d8a97267517c5e50074c2c819941and 新しいログファイルを open できるように、ログファイルが移動されたり
6ae232055d4d8a97267517c5e50074c2c819941and 必要があります。</p>
6ae232055d4d8a97267517c5e50074c2c819941and 処理待ちのコネクションを失うことなく新しいログファイルを open させる
6ae232055d4d8a97267517c5e50074c2c819941and ことができます。しかし、これを実現するために、サーバは古いリクエストを
6ae232055d4d8a97267517c5e50074c2c819941and 扱っている間は古いログファイルに書き続ける必要があります。
6ae232055d4d8a97267517c5e50074c2c819941and ですから、再起動の後ではログファイルの処理を始める前に、しばらく待たなければ
6ae232055d4d8a97267517c5e50074c2c819941and なりません。単にログを交替させて、ディスクの節約のために古いログを
6ae232055d4d8a97267517c5e50074c2c819941and 圧縮する普通のシナリオは:</p>
6ae232055d4d8a97267517c5e50074c2c819941and apachectl graceful<br />
6ae232055d4d8a97267517c5e50074c2c819941and sleep 600<br />
6ae232055d4d8a97267517c5e50074c2c819941and <p>ログの交替をするもう一つの方法は<a href="#piped">パイプ経由のログ</a>を使うもので、次の節で説明されています。</p>
6ae232055d4d8a97267517c5e50074c2c819941and </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
6ae232055d4d8a97267517c5e50074c2c819941and <p>Apache httpd はエラーログとアクセスログをファイルに直接書く代わりに、
6ae232055d4d8a97267517c5e50074c2c819941and パイプを通して別のプログラムに書き出すことができます。
6ae232055d4d8a97267517c5e50074c2c819941and この機能により、主サーバにコードを追加することなく
6ae232055d4d8a97267517c5e50074c2c819941and ロギングの柔軟性が非常に高まっています。パイプにログを書くためには、
6ae232055d4d8a97267517c5e50074c2c819941and 標準入力からログのエントリを受けとる実行プログラムの名前を書くだけです。
6ae232055d4d8a97267517c5e50074c2c819941and Apache はパイプ経由のログ用のプロセスをサーバの起動時に実行し、
6ae232055d4d8a97267517c5e50074c2c819941and サーバの実行中にそのプログラムがクラッシュしたときはそれを再び
6ae232055d4d8a97267517c5e50074c2c819941and 実行します。(この最後の機能がこの技術が「信頼性のあるパイプ経由のロギング」
6ae232055d4d8a97267517c5e50074c2c819941and と呼ばれている理由です。)</p>
6ae232055d4d8a97267517c5e50074c2c819941and <p>パイプ経由のログ用のプロセスは Apache httpd の親プロセスから起動され、
4b3a8afbfcea8b265d179a122bf40dfedd1ce280takashi そのプロセスのユーザ ID を継承します。これは、パイプ経由のログ用の
6ae232055d4d8a97267517c5e50074c2c819941and プログラムは普通 root として実行されることを意味します。
6ae232055d4d8a97267517c5e50074c2c819941and ですから、プログラムを簡単で安全に保つことが非常に重要です。</p>
6ae232055d4d8a97267517c5e50074c2c819941and <p>パイプ経由のログの重要な利用法は、サーバの再起動なしでログの交替を
6ae232055d4d8a97267517c5e50074c2c819941and することです。Apache HTTP サーバにはこのための <code class="program"><a href="/programs/rotatelogs.html">rotatelogs</a></code> と呼ばれる簡単な
6ae232055d4d8a97267517c5e50074c2c819941and プログラムが付属しています。たとえば、24 時間毎にログを交替させるには、
6ae232055d4d8a97267517c5e50074c2c819941and 以下のものを使うことができます:</p>
6ae232055d4d8a97267517c5e50074c2c819941and <p>パイプの先で呼ばれるコマンド全体が引用符で囲まれていることに注目して
6ae232055d4d8a97267517c5e50074c2c819941and ください。この例はアクセスログを使っていますが、エラーログにも同じ技術を
6ae232055d4d8a97267517c5e50074c2c819941and 使うことができます。</p>
6ae232055d4d8a97267517c5e50074c2c819941and <p>似ているけれど、よりずっと柔軟な
6ae232055d4d8a97267517c5e50074c2c819941and <a href="http://www.cronolog.org/">cronolog</a> というログ交替用の
6ae232055d4d8a97267517c5e50074c2c819941and プログラムが外部のサイトにあります。</p>
6ae232055d4d8a97267517c5e50074c2c819941and <p>条件付きロギングと同様、パイプ経由のログは非常に強力な
6ae232055d4d8a97267517c5e50074c2c819941and 道具ですが、オフラインの後処理のような、より簡単な解決方法があるときは
6ae232055d4d8a97267517c5e50074c2c819941and 使わない方が良いでしょう。</p>
6ae232055d4d8a97267517c5e50074c2c819941and </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
6ae232055d4d8a97267517c5e50074c2c819941and<h2><a name="virtualhosts" id="virtualhosts">バーチャルホスト</a></h2>
6ae232055d4d8a97267517c5e50074c2c819941and ときは、ログファイルの扱い方にいくつかの方法があります。
6ae232055d4d8a97267517c5e50074c2c819941and まず、単独のホストのみのサーバとまったく同じようにログを使うことができます。
6ae232055d4d8a97267517c5e50074c2c819941and ロギングディレクティブを主サーバのコンテキストの
6ae232055d4d8a97267517c5e50074c2c819941and <code class="directive"><a href="/mod/core.html#virtualhost"><VirtualHost></a></code> セクションの外に置くことで、
6ae232055d4d8a97267517c5e50074c2c819941and すべてのログを同じアクセスログとエラーログにログ収集することができます。
6ae232055d4d8a97267517c5e50074c2c819941and この手法では個々のバーチャルホストの統計を簡単にとることはできません。</p>
4b3a8afbfcea8b265d179a122bf40dfedd1ce280takashi <p><code class="directive"><a href="/mod/mod_log_config.html#customlog">CustomLog</a></code> や
6ae232055d4d8a97267517c5e50074c2c819941and <code class="directive"><a href="/mod/mod_log_config.html#errorlog">ErrorLog</a></code> ディレクティブが
6ae232055d4d8a97267517c5e50074c2c819941and <code class="directive"><a href="/mod/core.html#virtualhost"><VirtualHost></a></code> の中に
6ae232055d4d8a97267517c5e50074c2c819941and 置かれた場合は、そのバーチャル
6ae232055d4d8a97267517c5e50074c2c819941and ホストへのすべてのリクエストやエラーがそこで指定されたファイルにのみ
6ae232055d4d8a97267517c5e50074c2c819941and ログ収集されます。ロギングディレクティブのないバーチャルホストは
6ae232055d4d8a97267517c5e50074c2c819941and 依然としてリクエストが主サーバのログに送られます。この手法は少ない
6ae232055d4d8a97267517c5e50074c2c819941and バーチャルホストに対しては非常に有用ですが、ホストの数が非常に多くなると
6ae232055d4d8a97267517c5e50074c2c819941and 管理が大変になります。さらに、<a href="vhosts/fd-limits.html">ファイル記述子の限界</a>の問題を起こすことが
6ae232055d4d8a97267517c5e50074c2c819941and <p>アクセスログには、非常に良い妥協案があります。バーチャルホストの
6ae232055d4d8a97267517c5e50074c2c819941and 情報をログのフォーマット文字列に加えることで、すべてのホストへの
6ae232055d4d8a97267517c5e50074c2c819941and リクエストを同じログにログ収集して、後でログを個々のファイルに分割することが
6ae232055d4d8a97267517c5e50074c2c819941and できます。たとえば、以下のディレクティブを見てください。</p>
6ae232055d4d8a97267517c5e50074c2c819941and LogFormat "%v %l %u %t \"%r\" %>s %b"
6ae232055d4d8a97267517c5e50074c2c819941and comonvhost<br />
6ae232055d4d8a97267517c5e50074c2c819941and ログ収集するために使われています。そして、<a href="programs/other.html">split-logfile</a> のようなプログラムを
6ae232055d4d8a97267517c5e50074c2c819941and 使ってアクセスログを後処理することで、
6ae232055d4d8a97267517c5e50074c2c819941and バーチャルホスト毎のファイルにログを分割することができます。</p>
6ae232055d4d8a97267517c5e50074c2c819941and <p>残念ながら、エラーログには同様の手法はありません。ですから、
6ae232055d4d8a97267517c5e50074c2c819941and すべてのバーチャルホストを同じエラーログの中に混ぜるか、
6ae232055d4d8a97267517c5e50074c2c819941and バーチャルホスト毎にエラーログを使うかを選ばなければなりません。</p>
6ae232055d4d8a97267517c5e50074c2c819941and </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
4b3a8afbfcea8b265d179a122bf40dfedd1ce280takashi <table class="related"><tr><th>関連モジュール</th><th>関連ディレクティブ</th></tr><tr><td><ul><li><code class="module"><a href="/mod/mod_logio.html">mod_logio</a></code></li><li><code class="module"><a href="/mod/mod_log_forensic.html">mod_log_forensic</a></code></li><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/mod_log_config.html#logformat">LogFormat</a></code></li><li><code class="directive"><a href="/mod/mod_log_forensic.html#forensiclog">ForensicLog</a></code></li><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>
4b3a8afbfcea8b265d179a122bf40dfedd1ce280takashi <p><code class="module"><a href="/mod/mod_logio.html">mod_logio</a></code> は、
4b3a8afbfcea8b265d179a122bf40dfedd1ce280takashi ネットワーク上で実際に送受信した数をログする
4b3a8afbfcea8b265d179a122bf40dfedd1ce280takashi 二つのフィールド (%I と %O) を
4b3a8afbfcea8b265d179a122bf40dfedd1ce280takashi <code class="directive"><a href="/mod/mod_log_config.html#logformat">LogFormat</a></code>
4b3a8afbfcea8b265d179a122bf40dfedd1ce280takashi ディレクティブに追加します。</p>
4b3a8afbfcea8b265d179a122bf40dfedd1ce280takashi <p><code class="module"><a href="/mod/mod_log_forensic.html">mod_log_forensic</a></code> はクライアントリクエストの
4b3a8afbfcea8b265d179a122bf40dfedd1ce280takashi forensic ログを取ります。ログはリクエスト処理前と処理後に
4b3a8afbfcea8b265d179a122bf40dfedd1ce280takashi 行われますので、1 リクエストに対して 2 行のログが出力されます。
4b3a8afbfcea8b265d179a122bf40dfedd1ce280takashi forensic ロガーはとても厳密でカスタマイズできません。
4b3a8afbfcea8b265d179a122bf40dfedd1ce280takashi デバッグやセキュリティ用のツールとして有効かもしれません。</p>
6ae232055d4d8a97267517c5e50074c2c819941and <p>起動時に、Apache は親 httpd プロセスのプロセス ID を
6ae232055d4d8a97267517c5e50074c2c819941and ファイル名は <code class="directive"><a href="/mod/mpm_common.html#pidfile">PidFile</a></code> ディレクティブを使って
6ae232055d4d8a97267517c5e50074c2c819941and 変更することができます。プロセス ID は管理者が親プロセスに
6ae232055d4d8a97267517c5e50074c2c819941and シグナルを送ることでデーモンを再起動したり終了させたりするときに
6ae232055d4d8a97267517c5e50074c2c819941and 使用します。Windows では、代わりに -k コマンドオプションを
6ae232055d4d8a97267517c5e50074c2c819941and <p>デバッグの補助のために、<code class="directive"><a href="/mod/mod_cgi.html#scriptlog">ScriptLog</a></code> ディレクティブは
6ae232055d4d8a97267517c5e50074c2c819941and CGI スクリプトの入力と出力を記録するようにできます。
6ae232055d4d8a97267517c5e50074c2c819941and これはテスト用にのみ使用して、通常のサーバでは使用しないでください。
6ae232055d4d8a97267517c5e50074c2c819941and 詳しい情報は <a href="mod/mod_cgi.html">mod_cgi の文書</a> にあります。</p>
6ae232055d4d8a97267517c5e50074c2c819941and <p><code class="directive"><a href="/mod/mod_rewrite.html#mod_rewrite">mod_rewrite</a></code> の強力で
6ae232055d4d8a97267517c5e50074c2c819941and 使っているときは、ほぼいつもデバッグを簡単にするために
6ae232055d4d8a97267517c5e50074c2c819941and <code class="directive"><a href="/mod/mod_rewrite.html#rewritelog">RewriteLog</a></code> の使用が
6ae232055d4d8a97267517c5e50074c2c819941and 必要でしょう。このログファイルにはリライトエンジンがリクエストを
6ae232055d4d8a97267517c5e50074c2c819941and 書き換える方法の詳細な解析が出力されます。詳しさの度合は <code class="directive"><a href="/mod/mod_rewrite.html#rewriteloglevel">RewriteLogLevel</a></code>
6ae232055d4d8a97267517c5e50074c2c819941and で制御できます。</p>
b43f840409794ed298e8634f6284741f193b6c4ftakashi<p><span>翻訳済み言語: </span><a href="/en/logs.html" hreflang="en" rel="alternate" title="English"> en </a> |
af84459fbf938e508fd10b01cb8d699c79083813takashi<a href="/fr/logs.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
6ae232055d4d8a97267517c5e50074c2c819941and<a href="/ja/logs.html" title="Japanese"> ja </a> |
1d980e5489836e977ba59b419e27b0ec875c4bd3takashi<a href="/ko/logs.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
f086b4b402fa9a2fefc7dda85de2a3cc1cd0a654rjung<a href="/tr/logs.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
727872d18412fc021f03969b8641810d8896820bhumbedooh</div><div class="top"><a href="#page-header"><img src="/images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">コメント</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
727872d18412fc021f03969b8641810d8896820bhumbedoohvar comments_shortname = 'httpd';
cc7e1025de9ac63bd4db6fe7f71c158b2cf09fe4humbedoohvar comments_identifier = 'http://httpd.apache.org/docs/trunk/logs.html';
0d0ba3a410038e179b695446bb149cce6264e0abnd(function(w, d) {
cc7e1025de9ac63bd4db6fe7f71c158b2cf09fe4humbedooh if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
727872d18412fc021f03969b8641810d8896820bhumbedooh d.write('<div id="comments_thread"><\/div>');
0d0ba3a410038e179b695446bb149cce6264e0abnd var s = d.createElement('script');
ac082aefa89416cbdc9a1836eaf3bed9698201c8humbedooh s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
0d0ba3a410038e179b695446bb149cce6264e0abnd (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
727872d18412fc021f03969b8641810d8896820bhumbedooh d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
0d0ba3a410038e179b695446bb149cce6264e0abnd})(window, document);
205f749042ed530040a4f0080dbcb47ceae8a374rjung<p class="apache">Copyright 2015 The Apache Software Foundation.<br />この文書は <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> のライセンスで提供されています。.</p>
af33a4994ae2ff15bc67d19ff1a7feb906745bf8rbowen<p class="menu"><a href="/mod/">モジュール</a> | <a href="/mod/quickreference.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">用語</a> | <a href="/sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
0d0ba3a410038e179b695446bb149cce6264e0abndif (typeof(prettyPrint) !== 'undefined') {
7fec19672a491661b2fe4b29f685bc7f4efa64d4nd prettyPrint();