granicus.if.org Git - apache/blob - docs/manual/mod/mod_log_config.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>mod_log_config - Apache HTTP サーバ バージョン 2.5</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" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
  12 <script src="../style/scripts/prettify.min.js" type="text/javascript">
  13 </script>
  14
  15 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  16 <body>
  17 <div id="page-header">
  18 <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>
  19 <p class="apache">Apache HTTP サーバ バージョン 2.5</p>
  20 <img alt="" src="../images/feather.gif" /></div>
  21 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
  22 <div id="path">
  23 <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.5</a> &gt; <a href="./">モジュール</a></div>
  24 <div id="page-content">
  25 <div id="preamble"><h1>Apache モジュール mod_log_config</h1>
  26 <div class="toplang">
  27 <p><span>翻訳済み言語: </span><a href="../en/mod/mod_log_config.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  28 <a href="../ja/mod/mod_log_config.html" title="Japanese">&nbsp;ja&nbsp;</a> |
  29 <a href="../ko/mod/mod_log_config.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
  30 <a href="../tr/mod/mod_log_config.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
  31 </div>
  32 <div class="outofdate">この日本語訳はすでに古くなっている
  33             可能性があります。
  34             最近更新された内容を見るには英語版をご覧下さい。
  35         </div>
  36 <table class="module"><tr><th><a href="module-dict.html#Description">説明:</a></th><td>サーバへのリクエストのロギング</td></tr>
  37 <tr><th><a href="module-dict.html#Status">ステータス:</a></th><td>Base</td></tr>
  38 <tr><th><a href="module-dict.html#ModuleIdentifier">モジュール識別子:</a></th><td>log_config_module</td></tr>
  39 <tr><th><a href="module-dict.html#SourceFile">ソースファイル:</a></th><td>mod_log_config.c</td></tr></table>
  40 <h3>概要</h3>
  41
  42     <p>
  43     このモジュールはクライアントのリクエストを柔軟にログ収集する機能を
  44     提供します。ログはカスタマイズ可能な書式で書かれ、ファイルに直接
  45     書いたり、外部プログラムに渡したりすることができます。個々のリクエストを
  46     特徴に応じてログに書いたり書かなかったりできるように、条件による
  47     ログ収集も提供されています。</p>
  48
  49     <p>このモジュールは三つのディレクティブ提供します:
  50     ログファイルを作成するための <code class="directive"><a href="#transferlog">TransferLog</a></code>,
  51     新しい書式を 定義する <code class="directive"><a href="#logformat">LogFormat</a></code>,
  52     ログファイルと 書式を一度に定義する <code class="directive"><a href="#customlog">CustomLog</a></code> です。
  53     各リクエストが複数回ログ収集されるようにするために
  54     <code class="directive">TransferLog</code> ディレクティブと
  55     <code class="directive">CustomLog</code>
  56     ディレクティブは複数回使用することができます。</p>
  57 </div>
  58 <div id="quickview"><h3>トピック</h3>
  59 <ul id="topics">
  60 <li><img alt="" src="../images/down.gif" /> <a href="#formats">カスタムログ書式</a></li>
  61 <li><img alt="" src="../images/down.gif" /> <a href="#security">セキュリティに関して</a></li>
  62 </ul><h3 class="directives">ディレクティブ</h3>
  63 <ul id="toc">
  64 <li><img alt="" src="../images/down.gif" /> <a href="#bufferedlogs">BufferedLogs</a></li>
  65 <li><img alt="" src="../images/down.gif" /> <a href="#customlog">CustomLog</a></li>
  66 <li><img alt="" src="../images/down.gif" /> <a href="#logformat">LogFormat</a></li>
  67 <li><img alt="" src="../images/down.gif" /> <a href="#transferlog">TransferLog</a></li>
  68 </ul>
  69 <h3>参照</h3>
  70 <ul class="seealso">
  71 <li><a href="../logs.html">Apache ログファイル</a></li>
  72 </ul><ul class="seealso"><li><a href="#comments_section">コメント</a></li></ul></div>
  73 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  74 <div class="section">
  75 <h2><a name="formats" id="formats">カスタムログ書式</a></h2>
  76
  77     <p><code class="directive"><a href="#logformat">LogFormat</a></code> ディレクティブと
  78     <code class="directive"><a href="#customlog">CustomLog</a></code>
  79     ディレクティブの書式を指定する引数は文字列です。この文字列を使ってそれぞれの
  80     リクエストがログファイルにログ収集されます。その文字列には
  81     ログファイルにそのまま
  82     書かれる文字列や、それぞれ改行とタブを表す C 言語
  83     形式の制御文字 "\n" と "\t"
  84     とを含めることができます。そのまま出力させたい引用符とバックスラッシュは
  85     バックスラッシュでエスケープする必要があります。</p>
  86
  87     <p>リクエストの特徴そのものは "<code>%</code>"
  88     ディレクティブを書式の文字列に書くことで
  89     ログ収集されます。"%"
  90     ディレクティブはログファイル中では以下のような
  91     値で置換されます:</p>
  92
  93     <table class="bordered"><tr class="header"><th>フォーマット文字列</th>
  94         <th>説明</th></tr>
  95 <tr><td><code>%%</code></td>
  96         <td>パーセント記号</td></tr>
  97 <tr class="odd"><td><code>%a</code></td>
  98         <td>リモート IP アドレス</td></tr>
  99 <tr><td><code>%A</code></td>
 100         <td>ローカル IP アドレス</td></tr>
 101 <tr class="odd"><td><code>%B</code></td>
 102         <td>レスポンスのバイト数。HTTP ヘッダは除く。</td></tr>
 103 <tr><td><code>%b</code></td>
 104         <td>レスポンスのバイト数。HTTP ヘッダは除く。CLF 書式。
 105         <em>すなわち</em>、1 バイトも送られなかったときは 0 ではなく、
 106         '<code>-</code>' になる</td></tr>
 107 <tr class="odd"><td><code>%{<var>Foobar</var>}C</code></td>
 108         <td>サーバに送られたリクエスト中のクッキー <var>Foobar</var> の値</td></tr>
 109 <tr><td><code>%D</code></td>
 110         <td>リクエストを処理するのにかかった時間、マイクロ秒単位</td></tr>
 111 <tr class="odd"><td><code>%{<var>FOOBAR</var>}e</code></td>
 112         <td>環境変数 <var>FOOBAR</var> の内容</td></tr>
 113 <tr><td><code>%f</code></td>
 114         <td>ファイル名</td></tr>
 115 <tr class="odd"><td><code>%h</code></td>
 116         <td>リモートホスト</td></tr>
 117 <tr><td><code>%H</code></td>
 118         <td>リクエストプロトコル</td></tr>
 119 <tr class="odd"><td><code>%{<var>Foobar</var>}i</code></td>
 120         <td>サーバに送られたリクエストの <code><var>Foobar</var>:</code>
 121         ヘッダの内容</td></tr>
 122 <tr><td><code>%l</code></td>
 123         <td>(identd からもし提供されていれば) リモートログ名。
 124         これは <code class="module"><a href="../mod/mod_ident.html">mod_ident</a></code> がサーバに存在して、
 125         <code class="directive"><a href="../mod/mod_ident.html#identitycheck">IdentityCheck</a></code>
 126         ディレクティブが <code>On</code> に設定されていない限り、
 127         <code>-</code> になります。</td></tr>
 128 <tr class="odd"><td><code>%m</code></td>
 129         <td>リクエストメソッド</td></tr>
 130 <tr><td><code>%{<var>Foobar</var>}n</code></td>
 131         <td>他のモジュールからのメモ <var>Foobar</var> の内容</td></tr>
 132 <tr class="odd"><td><code>%{<var>Foobar</var>}o</code></td>
 133         <td>応答の <code><var>Foobar</var>:</code> ヘッダの内容</td></tr>
 134 <tr><td><code>%p</code></td>
 135         <td>リクエストを扱っているサーバの正式なポート</td></tr>
 136 <tr class="odd"><td><code>%{<var>format</var>}p</code></td>
 137         <td>サーバがリクエストを処理しているポートの公式
 138         <span class="transnote">(<em>訳注:</em> canonical)</span> のポート番号か、
 139         サーバの実際のポート番号か、クライアント側の実際のポート番号かです。
 140         format に使える文字列は <code>canonical</code>, <code>local</code>,
 141         <code>remote</code> になります。
 142         </td></tr>
 143 <tr><td><code>%P</code></td>
 144         <td>リクエストを扱った子プロセスのプロセス ID</td></tr>
 145 <tr class="odd"><td><code>%{<var>format</var>}P</code></td>
 146         <td>リクエストを扱ったワーカーのプロセス ID かスレッド ID。
 147         <var>format</var> として有効な値は <code>pid</code>, <code>tid</code>,
 148         <code>hextid</code> です。<code>hextid</code> を使うには
 149         APR 1.2.0 以降が必要です。
 150         </td></tr>
 151 <tr><td><code>%q</code></td>
 152         <td>問い合せ文字列 (存在する場合は前に <code>?</code> が追加される。
 153         そうでない場合は空文字列)</td></tr>
 154 <tr class="odd"><td><code>%r</code></td>
 155         <td>リクエストの最初の行</td></tr>
 156 <tr><td><code>%s</code></td>
 157         <td>ステータス。内部でリダイレクトされたリクエストは、元々の
 158          リクエストのステータス --- 最後のステータスは <code>%&gt;s</code>
 159     </td></tr>
 160 <tr class="odd"><td><code>%t</code></td>
 161         <td>リクエストを受付けた時刻。
 162         CLF の時刻の書式 (標準の英語の書式)</td></tr>
 163 <tr><td><code>%{<var>format</var>}t</code></td>
 164         <td><var>format</var> で与えられた書式による時刻。format は
 165          <code>strftime (3)</code> の
 166          書式である必要がある。(地域化されている可能性がある)</td></tr>
 167 <tr class="odd"><td><code>%T</code></td>
 168         <td>リクエストを扱うのにかかった時間、秒単位</td></tr>
 169 <tr><td><code>%u</code></td>
 170         <td>リモートユーザ (認証によるもの。ステータス (<code>%s</code>) が
 171         401 のときは意味がないものである可能性がある)
 172     </td></tr>
 173 <tr class="odd"><td><code>%U</code></td>
 174         <td>リクエストされた URL パス。クエリ文字列は含まない</td></tr>
 175 <tr><td><code>%v</code></td>
 176         <td>リクエストを扱っているサーバの正式な <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code></td></tr>
 177 <tr class="odd"><td><code>%V</code></td>
 178         <td><code class="directive"><a href="../mod/core.html#usecanonicalname">UseCanonicalName</a></code> の設定によるサーバ名</td></tr>
 179 <tr><td><code>%X</code></td>
 180         <td>応答が完了したときの接続ステータス:
 181
 182         <table>
 183
 184         <tr><td><code>X</code> =</td>
 185             <td>応答が完了する前に接続が異常終了</td></tr>
 186         <tr><td><code>+</code> =</td>
 187             <td>応答が送られた後に接続を持続することが可能</td></tr>
 188         <tr><td><code>-</code> = </td>
 189             <td>応答が送られた後に接続が切られる</td></tr>
 190         </table>
 191
 192         <p>(このディレクティブは Apache
 193         1.3 の後期のバージョンでは <code>%c</code> に割り当てられて
 194         いましたが、これは歴史的に ssl が使用している
 195         <code>%{<var>var</var>}c</code>
 196         構文と衝突していました。)</p></td></tr>
 197 <tr class="odd"><td><code>%I</code></td>
 198         <td>リクエストとヘッダを含む、受け取ったバイト数。
 199         0 にはならない。
 200         これを使用するためには <code class="module"><a href="../mod/mod_logio.html">mod_logio</a></code> が必要</td></tr>
 201 <tr><td><code>%O</code></td>
 202         <td>ヘッダを含む、送信したバイト数。0 にはならない。
 203         これを使用するためには <code class="module"><a href="../mod/mod_logio.html">mod_logio</a></code> が必要</td></tr>
 204 </table>
 205
 206     <h3><a name="modifiers" id="modifiers">修飾子</a></h3>
 207
 208       <p>特定の要素は "%" の直後に HTTP ステータスコードをカンマ区切りで
 209       指定することで、表示を制限することができます。例えば
 210       <code>"%400,501{User-agent}i"</code> では、
 211       400 と 500 番エラーでのみ <code>User-agent</code> をログします。
 212       他のステータスコードでは <code>"-"</code> という文字列が
 213       ログされます。ステータスコードのリストは "<code>!</code>"
 214       で否定を指定することができます :
 215       <code>"%!200,304,302{Referer}i"</code> は、指定された
 216       3 つのコードの<em>どれにも該当しない</em>リクエスト全てで
 217       <code>Referer</code> をログします。</p>
 218
 219       <p>修飾子 "&lt;" と "&gt;" は内部リダイレクトされたリクエストのログに
 220       元のリクエストか最終的なリクエストのどちらを使用するかを
 221       指定するために使います。デフォルトでは、<code>%</code> ディレクティブの
 222       <code>%s, %U, %T, %D, %r</code> は元のリクエストを、他は最終的なリクエストを
 223       使用します。例えば、リクエストの最終ステータスを記録するには
 224       <code>%&gt;s</code> を、内部的に認証されていないリソースへリダイレクトされた
 225       リクエストで元のリクエストで認証されたユーザを記録するためには
 226       <code>%&lt;u</code> を使うことができます。</p>
 227
 228
 229
 230     <h3><a name="format-notes" id="format-notes">その他注意点</a></h3>
 231
 232       <p>セキュリティ上の理由により 2.0.46 より、
 233       <code>%r</code>, <code>%i</code>, <code>%o</code> に入っている、
 234       印字不可能な文字と他の特別な文字は、<code>\x<var>hh</var></code>
 235       という形式の文字列でエスケープされるようになりました。<var>hh</var> は
 236       そのままのバイトの値の 16 進での値です。この規則の例外には、
 237       バックスラッシュを使ってエスケープされる <code>"</code> と <code>\</code> と、
 238       C 形式の表記法が使われる空白文字 (<code>\n</code>, <code>\t</code> など)
 239       があります。2.0.46 以前のバージョンではエスケープ処理は行われませんので、
 240       生ログファイルを扱う際に注意が必要です。</p>
 241
 242       <p>httpd 2.0 では 1.3 とは異なり、<code>%b</code> と <code>%B</code>
 243       フォーマット文字列はクライアントに送信されたバイト数そのものではなく、
 244       HTTP レスポンスのバイト数です (これらは異なるもので、たとえば、
 245       コネクションが途中で破棄された場合や、SSL 使用時に一致しません) 。
 246       <code class="module"><a href="../mod/mod_logio.html">mod_logio</a></code> で提供されている <code>%O</code>
 247       フォーマット文字列で、ネットワーク経由で実際に転送されたバイト数を
 248       記録できます。</p>
 249
 250
 251
 252     <h3><a name="examples" id="examples">例</a></h3>
 253
 254       <p>よく使われるフォーマット文字列は:</p>
 255
 256       <dl>
 257         <dt>Common Log Format (CLF)</dt>
 258         <dd><code>"%h %l %u %t \"%r\" %&gt;s %b"</code></dd>
 259
 260         <dt>バーチャルホスト付き Common Log Format</dt>
 261         <dd><code>"%v %h %l %u %t \"%r\" %&gt;s %b"</code></dd>
 262
 263         <dt>NCSA extended/combined ログ書式</dt>
 264         <dd><code>"%h %l %u %t \"%r\" %&gt;s %b \"%{Referer}i\"
 265         \"%{User-agent}i\""</code></dd>
 266
 267         <dt>Referer ログ書式</dt>
 268         <dd><code>"%{Referer}i -&gt; %U"</code></dd>
 269
 270         <dt>Agent (ブラウザ) ログ書式</dt>
 271         <dd><code>"%{User-agent}i"</code></dd>
 272       </dl>
 273
 274 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 275 <div class="section">
 276 <h2><a name="security" id="security">セキュリティに関して</a></h2>
 277     <p>ログファイルが保存されているディレクトリがサーバを起動した以外のユーザで
 278     書き込み可能なときにセキュリティの問題が発生する理由の詳細は<a href="../misc/security_tips.html#serverroot">セキュリティのこつ</a>
 279     を参照してください。</p>
 280 </div>
 281 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 282 <div class="directive-section"><h2><a name="BufferedLogs" id="BufferedLogs">BufferedLogs</a> <a name="bufferedlogs" id="bufferedlogs">ディレクティブ</a></h2>
 283 <table class="directive">
 284 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>ディスクに書き出す前にメモリにログエントリをバッファする</td></tr>
 285 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>BufferedLogs On|Off</code></td></tr>
 286 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>BufferedLogs Off</code></td></tr>
 287 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル</td></tr>
 288 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Base</td></tr>
 289 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_log_config</td></tr>
 290 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>2.0.41 以降</td></tr>
 291 </table>
 292     <p><code class="directive">BufferedLogs</code> ディレクティブを使うと
 293     <code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code> の挙動が変化して、
 294     複数のログを書き出す際に、それぞれのリクエスト処理後毎に
 295     書き出すのではなく、いったんメモリに蓄えてから、
 296     まとめてディスクに書き出すようになります。
 297     この結果ディスクアクセスがより効率的になり、
 298     高いパフォーマンスの得られるシステムもあるでしょう。
 299     このディレクティブはサーバ全体で一度だけ設定できます;
 300     バーチャルホストごとに設定することはできません。</p>
 301
 302     <div class="note">このディレクティブは実験的なものですので、
 303     使用する際は注意してください。</div>
 304
 305 </div>
 306 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 307 <div class="directive-section"><h2><a name="CustomLog" id="CustomLog">CustomLog</a> <a name="customlog" id="customlog">ディレクティブ</a></h2>
 308 <table class="directive">
 309 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>ログファイルの名前と書式を設定する</td></tr>
 310 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>CustomLog  <var>file</var>|<var>pipe</var>
 311 <var>format</var>|<var>nickname</var>
 312 [env=[!]<var>environment-variable</var>]</code></td></tr>
 313 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
 314 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Base</td></tr>
 315 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_log_config</td></tr>
 316 </table>
 317     <p><code class="directive">CustomLog</code> ディレクティブはサーバへのリクエストを
 318     ログ収集するために使われます。ログの書式が指定され、
 319     環境変数を使ってロギングが条件に応じて行なわれるようにすることもできます。</p>
 320
 321     <p>ログが書かれる場所を指定する最初の引数は以下の二つの形式の値を
 322     とることができます:</p>
 323
 324     <dl>
 325       <dt><var>file</var></dt>
 326       <dd><code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>
 327       からの相対パスで表されるファイル名。</dd>
 328
 329       <dt><var>pipe</var></dt>
 330       <dd>パイプ文字 "<code>|</code>" と、その後に標準入力からログの
 331       情報を受けとるプログラムへのパスが続いたもの。
 332
 333       <div class="warning"><h3>セキュリティ</h3>
 334       <p>もしプログラムが使用された場合、
 335       <code class="program"><a href="../programs/httpd.html">httpd</a></code> が起動されたユーザとして実行されます。これはサーバが
 336       root によって起動された場合は root になります。プログラムが
 337       安全であるように留意してください。</p>
 338       </div>
 339       <div class="warning"><h3>注</h3>
 340         <p>Unix でないプラットフォームでファイルのパスを入力しているときは、
 341         使用しているプラットフォームがバックスラッシュの使用を許可していた
 342         として、通常のスラッシュだけを使うように気をつけてください。
 343         一般的に、設定ファイル中では常に普通のスラッシュのみを使うようにする
 344         方が良いです。</p>
 345       </div></dd>
 346     </dl>
 347
 348     <p>二つめの引数はログファイルに何が書かれるかを指定します。
 349     前にある <code class="directive"><a href="#logformat">LogFormat</a></code> ディレクティブにより
 350     定義された <var>nickname</var> か、<a href="#formats">ログの書式</a>
 351     のところで説明されている、明示的な <var>format</var> 文字列の
 352     どちらかを指定することができます。</p>
 353
 354     <p>例えば、以下の二つのディレクティブ群は全く同じ効果をもたらします:</p>
 355
 356     <div class="example"><p><code>
 357       # CustomLog with format nickname<br />
 358       LogFormat "%h %l %u %t \"%r\" %&gt;s %b" common<br />
 359       CustomLog logs/access_log common<br />
 360       <br />
 361       # CustomLog with explicit format string<br />
 362       CustomLog logs/access_log "%h %l %u %t \"%r\" %&gt;s %b"
 363     </code></p></div>
 364
 365     <p>三つ目の引数は省略可能で、サーバの環境にある変数があるかないかに
 366     応じてリクエストをログ収集するかどうかを制御するために使うことができます。
 367     指定された<a href="../env.html">環境変数</a>がリクエストに対して
 368     設定されていた場合 ('<code>env=!<var>name</var></code>' 文が使われたときは
 369     設定されていない場合)、リクエストがログ収集されます。</p>
 370
 371     <p>環境変数は <code class="module"><a href="../mod/mod_setenvif.html">mod_setenvif</a></code> モジュールと
 372     <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> モジュールの両方もしくは
 373     片方を用いてリクエストごとに設定することができます。
 374     例えば、サーバにあるすべての GIF 画像へのリクエストを別のログファイル
 375     には記録したいけれど、メインログには記録したくない、というときは
 376     以下のものを使うことができます:</p>
 377
 378     <div class="example"><p><code>
 379       SetEnvIf Request_URI \.gif$ gif-image<br />
 380       CustomLog gif-requests.log common env=gif-image<br />
 381       CustomLog nongif-requests.log common env=!gif-image
 382     </code></p></div>
 383
 384     <p>古い RefererIgnore ディレクティブと同じ挙動をさせたい場合は、
 385     次のようにします:</p>
 386
 387     <div class="example"><p><code>
 388     SetEnvIf Referer example\.com localreferer<br />
 389     CustomLog referer.log referer env=!localreferer
 390     </code></p></div>
 391
 392 </div>
 393 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 394 <div class="directive-section"><h2><a name="LogFormat" id="LogFormat">LogFormat</a> <a name="logformat" id="logformat">ディレクティブ</a></h2>
 395 <table class="directive">
 396 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>ログファイルで使用する書式を設定する</td></tr>
 397 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>LogFormat <var>format</var>|<var>nickname</var>
 398 [<var>nickname</var>]</code></td></tr>
 399 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>LogFormat "%h %l %u %t \"%r\" %&gt;s %b"</code></td></tr>
 400 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
 401 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Base</td></tr>
 402 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_log_config</td></tr>
 403 </table>
 404     <p>このディレクティブはアクセスログファイルの書式を指定します。</p>
 405
 406     <p><code class="directive">LogFormat</code> ディレクティブは二つの形式のどちらかを
 407     とることができます。最初の形式では一つの引数のみが指定され、
 408     続く <code class="directive">TransferLog</code>
 409     で指定されたログで使われるログの書式を設定します。この単独の引数では
 410     上の<a href="#formats">カスタムログ書式</a>で説明されているように
 411     <var>format</var> を明示的に指定することができます。
 412     もしくは、下で説明されているように前に <code class="directive">LogFormat</code>
 413     ディレクティブで定義されたログの書式を <var>nickname</var>を使って
 414     参照することもできます。</p>
 415
 416     <p><code class="directive">LogFormat</code> ディレクティブの二つめの形式は
 417     <var>format</var> に <var>nickname</var> を与えます。
 418     フォーマット文字列全体を再び書くかわりに、
 419     この <var>nickname</var> を続きの <code class="directive">LogFormat</code> ディレクティブや
 420     <code class="directive">CustomLog</code> ディレクティブで使うことができます。
 421     Nickname を定義する <code class="directive">LogFormat</code> ディレクティブは
 422     <strong>他には何もしません</strong> -- すなわち、ニックネームを定義
 423     する<em>だけ</em>で、実際に書式を適用してデフォルトにするということは行ないません。
 424     ですから、これは続く <code class="directive"><a href="#transferlog">TransferLog</a></code>
 425     ディレクティブには影響を与えません。
 426     さらに、<code class="directive">LogFormat</code> ディレクティブは既存の nickname を
 427     使って別の nickname を定義することはできません。Nickname には
 428     パーセント記号 (<code>%</code>) が含まれていてはいけないことにも注意
 429     してください。</p>
 430
 431     <div class="example"><h3>例</h3><p><code>
 432       LogFormat "%v %h %l %u %t \"%r\" %&gt;s %b" vhost_common
 433     </code></p></div>
 434
 435 </div>
 436 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 437 <div class="directive-section"><h2><a name="TransferLog" id="TransferLog">TransferLog</a> <a name="transferlog" id="transferlog">ディレクティブ</a></h2>
 438 <table class="directive">
 439 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>ログファイルの位置を指定</td></tr>
 440 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>TransferLog <var>file</var>|<var>pipe</var></code></td></tr>
 441 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
 442 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Base</td></tr>
 443 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_log_config</td></tr>
 444 </table>
 445     <p>このディレクティブは、ログ書式を直接指定できないことと、
 446     条件付きロギングが無いことを除くと、<code class="directive"><a href="#customlog">CustomLog</a></code> と全く同じ引数と効果があります。
 447     直接ログ書式を指定する代わりに、ログの書式はそこまでで一番最後に指定された
 448     ニックネームを定義しない
 449     <code class="directive"><a href="#logformat">LogFormat</a></code> ディレクティブ
 450         で定義されたものを使います。
 451     もし他の書式が全く指定されていないときは Common Log Format
 452     が使われます。</p>
 453
 454     <div class="example"><h3>例</h3><p><code>
 455       LogFormat "%h %l %u %t \"%r\" %&gt;s %b \"%{Referer}i\" \"%{User-agent}i\""<br />
 456       TransferLog logs/access_log
 457     </code></p></div>
 458
 459 </div>
 460 </div>
 461 <div class="bottomlang">
 462 <p><span>翻訳済み言語: </span><a href="../en/mod/mod_log_config.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 463 <a href="../ja/mod/mod_log_config.html" title="Japanese">&nbsp;ja&nbsp;</a> |
 464 <a href="../ko/mod/mod_log_config.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
 465 <a href="../tr/mod/mod_log_config.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
 466 </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&amp;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>
 467 <script type="text/javascript"><!--//--><![CDATA[//><!--
 468 var comments_shortname = 'httpd';
 469 var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_log_config.html';
 470 (function(w, d) {
 471     if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
 472         d.write('<div id="comments_thread"><\/div>');
 473         var s = d.createElement('script');
 474         s.type = 'text/javascript';
 475         s.async = true;
 476         s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
 477         (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
 478     }
 479     else {
 480         d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
 481     }
 482 })(window, document);
 483 //--><!]]></script></div><div id="footer">
 484 <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>
 485 <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[//><!--
 486 if (typeof(prettyPrint) !== 'undefined') {
 487     prettyPrint();
 488 }
 489 //--><!]]></script>
 490 </body></html>