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