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" />
6 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
7 This file is generated from xml source: DO NOT EDIT
8 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
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">
17 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
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="<-" alt="<-" src="../images/left.gif" /></a></div>
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.5</a> > <a href="./">モジュール</a></div>
26 <div id="page-content">
27 <div id="preamble"><h1>Apache モジュール mod_log_config</h1>
29 <p><span>翻訳済み言語: </span><a href="../en/mod/mod_log_config.html" hreflang="en" rel="alternate" title="English"> en </a> |
30 <a href="../fr/mod/mod_log_config.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
31 <a href="../ja/mod/mod_log_config.html" title="Japanese"> ja </a> |
32 <a href="../ko/mod/mod_log_config.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
33 <a href="../tr/mod/mod_log_config.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
35 <div class="outofdate">この日本語訳はすでに古くなっている
37 最近更新された内容を見るには英語版をご覧下さい。
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>
46 このモジュールはクライアントのリクエストを柔軟にログ収集する機能を
47 提供します。ログはカスタマイズ可能な書式で書かれ、ファイルに直接
48 書いたり、外部プログラムに渡したりすることができます。個々のリクエストを
49 特徴に応じてログに書いたり書かなかったりできるように、条件による
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>
61 <div id="quickview"><h3>トピック</h3>
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>
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>
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__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_log_config">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_log_config">Report a bug</a></li></ul><h3>参照</h3>
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>
79 <h2><a name="formats" id="formats">カスタムログ書式</a> <a title="Permanent link" href="#formats" class="permalink">¶</a></h2>
81 <p><code class="directive"><a href="#logformat">LogFormat</a></code> ディレクティブと
82 <code class="directive"><a href="#customlog">CustomLog</a></code>
83 ディレクティブの書式を指定する引数は文字列です。この文字列を使ってそれぞれの
84 リクエストがログファイルにログ収集されます。その文字列には
86 書かれる文字列や、それぞれ改行とタブを表す C 言語
88 とを含めることができます。そのまま出力させたい引用符とバックスラッシュは
89 バックスラッシュでエスケープする必要があります。</p>
91 <p>リクエストの特徴そのものは "<code>%</code>"
94 ディレクティブはログファイル中では以下のような
97 <table class="bordered"><tr class="header"><th>フォーマット文字列</th>
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>
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>
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> になります。
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> を使うには
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>%>s</code>
164 <tr class="odd"><td><code>%t</code></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 のときは意味がないものである可能性がある)
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>応答が完了したときの接続ステータス:
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>
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>リクエストとヘッダを含む、受け取ったバイト数。
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>
210 <h3><a name="modifiers" id="modifiers">修飾子</a></h3>
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>"
219 <code>"%!200,304,302{Referer}i"</code> は、指定された
220 3 つのコードの<em>どれにも該当しない</em>リクエスト全てで
221 <code>Referer</code> をログします。</p>
223 <p>修飾子 "<" と ">" は内部リダイレクトされたリクエストのログに
224 元のリクエストか最終的なリクエストのどちらを使用するかを
225 指定するために使います。デフォルトでは、<code>%</code> ディレクティブの
226 <code>%s, %U, %T, %D, %r</code> は元のリクエストを、他は最終的なリクエストを
227 使用します。例えば、リクエストの最終ステータスを記録するには
228 <code>%>s</code> を、内部的に認証されていないリソースへリダイレクトされた
229 リクエストで元のリクエストで認証されたユーザを記録するためには
230 <code>%<u</code> を使うことができます。</p>
234 <h3><a name="format-notes" id="format-notes">その他注意点</a></h3>
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>
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 フォーマット文字列で、ネットワーク経由で実際に転送されたバイト数を
256 <h3><a name="examples" id="examples">例</a></h3>
258 <p>よく使われるフォーマット文字列は:</p>
261 <dt>Common Log Format (CLF)</dt>
262 <dd><code>"%h %l %u %t \"%r\" %>s %b"</code></dd>
264 <dt>バーチャルホスト付き Common Log Format</dt>
265 <dd><code>"%v %h %l %u %t \"%r\" %>s %b"</code></dd>
267 <dt>NCSA extended/combined ログ書式</dt>
268 <dd><code>"%h %l %u %t \"%r\" %>s %b \"%{Referer}i\"
269 \"%{User-agent}i\""</code></dd>
271 <dt>Referer ログ書式</dt>
272 <dd><code>"%{Referer}i -> %U"</code></dd>
274 <dt>Agent (ブラウザ) ログ書式</dt>
275 <dd><code>"%{User-agent}i"</code></dd>
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">¶</a></h2>
281 <p>ログファイルが保存されているディレクトリがサーバを起動した以外のユーザで
282 書き込み可能なときにセキュリティの問題が発生する理由の詳細は<a href="../misc/security_tips.html#serverroot">セキュリティのこつ</a>
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">¶</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>
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>
306 <div class="note">このディレクティブは実験的なものですので、
307 使用する際は注意してください。</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">¶</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>
321 <p><code class="directive">CustomLog</code> ディレクティブはサーバへのリクエストを
322 ログ収集するために使われます。ログの書式が指定され、
323 環境変数を使ってロギングが条件に応じて行なわれるようにすることもできます。</p>
325 <p>ログが書かれる場所を指定する最初の引数は以下の二つの形式の値を
329 <dt><var>file</var></dt>
330 <dd><code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>
331 からの相対パスで表されるファイル名。</dd>
333 <dt><var>pipe</var></dt>
334 <dd>パイプ文字 "<code>|</code>" と、その後に標準入力からログの
335 情報を受けとるプログラムへのパスが続いたもの。
337 <div class="warning"><h3>セキュリティ</h3>
339 <code class="program"><a href="../programs/httpd.html">httpd</a></code> が起動されたユーザとして実行されます。これはサーバが
340 root によって起動された場合は root になります。プログラムが
341 安全であるように留意してください。</p>
343 <div class="warning"><h3>注</h3>
344 <p>Unix でないプラットフォームでファイルのパスを入力しているときは、
345 使用しているプラットフォームがバックスラッシュの使用を許可していた
346 として、通常のスラッシュだけを使うように気をつけてください。
347 一般的に、設定ファイル中では常に普通のスラッシュのみを使うようにする
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>
358 <p>例えば、以下の二つのディレクティブ群は全く同じ効果をもたらします:</p>
360 <div class="example"><p><code>
361 # CustomLog with format nickname<br />
362 LogFormat "%h %l %u %t \"%r\" %>s %b" common<br />
363 CustomLog logs/access_log common<br />
365 # CustomLog with explicit format string<br />
366 CustomLog logs/access_log "%h %l %u %t \"%r\" %>s %b"
369 <p>三つ目の引数は省略可能で、サーバの環境にある変数があるかないかに
370 応じてリクエストをログ収集するかどうかを制御するために使うことができます。
371 指定された<a href="../env.html">環境変数</a>がリクエストに対して
372 設定されていた場合 ('<code>env=!<var>name</var></code>' 文が使われたときは
373 設定されていない場合)、リクエストがログ収集されます。</p>
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 には記録したいけれど、メインログには記録したくない、というときは
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
388 <p>古い RefererIgnore ディレクティブと同じ挙動をさせたい場合は、
391 <div class="example"><p><code>
392 SetEnvIf Referer example\.com localreferer<br />
393 CustomLog referer.log referer env=!localreferer
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">¶</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 まだ翻訳されていません。英語版をご覧ください。
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">¶</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\" %>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>
423 <p>このディレクティブはアクセスログファイルの書式を指定します。</p>
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>を使って
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>
445 さらに、<code class="directive">LogFormat</code> ディレクティブは既存の nickname を
446 使って別の nickname を定義することはできません。Nickname には
447 パーセント記号 (<code>%</code>) が含まれていてはいけないことにも注意
450 <div class="example"><h3>例</h3><p><code>
451 LogFormat "%v %h %l %u %t \"%r\" %>s %b" vhost_common
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">¶</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>
464 <p>このディレクティブは、ログ書式を直接指定できないことと、
465 条件付きロギングが無いことを除くと、<code class="directive"><a href="#customlog">CustomLog</a></code> と全く同じ引数と効果があります。
466 直接ログ書式を指定する代わりに、ログの書式はそこまでで一番最後に指定された
468 <code class="directive"><a href="#logformat">LogFormat</a></code> ディレクティブ
470 もし他の書式が全く指定されていないときは Common Log Format
473 <div class="example"><h3>例</h3><p><code>
474 LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\""<br />
475 TransferLog logs/access_log
480 <div class="bottomlang">
481 <p><span>翻訳済み言語: </span><a href="../en/mod/mod_log_config.html" hreflang="en" rel="alternate" title="English"> en </a> |
482 <a href="../fr/mod/mod_log_config.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
483 <a href="../ja/mod/mod_log_config.html" title="Japanese"> ja </a> |
484 <a href="../ko/mod/mod_log_config.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
485 <a href="../tr/mod/mod_log_config.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </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&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';
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';
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);
500 d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
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') {