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