granicus.if.org Git - apache/blob - docs/manual/mod/mod_log_config.xml.ko

   1 <?xml version="1.0" encoding="EUC-KR" ?>
   2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
   3 <?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?>
   4 <!-- English Revision: 105989:1611357 (outdated) -->
   5
   6 <!--
   7  Licensed to the Apache Software Foundation (ASF) under one or more
   8  contributor license agreements.  See the NOTICE file distributed with
   9  this work for additional information regarding copyright ownership.
  10  The ASF licenses this file to You under the Apache License, Version 2.0
  11  (the "License"); you may not use this file except in compliance with
  12  the License.  You may obtain a copy of the License at
  13
  14      http://www.apache.org/licenses/LICENSE-2.0
  15
  16  Unless required by applicable law or agreed to in writing, software
  17  distributed under the License is distributed on an "AS IS" BASIS,
  18  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  19  See the License for the specific language governing permissions and
  20  limitations under the License.
  21 -->
  22
  23 <modulesynopsis metafile="mod_log_config.xml.meta">
  24
  25 <name>mod_log_config</name>
  26 <description>¼¹ö·ÎÀÇ ¿äÃ»À» ·Î±×¿¡ ±â·ÏÇÑ´Ù</description>
  27 <status>Base</status>
  28 <sourcefile>mod_log_config.c</sourcefile>
  29 <identifier>log_config_module</identifier>
  30
  31 <summary>
  32     <p>ÀÌ ¸ðµâÀº Å¬¶óÀÌ¾ðÆ®ÀÇ ¿äÃ»À» ·Î±×¿¡ ÀÚÀ¯·Ó°Ô ±â·ÏÇÑ´Ù.
  33     ÀÚ½ÅÀÌ ¿øÇÏ´Â Çü½ÄÀ¸·Î ·Î±×¸¦ ±â·ÏÇÒ ¼ö ÀÖ°í, ÆÄÀÏÀÌ³ª ¿ÜºÎ
  34     ÇÁ·Î±×·¥¿¡ Á÷Á¢ ·Î±×¸¦ º¸³¾ ¼öµµ ÀÖ´Ù. Á¶°ÇÀû ·Î±×¸¦ »ç¿ëÇÏ¸é
  35     ¿äÃ»ÀÇ ¼º°Ý¿¡ µû¶ó ¿äÃ»À» ·Î±×¿¡ Ãß°¡ÇÏ°Å³ª Á¦¿ÜÇÒ ¼ö ÀÖ´Ù.</p>
  36
  37     <p>ÀÌ ¸ðµâÀº ¼¼°¡Áö Áö½Ã¾î¸¦ Á¦°øÇÑ´Ù. <directive
  38     module="mod_log_config">TransferLog</directive>´Â ·Î±×ÆÄÀÏÀ»
  39     ¸¸µé°í, <directive module="mod_log_config">LogFormat</directive>Àº
  40     ¿øÇÏ´Â Çü½ÄÀ» Á¤ÇÏ°í, <directive
  41     module="mod_log_config">CustomLog</directive>´Â ÇÑ¹ø¿¡ ·Î±×ÆÄÀÏ°ú
  42     Çü½ÄÀ» ¸ðµÎ ÁöÁ¤ÇÑ´Ù. <directive>TransferLog</directive>¿Í
  43     <directive>CustomLog</directive> Áö½Ã¾î¸¦ ¿©·¯¹ø »ç¿ëÇÏ¸é
  44     ¿äÃ»À» ¿©·¯ ÆÄÀÏ¿¡ ±â·ÏÇÒ ¼ö ÀÖ´Ù.</p>
  45 </summary>
  46 <seealso><a href="../logs.html">¾ÆÆÄÄ¡ ·Î±×ÆÄÀÏ</a></seealso>
  47
  48 <section id="formats"><title>·Î±× Çü½Ä ÁöÁ¤ÇÏ±â</title>
  49
  50     <p><directive module="mod_log_config">LogFormat</directive>°ú
  51     <directive module="mod_log_config">CustomLog</directive>
  52     Áö½Ã¾îÀÇ Çü½Ä ¾Æ±Ô¸ÕÆ®´Â ¹®ÀÚ¿ÀÌ´Ù. ÀÌ ¹®ÀÚ¿¿¡ µû¶ó ¿äÃ»À»
  53     ·Î±×ÆÄÀÏ¿¡ ±â·ÏÇÑ´Ù. ¹®ÀÚ¿¿¡´Â ·Î±×ÆÄÀÏ¿¡ ±×´ë·Î º¹»çµÇ´Â
  54     ¹®ÀÚ¿Í Çà¹Ù²Þ°ú ÅÇÀ» ³ªÅ¸³»´Â CÀÇ "\n"°ú "\t" Á¦¾î¹®ÀÚ¸¦
  55     »ç¿ëÇÒ ¼ö ÀÖ´Ù. ·Î±×ÆÄÀÏ¿¡ µû¿ÈÇ¥³ª ¹é½½·¡½¬¸¦ ¾²·Á¸é ¾Õ¿¡
  56     ¹Ýµå½Ã ¹é½½·¡½¬¸¦ Àû¾îÁà¾ß ÇÑ´Ù.</p>
  57
  58     <p>¿äÃ»ÀÇ Æ¯Â¡Àº Çü½Ä ¹®ÀÚ¿¿¡ "<code>%</code>" Áö½Ã¾î¸¦
  59     »ç¿ëÇÏ¿© ±â·ÏÇÑ´Ù. ÀÌ Áö½Ã¾î´Â ·Î±×ÆÄÀÏ¿¡¼ ´ÙÀ½°ú °°ÀÌ
  60     º¯°æµÈ´Ù.</p>
  61
  62     <table border="1" style="zebra">
  63     <columnspec><column width=".2"/><column width=".8"/></columnspec>
  64     <tr><th>Çü½Ä&nbsp;¹®ÀÚ¿</th>
  65         <th>¼³¸í</th></tr>
  66
  67     <tr><td><code>%%</code></td>
  68         <td>ÆÛ¼¾Æ® ±âÈ£</td></tr>
  69
  70     <tr><td><code>%...a</code></td>
  71         <td>¿ø°Ý IP-ÁÖ¼Ò</td></tr>
  72
  73     <tr><td><code>%...A</code></td>
  74         <td>(¼¹ö) IP-ÁÖ¼Ò</td></tr>
  75
  76     <tr><td><code>%...B</code></td>
  77         <td>HTTP Çì´õ¸¦ Á¦¿ÜÇÑ Àü¼Û ¹ÙÀÌÆ®¼ö.</td></tr>
  78
  79     <tr><td><code>%...b</code></td>
  80         <td>HTTP Çì´õ¸¦ Á¦¿ÜÇÑ Àü¼Û ¹ÙÀÌÆ®¼ö. CLF Çü½Ä°ú °°ÀÌ
  81         Àü¼ÛÇÑ ³»¿ëÀÌ ¾ø´Â °æ¿ì 0 ´ë½Å '<code>-</code>'°¡ ³ª¿Â´Ù.</td></tr>
  82
  83     <tr><td><code>%...{<var>Foobar</var>}C</code></td>
  84         <td>¼¹ö°¡ ¼ö½ÅÇÑ ¿äÃ»¿¡¼ <var>Foobar</var> ÄíÅ°ÀÇ
  85         ³»¿ë.</td></tr>
  86
  87     <tr><td><code>%...D</code></td>
  88         <td>¿äÃ»À» Ã³¸®ÇÏ´Âµ¥ °É¸° ½Ã°£ (¸¶ÀÌÅ©·ÎÃÊ ´ÜÀ§).</td></tr>
  89
  90     <tr><td><code>%...{<var>FOOBAR</var>}e</code></td>
  91         <td>È¯°æº¯¼ö <var>FOOBAR</var>ÀÇ ³»¿ë</td></tr>
  92
  93     <tr><td><code>%...f</code></td>
  94         <td>ÆÄÀÏ¸í</td></tr>
  95
  96     <tr><td><code>%...h</code></td>
  97         <td>¿ø°Ý È£½ºÆ®</td></tr>
  98
  99     <tr><td><code>%...H</code></td>
 100         <td>¿äÃ» ÇÁ·ÎÅäÄÝ</td></tr>
 101
 102     <tr><td><code>%...{<var>Foobar</var>}i</code></td>
 103         <td>¼¹ö°¡ ¼ö½ÅÇÑ ¿äÃ»¿¡¼ <code><var>Foobar</var>:</code>
 104         Çì´õÀÇ ³»¿ë.</td></tr>
 105
 106     <tr><td><code>%...l</code></td>
 107         <td>(ÀÖ´Ù¸é identd°¡ Á¦°øÇÑ) ¿ø°Ý ·Î±×ÀÎ¸í.
 108         <module>mod_ident</module>°¡ ÀÖ°í <directive
 109         module="mod_ident">IdentityCheck</directive>°¡
 110         <code>On</code>ÀÌ ¾Æ´Ï¸é »©±â±âÈ£¸¦ ±â·ÏÇÑ´Ù.</td></tr>
 111
 112     <tr><td><code>%...m</code></td>
 113         <td>¿äÃ» ¸Þ½áµå</td></tr>
 114
 115     <tr><td><code>%...{<var>Foobar</var>}n</code></td>
 116         <td>´Ù¸¥ ¸ðµâÀÌ ±â·ÏÇÑ <var>Foobar</var> ³ëÆ®(note)
 117         ³»¿ë.</td></tr>
 118
 119     <tr><td><code>%...{<var>Foobar</var>}o</code></td>
 120         <td>ÀÀ´äÀÇ <code><var>Foobar</var>:</code> Çì´õ ³»¿ë.</td></tr>
 121
 122     <tr><td><code>%...p</code></td>
 123         <td>¿äÃ»À» ¼ºñ½ºÇÏ´Â ¼¹öÀÇ Á¤±Ô Æ÷Æ®</td></tr>
 124
 125     <tr><td><code>%...P</code></td>
 126         <td>¿äÃ»À» ¼ºñ½ºÇÏ´Â ÀÚ½ÄÀÇ ÇÁ·Î¼¼½º ID.</td></tr>
 127
 128     <tr><td><code>%...{<var>format</var>}P</code></td>
 129         <td>¿äÃ»À» ¼ºñ½ºÇÏ´Â ÀÚ½ÄÀÇ ÇÁ·Î¼¼½º ID È¤Àº ¾²·¹µå
 130         ID. format¿¡´Â <code>pid</code>¿Í <code>tid</code>°¡
 131         °¡´ÉÇÏ´Ù.
 132         </td></tr>
 133
 134     <tr><td><code>%...q</code></td>
 135         <td>ÁúÀÇ¹®ÀÚ¿ (ÁúÀÇ¹®ÀÚ¿ÀÌ ÀÖ´Ù¸é ¾Õ¿¡ <code>?</code>¸¦
 136         ºÙÀÌ°í, ¾ø´Ù¸é ºó ¹®ÀÚ¿)</td></tr>
 137
 138     <tr><td><code>%...r</code></td>
 139         <td>¿äÃ»ÀÇ Ã¹¹øÂ° ÁÙ</td></tr>
 140
 141     <tr><td><code>%...s</code></td>
 142         <td>»óÅÂ(status). ³»ºÎ ¸®´ÙÀÌ·º¼ÇµÈ ¿äÃ»ÀÇ °æ¿ì *¿ø·¡*
 143         ¿äÃ»ÀÇ »óÅÂÀÌ´Ù. ÃÖÁ¾ ¿äÃ»ÀÇ »óÅÂ´Â <code>%...&gt;s</code>.</td></tr>
 144
 145     <tr><td><code>%...t</code></td>
 146         <td>common log format ½Ã°£ Çü½Ä(Ç¥ÁØ ¿µ¾î Çü½Ä)ÀÇ ½Ã°£</td></tr>
 147
 148     <tr><td><code>%...{<var>format</var>}t</code></td>
 149         <td><code>strftime(3)</code> Çü½Ä formatÀÇ ½Ã°£. (Áö¿ª½Ã°£ÀÏ
 150         ¼ö ÀÖÀ½)</td></tr>
 151
 152     <tr><td><code>%...T</code></td>
 153         <td>¿äÃ»À» Ã³¸®ÇÏ´Âµ¥ °É¸° ½Ã°£ (ÃÊ ´ÜÀ§).</td></tr>
 154
 155     <tr><td><code>%...u</code></td>
 156         <td>¿ø°Ý »ç¿ëÀÚ (auth°¡ Á¦°øÇÏ¸ç, »óÅÂ(<code>%s</code>)°¡
 157         401ÀÎ °æ¿ì ÀÌ»óÇÑ °ªÀ» ³ª¿Ã ¼ö ÀÖÀ½)</td></tr>
 158
 159     <tr><td><code>%...U</code></td>
 160         <td>ÁúÀÇ¹®ÀÚ¿À» Á¦¿ÜÇÑ ¿äÃ» URL °æ·Î.</td></tr>
 161
 162     <tr><td><code>%...v</code></td>
 163         <td>¿äÃ»À» ¼ºñ½ºÇÑ ¼¹öÀÇ Á¤±Ô <directive
 164         module="core">ServerName</directive>.</td></tr>
 165
 166     <tr><td><code>%...V</code></td>
 167         <td><directive module="core">UseCanonicalName</directive>
 168         ¼³Á¤¿¡ µû¸¥ ¼¹ö¸í.</td></tr>
 169
 170     <tr><td><code>%...X</code></td>
 171         <td>ÀÀ´äÀ» ¸¶ÃÆÀ»¶§ ¿¬°á »óÅÂ.
 172
 173         <table>
 174         <columnspec><column width=".2"/><column width=".6"/></columnspec>
 175         <tr><td><code>X</code> =</td>
 176             <td>ÀÀ´äÀ» ¸¶Ä¡±â Àü¿¡ ¿¬°áÀÌ ²÷¾îÁ³´Ù.</td></tr>
 177         <tr><td><code>+</code> =</td>
 178             <td>ÀÀ´äÀ» º¸³½ÈÄ¿¡µµ ¿¬°áÀÌ »ì¾ÆÀÖ´Ù(keep alive).</td></tr>
 179         <tr><td><code>-</code> = </td>
 180             <td>ÀÀ´äÀ» º¸³½ÈÄ ¿¬°áÀÌ ²÷¾îÁ³´Ù.</td></tr>
 181         </table>
 182
 183         <p>(¾ÆÆÄÄ¡ 1.3 ÈÄ¹Ý ¹öÀü¿¡¼ ÀÌ Áö½Ã¾î´Â
 184         <code>%...c</code>¿´Áö¸¸, ÀüÅëÀûÀÎ ssl
 185         <code>%...{<var>var</var>}c</code> ¹®¹ý°ú °ãÃÄ¼
 186         º¯°æÇß´Ù.)</p></td></tr>
 187
 188     <tr><td><code>%...I</code></td>
 189         <td>¿äÃ»°ú Çì´õ¸¦ Æ÷ÇÔÇÑ ¼ö½Å ¹ÙÀÌÆ®¼ö·Î 0ÀÏ ¼ö ¾ø´Ù.
 190         ÀÌ¸¦ »ç¿ëÇÏ·Á¸é <module>mod_logio</module>°¡ ÇÊ¿äÇÏ´Ù.</td></tr>
 191
 192     <tr><td><code>%...O</code></td>
 193         <td>Çì´õ¸¦ Æ÷ÇÔÇÑ ¼Û½Å ¹ÙÀÌÆ®¼ö·Î 0ÀÏ ¼ö ¾ø´Ù. ÀÌ¸¦
 194         »ç¿ëÇÏ·Á¸é <module>mod_logio</module>°¡ ÇÊ¿äÇÏ´Ù.</td></tr>
 195     </table>
 196
 197     <p>"<var>...</var>"¿¡´Â (<em>¿¹¸¦ µé¾î</em>,
 198     <code>"%h %u %r %s %b"</code>) ¾Æ¹«°Íµµ ¾ø°Å³ª, Ç×¸ñÀ» Æ÷ÇÔÇÒ
 199     Á¶°ÇÀÌ ³ª¿Â´Ù (Á¶°ÇÀ» ¸¸Á·ÇÏÁö ¾ÊÀ¸¸é ÀÚ¸®¿¡ "-"¸¦ ±â·ÏÇÑ´Ù).
 200     Á¶°ÇÀº ¾Õ¿¡ "!"¸¦ ºÙÀÌ°Å³ª ¾ÈºÙÀÎ HTTP »óÅÂÄÚµå ¸ñ·ÏÀ¸·Î
 201     ÀÛ¼ºÇÑ´Ù. ¿¹¸¦ µé¾î, "%400,501{User-agent}i"´Â 400 (Bad
 202     Request) ¿À·ù¿Í 501 (Not Implemented) ¿À·ùÀÏ¶§¸¸
 203     <code>User-agent:</code>¸¦ ·Î±×¿¡ ³²±â°í,
 204     "%!200,304,302{Referer}i"´Â Á¤»óÀûÀÎ »óÅÂ°¡ <em>¾Æ´Ñ</em>
 205     ¸ðµç ¿äÃ»¿¡ ´ëÇØ <code>Referer:</code>¸¦ ·Î±×¿¡ ³²±ä´Ù.</p>
 206
 207     <p>¼öÁ¤ÀÚ "&lt;"¿Í "&gt;"´Â ³»ºÎ ¸®´ÙÀÌ·º¼ÇµÈ ¿äÃ»¿¡¼ °¢°¢
 208     Ã³À½ ¿äÃ»À» ¸»ÇÒÁö ¸¶Áö¸· ¿äÃ»À» ¸»ÇÒÁö ¼±ÅÃÇÑ´Ù. ±âº»ÀûÀ¸·Î
 209     <code>%s, %U, %T, %D, %r</code>Àº Ã³À½ ¿äÃ»À» º¸°í, ³ª¸ÓÁö
 210     <code>%</code> Áö½Ã¾î´Â ¸¶Áö¸· ¿äÃ»À» º»´Ù. ±×·¡¼
 211     <code>%&gt;s</code>´Â ¿äÃ»ÀÇ ¸¶Áö¸· »óÅÂ(status)¸¦ ±â·ÏÇÏ°í,
 212     <code>%&lt;u</code>´Â ÀÎÁõÀ¸·Î º¸È£ÇÏÁö ¾Ê´Â ÀÚ¿øÀ¸·Î ³»ºÎ
 213     ¶ó´ÙÀÌ·º¼ÇµÈ °æ¿ì¿¡µµ Ã³À½¿¡ ÀÎÁõÇÑ »ç¿ëÀÚ¸¦ ±â·ÏÇÑ´Ù.</p>
 214
 215     <p>2.0.46 ÀÌÀüÀÇ httpd 2.0 ¹öÀüÀº <code>%...r</code>,
 216     <code>%...i</code>, <code>%...o</code>ÀÇ °á°ú ¹®ÀÚ¿À» ±×´ë·Î
 217     µÎ¾ú´Ù. ÀÌÀ¯´Â Common Log FormatÀÇ ¿ä±¸»çÇ×À» µû¸£±âÀ§ÇØ¼¿´´Ù.
 218     Áï, Å¬¶óÀÌ¾ðÆ®°¡ Á¦¾î¹®ÀÚ¸¦ ·Î±×¿¡ Áý¾î³ÖÀ» ¼ö ÀÖ±â¶§¹®¿¡
 219     ·Î±×ÆÄÀÏÀ» ±×´ë·Î ´Ù·ê ¶§´Â Á¶½ÉÇØ¾ß ÇÑ´Ù.</p>
 220
 221     <p>º¸¾È»ó ÀÌÀ¯·Î 2.0.46ºÎÅÍ Ãâ·ÂÇÒ ¼ö ¾ø´Â ¹®ÀÚ³ª ´Ù¸¥ Æ¯¼ö¹®ÀÚ¸¦
 222     <code>\x<var>hh</var></code>·Î Ç¥ÇöÇÑ´Ù. ¿©±â¼ <var>hh</var>´Â
 223     ÇØ´ç ¹ÙÀÌÆ®ÀÇ 16Áø¼ö Ç¥ÇöÀ» ³ªÅ¸³½´Ù. ÀÌ ±ÔÄ¢ÀÇ ¿¹¿Ü´Â ¹é½½·¡½¬¸¦
 224     ¾Õ¿¡ ºÙÀÌ´Â <code>"</code>¿Í <code>\</code>, ±×¸®°í C¾ð¾î
 225     Çü½ÄÀÇ °ø¹é¹®ÀÚµé(<code>\n</code>, <code>\t</code> µî)ÀÌ´Ù.</p>
 226
 227     <p>ÀÏ¹ÝÀûÀ¸·Î ¸¹ÀÌ »ç¿ëÇÏ´Â ·Î±× Çü½ÄÀº ´ÙÀ½°ú °°´Ù.</p>
 228
 229     <dl>
 230       <dt>Common Log Format (CLF)</dt>
 231       <dd><code>"%h %l %u %t \"%r\" %&gt;s %b"</code></dd>
 232
 233       <dt>°¡»óÈ£½ºÆ® Á¤º¸¸¦ Æ÷ÇÔÇÑ Common Log Format</dt>
 234       <dd><code>"%v %h %l %u %t \"%r\" %&gt;s %b"</code></dd>
 235
 236       <dt>NCSA extended/combined ·Î±× Çü½Ä</dt>
 237       <dd><code>"%h %l %u %t \"%r\" %&gt;s %b \"%{Referer}i\"
 238       \"%{User-agent}i\""</code></dd>
 239
 240       <dt>Referer ·Î±× Çü½Ä</dt>
 241       <dd><code>"%{Referer}i -&gt; %U"</code></dd>
 242
 243       <dt>Agent (ºê¶ó¿ìÀú) ·Î±× Çü½Ä</dt>
 244       <dd><code>"%{User-agent}i"</code></dd>
 245     </dl>
 246
 247     <p>¿äÃ»À» ¼ºñ½ºÇÏ´Â ¼¹öÀÇ Á¤±Ô <directive
 248     module="core">ServerName</directive>°ú <directive
 249     module="mpm_common">Listen</directive>Àº °¢°¢ <code>%v</code>¿Í
 250     <code>%p</code>¸¦ »ç¿ëÇÑ´Ù. ·Î±×ºÐ¼® ÇÁ·Î±×·¥ÀÌ ½ÇÁ¦·Î ¿äÃ»À»
 251     ¼ºñ½ºÇÏ´Â È£½ºÆ®¸¦ ¾Ë±âÀ§ÇØ °¡»óÈ£½ºÆ® Ã£±â ¾Ë°í¸®ÁòÀ»
 252     °¡Áú ÇÊ¿ä¾øµµ·Ï ÀÌµé °ªÀº <directive
 253     module="core">UseCanonicalName</directive> ¼³Á¤°ú ¹«°üÇÏ´Ù.</p>
 254 </section>
 255
 256 <section id="security"><title>º¸¾È»ó °í·ÁÇÒ Á¡</title>
 257     <p>¼¹ö¸¦ ½ÃÀÛÇÏ´Â »ç¿ëÀÚ¿Ü¿¡ ´Ù¸¥ »ç¿ëÀÚ°¡ ·Î±×ÆÄÀÏÀ» ÀúÀåÇÏ´Â
 258     µð·ºÅä¸®¿¡ ¾²±â ±ÇÇÑÀ» °¡Áú¶§ ¿Ö º¸¾È¿¡ ¹®Á¦°¡ »ý±â´ÂÁö
 259     <a href="../misc/security_tips.html#serverroot">º¸¾È ÆÁ</a>
 260     ¹®¼¸¦ Âü°íÇÏ¶ó.</p>
 261 </section>
 262
 263 <directivesynopsis>
 264 <name>BufferedLogs</name>
 265 <description>Buffer log entries in memory before writing to disk</description>
 266 <contextlist><context>server config</context></contextlist>
 267 <usage><p>Documentation not yet translated. Please see English version of document.</p></usage>
 268 </directivesynopsis>
 269
 270 <directivesynopsis>
 271 <name>CustomLog</name>
 272 <description>·Î±×ÆÄÀÏ ÀÌ¸§°ú Çü½ÄÀ» ÁöÁ¤ÇÑ´Ù</description>
 273 <syntax>CustomLog  <var>file</var>|<var>pipe</var>
 274 <var>format</var>|<var>nickname</var>
 275 [env=[!]<var>environment-variable</var>]</syntax>
 276 <contextlist><context>server config</context><context>virtual host</context>
 277 </contextlist>
 278
 279 <usage>
 280     <p>¼¹ö°¡ ¿äÃ»À» ·Î±×¿¡ ³²±æ¶§ <directive>CustomLog</directive>
 281     Áö½Ã¾î¸¦ »ç¿ëÇÑ´Ù. ·Î±× Çü½ÄÀ» ÁöÁ¤ÇÏ°í, È¯°æº¯¼ö¸¦ »ç¿ëÇÏ¿©
 282     ¿äÃ»ÀÇ Æ¯Â¡¿¡ µû¶ó ¼±ÅÃÀûÀ¸·Î ·Î±×¸¦ ³²±æ ¼öµµ ÀÖ´Ù.</p>
 283
 284     <p>·Î±×¸¦ ±â·ÏÇÒ Àå¼Ò¸¦ ÁöÁ¤ÇÏ´Â Ã¹¹øÂ° ¾Æ±Ô¸ÕÆ®¿¡´Â ´ÙÀ½
 285     µÑÁß ÇÏ³ª¸¦ »ç¿ëÇÑ´Ù.</p>
 286
 287     <dl>
 288       <dt><var>file</var></dt>
 289       <dd><directive module="core">ServerRoot</directive>¿¡
 290       »ó´ëÀûÀÎ ÆÄÀÏ¸í.</dd>
 291
 292       <dt><var>pipe</var></dt>
 293       <dd>ÆÄÀÌÇÁ¹®ÀÚ "<code>|</code>"µÚ¿¡ ·Î±× Á¤º¸¸¦ Ç¥ÁØÀÔ·ÂÀ¸·Î
 294       ¹ÞÀ» ÇÁ·Î±×·¥ °æ·Î¸¦ Àû´Â´Ù.
 295
 296       <note type="warning"><title>º¸¾È:</title>
 297       <p>ÇÁ·Î±×·¥À» »ç¿ëÇÑ´Ù¸é ÇÁ·Î±×·¥Àº À¥¼¹ö¸¦ ½ÃÀÛÇÑ »ç¿ëÀÚ
 298       ±ÇÇÑÀ¸·Î ½ÇÇàµÈ´Ù. ¼¹ö¸¦ root·Î ½ÃÀÛÇÑ´Ù¸é ÇÁ·Î±×·¥µµ
 299       root·Î ½ÇÇàÇÏ¹Ç·Î ÇÁ·Î±×·¥ÀÌ ¾ÈÀüÇÑÁö È®ÀÎÇÏ¶ó.</p>
 300       </note>
 301       <note type="warning"><title>ÁÖÀÇ</title>
 302         <p>À¯´Ð½º°¡ ¾Æ´Ñ ÇÃ·¡Æû¿¡¼ ÆÄÀÏ°æ·Î¸¦ ÀÔ·ÂÇÒ¶§ ÇÃ·¡ÆûÀÌ
 303         ¹é½½·¡½¬¸¦ »ç¿ëÇÏ´õ¶óµµ ¹Ýµå½Ã ½½·¡½¬¸¦ »ç¿ëÇØ¾ß ÇÑ´Ù.
 304         ÀÏ¹ÝÀûÀ¸·Î ¼³Á¤ÆÄÀÏ¿¡¼´Â Ç×»ó ½½·¡½¬¸¦ »ç¿ëÇÏ´Â °ÍÀÌ
 305         ÁÁ´Ù.</p>
 306       </note></dd>
 307     </dl>
 308
 309     <p>µÎ¹øÂ° ¾Æ±Ô¸ÕÆ®´Â ·Î±×ÆÄÀÏ¿¡ ±â·ÏÇÒ ³»¿ëÀ» ÁöÁ¤ÇÑ´Ù.
 310     Àü¿¡ <directive module="mod_log_config">LogFormat</directive>À¸·Î
 311     Á¤ÀÇÇÑ <var>nickname</var>À» »ç¿ëÇÏ°Å³ª Á÷Á¢ <a
 312     href="#formats">·Î±× Çü½Ä</a> Àý¿¡¼ ¼³¸íÇÑ <var>format</var>
 313     ¹®ÀÚ¿À» »ç¿ëÇÒ ¼ö ÀÖ´Ù.</p>
 314
 315     <p>¿¹¸¦ µé¾î, ´ÙÀ½ µÎ Áö½Ã¾î´Â ¶È°°Àº ÀÏÀ» ÇÑ´Ù.</p>
 316
 317     <example>
 318       # Çü½Ä º°ÄªÀ» »ç¿ëÇÑ CustomLog<br />
 319       LogFormat "%h %l %u %t \"%r\" %&gt;s %b" common<br />
 320       CustomLog logs/access_log common<br />
 321       <br />
 322       # Á÷Á¢ Çü½Ä ¹®ÀÚ¿À» »ç¿ëÇÑ CustomLog<br />
 323       CustomLog logs/access_log "%h %l %u %t \"%r\" %&gt;s %b"
 324     </example>
 325
 326     <p>¼¼¹øÂ° ¾Æ±Ô¸ÕÆ®´Â ¾ø¾îµµ µÇ¸ç, Æ¯Á¤ ¼¹ö È¯°æº¯¼ö À¯¹«¿¡
 327     µû¶ó ¿äÃ»À» ·Î±×¿¡ ±â·ÏÇÒÁö ¿©ºÎ¸¦ °áÁ¤ÇÑ´Ù. ¿äÃ»¿¡ ÁöÁ¤ÇÑ
 328     <a href="../env.html">È¯°æº¯¼ö</a>°¡ Á¤ÀÇµÇÀÖ´Ù¸é (È¤Àº
 329     '<code>env=!<var>name</var></code>'¸¦ »ç¿ëÇÑ °æ¿ì ¾ø´Ù¸é)
 330     ¿äÃ»À» ·Î±×¿¡ ±â·ÏÇÑ´Ù.</p>
 331
 332     <p><module>mod_setenvif</module>³ª <module>mod_rewrite</module>
 333     ¸ðµâÀ» »ç¿ëÇÏ¿© ¿äÃ»º°·Î È¯°æº¯¼ö¸¦ ¼³Á¤ÇÒ ¼ö ÀÖ´Ù. ¿¹¸¦
 334     µé¾î, ¼¹ö°¡ GIF ±×¸²¿¡ ´ëÇÑ ¸ðµç ¿äÃ»À» ÁÖ¼¹ö ·Î±×°¡ ¾Æ´Ñ
 335     ´Ù¸¥ ·Î±×ÆÄÀÏ¿¡ ±â·ÏÇÏ·Á¸é,</p>
 336
 337     <example>
 338       SetEnvIf Request_URI \.gif$ gif-image<br />
 339       CustomLog gif-requests.log common env=gif-image<br />
 340       CustomLog nongif-requests.log common env=!gif-image
 341     </example>
 342 </usage>
 343 </directivesynopsis>
 344
 345 <directivesynopsis>
 346 <name>LogFormat</name>
 347 <description>·Î±×ÆÄÀÏ¿¡ »ç¿ëÇÒ Çü½ÄÀ» ±â¼úÇÑ´Ù</description>
 348 <syntax>LogFormat <var>format</var>|<var>nickname</var>
 349 [<var>nickname</var>]</syntax>
 350 <default>LogFormat "%h %l %u %t \"%r\" %>s %b"</default>
 351 <contextlist><context>server config</context><context>virtual host</context>
 352 </contextlist>
 353
 354 <usage>
 355     <p>ÀÌ Áö½Ã¾î´Â Á¢±Ù ·Î±×ÆÄÀÏÀÇ Çü½ÄÀ» ÁöÁ¤ÇÑ´Ù.</p>
 356
 357     <p><directive>LogFormat</directive> Áö½Ã¾î´Â µÎ°¡Áö Çü½ÄÀ¸·Î
 358     »ç¿ëÇÑ´Ù. Ã¹¹øÂ° Çü½ÄÀº ¾Æ±Ô¸ÕÆ®¸¦ ÇÑ°³¸¸ »ç¿ëÇÏ¿© ´ÙÀ½
 359     <directive>TransferLog</directive> Áö½Ã¾îµéÀÌ »ç¿ëÇÒ ·Î±×
 360     Çü½ÄÀ» ÁöÁ¤ÇÑ´Ù. ÀÌ ¾Æ±Ô¸ÕÆ®¿¡ À§ÀÇ <a href="#formats">·Î±×
 361     Çü½Ä ÁöÁ¤ÇÏ±â</a> Àý¿¡¼ ¼³¸íÇÑ <var>format</var>À» Á÷Á¢
 362     »ç¿ëÇÏ°Å³ª, ´ÙÀ½¿¡ ¼³¸íÇÒ <directive>LogFormat</directive>
 363     Áö½Ã¾î·Î ¹Ì¸® Á¤ÀÇÇÑ (·Î±× Çü½ÄÀ» ÁöÄªÇÏ´Â) <var>nickname</var>À»
 364     »ç¿ëÇÒ ¼ö ÀÖ´Ù.</p>
 365
 366     <p><directive>LogFormat</directive> Áö½Ã¾îÀÇ µÎ¹øÂ° Çü½ÄÀº
 367     <var>format</var>°ú <var>nickname</var>À» ¿¬°áÇÑ´Ù. ±×·¯¸é
 368     µÚ¿¡¼ »ç¿ëÇÏ´Â <directive>LogFormat</directive>ÀÌ³ª <directive
 369     module="mod_log_config">CustomLog</directive> Áö½Ã¾î¿¡ ¹Ýº¹ÇØ¼
 370     Çü½Ä ¹®ÀÚ¿À» ¸ðµÎ ÀÔ·ÂÇÏ´Â ´ë½Å <var>nickname</var>À» »ç¿ëÇÒ
 371     ¼ö ÀÖ´Ù. º°ÄªÀ» Á¤ÀÇÇÏ´Â <directive>LogFormat</directive>
 372     Áö½Ã¾î´Â <strong>ÀÌ ¿Ü¿¡´Â ¾Æ¹« ±â´ÉÀ» ÇÏÁö ¾Ê´Â´Ù</strong>.
 373     Áï, º°Äª<em>¸¸</em>À» Á¤ÀÇÇÏ¸ç, ½ÇÁ¦·Î Çü½ÄÀ» Àû¿ëÇÏ°Å³ª
 374     Çü½ÄÀ» ±âº»°ªÀ¸·Î ¸¸µéÁö ¾Ê´Â´Ù. ±×·¯¹Ç·Î ´ÙÀ½¿¡ ³ª¿À´Â
 375     <directive module="mod_log_config">TransferLog</directive>
 376     Áö½Ã¾î¿¡ ¿µÇâÀ» ÁÖÁö ¾Ê´Â´Ù. ¶Ç,
 377     <directive>LogFormat</directive>Àº º°ÄªÀ¸·Î ´Ù¸¥ º°ÄªÀ»
 378     Á¤ÀÇÇÒ ¼ö ÀÖ´Ù. º°Äª ÀÌ¸§¿¡´Â ÆÛ¼¾Æ® ±âÈ£(<code>%</code>)¸¦
 379     »ç¿ëÇÒ ¼ö ¾øÀ½À» ÁÖÀÇÇÏ¶ó.</p>
 380
 381     <example><title>¿¹Á¦</title>
 382       LogFormat "%v %h %l %u %t \"%r\" %&gt;s %b" vhost_common
 383     </example>
 384 </usage>
 385 </directivesynopsis>
 386
 387 <directivesynopsis>
 388 <name>TransferLog</name>
 389 <description>·Î±×ÆÄÀÏ À§Ä¡¸¦ ¼³Á¤ÇÑ´Ù</description>
 390 <syntax>TransferLog <var>file</var>|<var>pipe</var></syntax>
 391 <contextlist><context>server config</context><context>virtual host</context>
 392 </contextlist>
 393
 394 <usage>
 395     <p>ÀÌ Áö½Ã¾î´Â <directive
 396     module="mod_log_config">CustomLog</directive> Áö½Ã¾î¿Í ¾Æ±Ô¸ÕÆ®¿Í
 397     ±â´ÉÀÌ ºñ½ÁÇÏÁö¸¸, ·Î±× Çü½ÄÀ» Á÷Á¢ ÁöÁ¤ÇÏ°Å³ª ¿äÃ»À» Á¶°Ç¿¡
 398     µû¶ó ·Î±×¿¡ ³²±æ ¼ö ¾ø´Ù. ´ë½Å °¡Àå ÃÖ±Ù »ç¿ëÇÑ (º°ÄªÀ»
 399     Á¤ÀÇÇÏÁö ¾ÊÀº) <directive
 400     module="mod_log_config">LogFormat</directive> Áö½Ã¾î°¡ ÁöÁ¤ÇÑ
 401     ·Î±× Çü½ÄÀ» »ç¿ëÇÑ´Ù. ¹Ì¸® Çü½ÄÀ» ÁöÁ¤ÇÏÁö ¾Ê¾Ò´Ù¸é Common
 402     Log FormatÀ» »ç¿ëÇÑ´Ù.</p>
 403
 404     <example><title>¿¹Á¦</title>
 405       LogFormat "%h %l %u %t \"%r\" %&gt;s %b \"%{Referer}i\" \"%{User-agent}i\""<br />
 406       TransferLog logs/access_log
 407     </example>
 408 </usage>
 409 </directivesynopsis>
 410
 411 </modulesynopsis>