github.com/krum110487/go-htaccess@v0.0.0-20240316004156-60641c8e7598/tests/data/apache_2_2_34/manual/mod/mod_log_config.html.ko.euc-kr (about)

     1  <?xml version="1.0" encoding="EUC-KR"?>
     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="ko" xml:lang="ko"><head>
     4  <meta content="text/html; charset=EUC-KR" 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 Server Version 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 Server Version 2.2</p>
    22  <img alt="" src="../images/feather.gif" /></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 Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.2</a> &gt; <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>아파치 모듈 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">&nbsp;en&nbsp;</a> |
    32  <a href="../ja/mod/mod_log_config.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
    33  <a href="../ko/mod/mod_log_config.html" title="Korean">&nbsp;ko&nbsp;</a> |
    34  <a href="../tr/mod/mod_log_config.html" hreflang="tr" rel="alternate" title="T&#252;rk&#231;e">&nbsp;tr&nbsp;</a></p>
    35  </div>
    36  <div class="outofdate">이 문서는 최신판 번역이 아닙니다.
    37              최근에 변경된 내용은 영어 문서를 참고하세요.</div>
    38  <table class="module"><tr><th><a href="module-dict.html#Description">설명:</a></th><td>서버로의 요청을 로그에 기록한다</td></tr>
    39  <tr><th><a href="module-dict.html#Status">상태:</a></th><td>Base</td></tr>
    40  <tr><th><a href="module-dict.html#ModuleIdentifier">모듈명:</a></th><td>log_config_module</td></tr>
    41  <tr><th><a href="module-dict.html#SourceFile">소스파일:</a></th><td>mod_log_config.c</td></tr></table>
    42  <h3>요약</h3>
    43  
    44      <p>이 모듈은 클라이언트의 요청을 로그에 자유롭게 기록한다.
    45      자신이 원하는 형식으로 로그를 기록할 수 있고, 파일이나 외부
    46      프로그램에 직접 로그를 보낼 수도 있다. 조건적 로그를 사용하면
    47      요청의 성격에 따라 요청을 로그에 추가하거나 제외할 수 있다.</p>
    48  
    49      <p>이 모듈은 세가지 지시어를 제공한다. <code class="directive"><a href="#transferlog">TransferLog</a></code>는 로그파일을
    50      만들고, <code class="directive"><a href="#logformat">LogFormat</a></code>은
    51      원하는 형식을 정하고, <code class="directive"><a href="#customlog">CustomLog</a></code>는 한번에 로그파일과
    52      형식을 모두 지정한다. <code class="directive">TransferLog</code>와
    53      <code class="directive">CustomLog</code> 지시어를 여러번 사용하면
    54      요청을 여러 파일에 기록할 수 있다.</p>
    55  </div>
    56  <div id="quickview"><h3>주제</h3>
    57  <ul id="topics">
    58  <li><img alt="" src="../images/down.gif" /> <a href="#formats">로그 형식 지정하기</a></li>
    59  <li><img alt="" src="../images/down.gif" /> <a href="#security">보안상 고려할 점</a></li>
    60  </ul><h3 class="directives">지시어들</h3>
    61  <ul id="toc">
    62  <li><img alt="" src="../images/down.gif" /> <a href="#bufferedlogs">BufferedLogs</a></li>
    63  <li><img alt="" src="../images/down.gif" /> <a href="#cookielog">CookieLog</a></li>
    64  <li><img alt="" src="../images/down.gif" /> <a href="#customlog">CustomLog</a></li>
    65  <li><img alt="" src="../images/down.gif" /> <a href="#logformat">LogFormat</a></li>
    66  <li><img alt="" src="../images/down.gif" /> <a href="#transferlog">TransferLog</a></li>
    67  </ul>
    68  <h3>참고</h3>
    69  <ul class="seealso">
    70  <li><a href="../logs.html">아파치 로그파일</a></li>
    71  </ul><ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div>
    72  <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
    73  <div class="section">
    74  <h2><a name="formats" id="formats">로그 형식 지정하기</a></h2>
    75  
    76      <p><code class="directive"><a href="#logformat">LogFormat</a></code>과
    77      <code class="directive"><a href="#customlog">CustomLog</a></code>
    78      지시어의 형식 아규먼트는 문자열이다. 이 문자열에 따라 요청을
    79      로그파일에 기록한다. 문자열에는 로그파일에 그대로 복사되는
    80      문자와 행바꿈과 탭을 나타내는 C의 "\n"과 "\t" 제어문자를
    81      사용할 수 있다. 로그파일에 따옴표나 백슬래쉬를 쓰려면 앞에
    82      반드시 백슬래쉬를 적어줘야 한다.</p>
    83  
    84      <p>요청의 특징은 형식 문자열에 "<code>%</code>" 지시어를
    85      사용하여 기록한다. 이 지시어는 로그파일에서 다음과 같이
    86      변경된다.</p>
    87  
    88      <table class="bordered"><tr class="header"><th>형식&nbsp;문자열</th>
    89          <th>설명</th></tr>
    90  <tr><td><code>%%</code></td>
    91          <td>퍼센트 기호</td></tr>
    92  <tr class="odd"><td><code>%...a</code></td>
    93          <td>원격 IP-주소</td></tr>
    94  <tr><td><code>%...A</code></td>
    95          <td>(서버) IP-주소</td></tr>
    96  <tr class="odd"><td><code>%...B</code></td>
    97          <td>HTTP 헤더를 제외한 전송 바이트수.</td></tr>
    98  <tr><td><code>%...b</code></td>
    99          <td>HTTP 헤더를 제외한 전송 바이트수. CLF 형식과 같이
   100          전송한 내용이 없는 경우 0 대신 '<code>-</code>'가 나온다.</td></tr>
   101  <tr class="odd"><td><code>%...{<var>Foobar</var>}C</code></td>
   102          <td>서버가 수신한 요청에서 <var>Foobar</var> 쿠키의
   103          내용.</td></tr>
   104  <tr><td><code>%...D</code></td>
   105          <td>요청을 처리하는데 걸린 시간 (마이크로초 단위).</td></tr>
   106  <tr class="odd"><td><code>%...{<var>FOOBAR</var>}e</code></td>
   107          <td>환경변수 <var>FOOBAR</var>의 내용</td></tr>
   108  <tr><td><code>%...f</code></td>
   109          <td>파일명</td></tr>
   110  <tr class="odd"><td><code>%...h</code></td>
   111          <td>원격 호스트</td></tr>
   112  <tr><td><code>%...H</code></td>
   113          <td>요청 프로토콜</td></tr>
   114  <tr class="odd"><td><code>%...{<var>Foobar</var>}i</code></td>
   115          <td>서버가 수신한 요청에서 <code><var>Foobar</var>:</code>
   116          헤더의 내용.</td></tr>
   117  <tr><td><code>%...l</code></td>
   118          <td>(있다면 identd가 제공한) 원격 로그인명.
   119          <code class="module"><a href="../mod/mod_ident.html">mod_ident</a></code>가 있고 <code class="directive"><a href="../mod/mod_ident.html#identitycheck">IdentityCheck</a></code>가
   120          <code>On</code>이 아니면 빼기기호를 기록한다.</td></tr>
   121  <tr class="odd"><td><code>%...m</code></td>
   122          <td>요청 메써드</td></tr>
   123  <tr><td><code>%...{<var>Foobar</var>}n</code></td>
   124          <td>다른 모듈이 기록한 <var>Foobar</var> 노트(note)
   125          내용.</td></tr>
   126  <tr class="odd"><td><code>%...{<var>Foobar</var>}o</code></td>
   127          <td>응답의 <code><var>Foobar</var>:</code> 헤더 내용.</td></tr>
   128  <tr><td><code>%...p</code></td>
   129          <td>요청을 서비스하는 서버의 정규 포트</td></tr>
   130  <tr class="odd"><td><code>%...P</code></td>
   131          <td>요청을 서비스하는 자식의 프로세스 ID.</td></tr>
   132  <tr><td><code>%...{<var>format</var>}P</code></td>
   133          <td>요청을 서비스하는 자식의 프로세스 ID 혹은 쓰레드
   134          ID. format에는 <code>pid</code>와 <code>tid</code>가
   135          가능하다.
   136          </td></tr>
   137  <tr class="odd"><td><code>%...q</code></td>
   138          <td>질의문자열 (질의문자열이 있다면 앞에 <code>?</code>를
   139          붙이고, 없다면 빈 문자열)</td></tr>
   140  <tr><td><code>%...r</code></td>
   141          <td>요청의 첫번째 줄</td></tr>
   142  <tr class="odd"><td><code>%...s</code></td>
   143          <td>상태(status). 내부 리다이렉션된 요청의 경우 *원래*
   144          요청의 상태이다. 최종 요청의 상태는 <code>%...&gt;s</code>.</td></tr>
   145  <tr><td><code>%...t</code></td>
   146          <td>common log format 시간 형식(표준 영어 형식)의 시간</td></tr>
   147  <tr class="odd"><td><code>%...{<var>format</var>}t</code></td>
   148          <td><code>strftime(3)</code> 형식 format의 시간. (지역시간일
   149          수 있음)</td></tr>
   150  <tr><td><code>%...T</code></td>
   151          <td>요청을 처리하는데 걸린 시간 (초 단위).</td></tr>
   152  <tr class="odd"><td><code>%...u</code></td>
   153          <td>원격 사용자 (auth가 제공하며, 상태(<code>%s</code>)가
   154          401인 경우 이상한 값을 나올 수 있음)</td></tr>
   155  <tr><td><code>%...U</code></td>
   156          <td>질의문자열을 제외한 요청 URL 경로.</td></tr>
   157  <tr class="odd"><td><code>%...v</code></td>
   158          <td>요청을 서비스한 서버의 정규 <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code>.</td></tr>
   159  <tr><td><code>%...V</code></td>
   160          <td><code class="directive"><a href="../mod/core.html#usecanonicalname">UseCanonicalName</a></code>
   161          설정에 따른 서버명.</td></tr>
   162  <tr class="odd"><td><code>%...X</code></td>
   163          <td>응답을 마쳤을때 연결 상태.
   164  
   165          <table>
   166          
   167          <tr><td><code>X</code> =</td>
   168              <td>응답을 마치기 전에 연결이 끊어졌다.</td></tr>
   169          <tr><td><code>+</code> =</td>
   170              <td>응답을 보낸후에도 연결이 살아있다(keep alive).</td></tr>
   171          <tr><td><code>-</code> = </td>
   172              <td>응답을 보낸후 연결이 끊어졌다.</td></tr>
   173          </table>
   174  
   175          <p>(아파치 1.3 후반 버전에서 이 지시어는
   176          <code>%...c</code>였지만, 전통적인 ssl
   177          <code>%...{<var>var</var>}c</code> 문법과 겹쳐서
   178          변경했다.)</p></td></tr>
   179  <tr><td><code>%...I</code></td>
   180          <td>요청과 헤더를 포함한 수신 바이트수로 0일 수 없다.
   181          이를 사용하려면 <code class="module"><a href="../mod/mod_logio.html">mod_logio</a></code>가 필요하다.</td></tr>
   182  <tr class="odd"><td><code>%...O</code></td>
   183          <td>헤더를 포함한 송신 바이트수로 0일 수 없다. 이를
   184          사용하려면 <code class="module"><a href="../mod/mod_logio.html">mod_logio</a></code>가 필요하다.</td></tr>
   185  </table>
   186  
   187      <p>"<var>...</var>"에는 (<em>예를 들어</em>,
   188      <code>"%h %u %r %s %b"</code>) 아무것도 없거나, 항목을 포함할
   189      조건이 나온다 (조건을 만족하지 않으면 자리에 "-"를 기록한다).
   190      조건은 앞에 "!"를 붙이거나 안붙인 HTTP 상태코드 목록으로
   191      작성한다. 예를 들어, "%400,501{User-agent}i"는 400 (Bad
   192      Request) 오류와 501 (Not Implemented) 오류일때만
   193      <code>User-agent:</code>를 로그에 남기고,
   194      "%!200,304,302{Referer}i"는 정상적인 상태가 <em>아닌</em>
   195      모든 요청에 대해 <code>Referer:</code>를 로그에 남긴다.</p>
   196  
   197      <p>수정자 "&lt;"와 "&gt;"는 내부 리다이렉션된 요청에서 각각
   198      처음 요청을 말할지 마지막 요청을 말할지 선택한다. 기본적으로
   199      <code>%s, %U, %T, %D, %r</code>은 처음 요청을 보고, 나머지
   200      <code>%</code> 지시어는 마지막 요청을 본다. 그래서
   201      <code>%&gt;s</code>는 요청의 마지막 상태(status)를 기록하고,
   202      <code>%&lt;u</code>는 인증으로 보호하지 않는 자원으로 내부
   203      라다이렉션된 경우에도 처음에 인증한 사용자를 기록한다.</p>
   204  
   205      <p>2.0.46 이전의 httpd 2.0 버전은 <code>%...r</code>,
   206      <code>%...i</code>, <code>%...o</code>의 결과 문자열을 그대로
   207      두었다. 이유는 Common Log Format의 요구사항을 따르기위해서였다.
   208      즉, 클라이언트가 제어문자를 로그에 집어넣을 수 있기때문에
   209      로그파일을 그대로 다룰 때는 조심해야 한다.</p>
   210  
   211      <p>보안상 이유로 2.0.46부터 출력할 수 없는 문자나 다른 특수문자를
   212      <code>\x<var>hh</var></code>로 표현한다. 여기서 <var>hh</var>는
   213      해당 바이트의 16진수 표현을 나타낸다. 이 규칙의 예외는 백슬래쉬를
   214      앞에 붙이는 <code>"</code>와 <code>\</code>, 그리고 C언어
   215      형식의 공백문자들(<code>\n</code>, <code>\t</code> 등)이다.</p>
   216  
   217      <p>일반적으로 많이 사용하는 로그 형식은 다음과 같다.</p>
   218  
   219      <dl>
   220        <dt>Common Log Format (CLF)</dt>
   221        <dd><code>"%h %l %u %t \"%r\" %&gt;s %b"</code></dd>
   222  
   223        <dt>가상호스트 정보를 포함한 Common Log Format</dt>
   224        <dd><code>"%v %h %l %u %t \"%r\" %&gt;s %b"</code></dd>
   225  
   226        <dt>NCSA extended/combined 로그 형식</dt>
   227        <dd><code>"%h %l %u %t \"%r\" %&gt;s %b \"%{Referer}i\"
   228        \"%{User-agent}i\""</code></dd>
   229  
   230        <dt>Referer 로그 형식</dt>
   231        <dd><code>"%{Referer}i -&gt; %U"</code></dd>
   232  
   233        <dt>Agent (브라우저) 로그 형식</dt>
   234        <dd><code>"%{User-agent}i"</code></dd>
   235      </dl>
   236  
   237      <p>요청을 서비스하는 서버의 정규 <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code>과 <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code>은 각각 <code>%v</code>와
   238      <code>%p</code>를 사용한다. 로그분석 프로그램이 실제로 요청을
   239      서비스하는 호스트를 알기위해 가상호스트 찾기 알고리즘을
   240      가질 필요없도록 이들 값은 <code class="directive"><a href="../mod/core.html#usecanonicalname">UseCanonicalName</a></code> 설정과 무관하다.</p>
   241  </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
   242  <div class="section">
   243  <h2><a name="security" id="security">보안상 고려할 점</a></h2>
   244      <p>서버를 시작하는 사용자외에 다른 사용자가 로그파일을 저장하는
   245      디렉토리에 쓰기 권한을 가질때 왜 보안에 문제가 생기는지
   246      <a href="../misc/security_tips.html#serverroot">보안 팁</a>
   247      문서를 참고하라.</p>
   248  </div>
   249  <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
   250  <div class="directive-section"><h2><a name="BufferedLogs" id="BufferedLogs">BufferedLogs</a> <a name="bufferedlogs" id="bufferedlogs">지시어</a></h2>
   251  <table class="directive">
   252  <tr><th><a href="directive-dict.html#Description">설명:</a></th><td>Buffer log entries in memory before writing to disk</td></tr>
   253  <tr><th><a href="directive-dict.html#Syntax">문법:</a></th><td><code>BufferedLogs On|Off</code></td></tr>
   254  <tr><th><a href="directive-dict.html#Default">기본값:</a></th><td><code>BufferedLogs Off</code></td></tr>
   255  <tr><th><a href="directive-dict.html#Context">사용장소:</a></th><td>주서버설정</td></tr>
   256  <tr><th><a href="directive-dict.html#Status">상태:</a></th><td>Base</td></tr>
   257  <tr><th><a href="directive-dict.html#Module">모듈:</a></th><td>mod_log_config</td></tr>
   258  <tr><th><a href="directive-dict.html#Compatibility">지원:</a></th><td>Available in versions 2.0.41 and later.</td></tr>
   259  </table><p>The documentation for this directive has
   260              not been translated yet. Please have a look at the English
   261              version.</p></div>
   262  <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
   263  <div class="directive-section"><h2><a name="CookieLog" id="CookieLog">CookieLog</a> <a name="cookielog" id="cookielog">지시어</a></h2>
   264  <table class="directive">
   265  <tr><th><a href="directive-dict.html#Description">설명:</a></th><td>쿠키를 로그에 남기기위해 사용할 파일명을 설정한다</td></tr>
   266  <tr><th><a href="directive-dict.html#Syntax">문법:</a></th><td><code>CookieLog <var>filename</var></code></td></tr>
   267  <tr><th><a href="directive-dict.html#Context">사용장소:</a></th><td>주서버설정, 가상호스트</td></tr>
   268  <tr><th><a href="directive-dict.html#Status">상태:</a></th><td>Base</td></tr>
   269  <tr><th><a href="directive-dict.html#Module">모듈:</a></th><td>mod_log_config</td></tr>
   270  <tr><th><a href="directive-dict.html#Compatibility">지원:</a></th><td>이 지시어는 사용되지 않는다.</td></tr>
   271  </table>
   272      <p><code class="directive">CookieLog</code> 지시어는 쿠키를 로그에
   273      남기기위해 사용할 파일명을 설정한다. 파일명은 <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>에 상대경로이다. 이
   274      지시어는 <code>mod_cookies</code>와 호환을 위해 포함했을뿐,
   275      실제 사용되지 않는다.</p>
   276  
   277  </div>
   278  <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
   279  <div class="directive-section"><h2><a name="CustomLog" id="CustomLog">CustomLog</a> <a name="customlog" id="customlog">지시어</a></h2>
   280  <table class="directive">
   281  <tr><th><a href="directive-dict.html#Description">설명:</a></th><td>로그파일 이름과 형식을 지정한다</td></tr>
   282  <tr><th><a href="directive-dict.html#Syntax">문법:</a></th><td><code>CustomLog  <var>file</var>|<var>pipe</var>
   283  <var>format</var>|<var>nickname</var>
   284  [env=[!]<var>environment-variable</var>]</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  </table>
   289      <p>서버가 요청을 로그에 남길때 <code class="directive">CustomLog</code>
   290      지시어를 사용한다. 로그 형식을 지정하고, 환경변수를 사용하여
   291      요청의 특징에 따라 선택적으로 로그를 남길 수도 있다.</p>
   292  
   293      <p>로그를 기록할 장소를 지정하는 첫번째 아규먼트에는 다음
   294      둘중 하나를 사용한다.</p>
   295  
   296      <dl>
   297        <dt><var>file</var></dt>
   298        <dd><code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>에
   299        상대적인 파일명.</dd>
   300  
   301        <dt><var>pipe</var></dt>
   302        <dd>파이프문자 "<code>|</code>"뒤에 로그 정보를 표준입력으로
   303        받을 프로그램 경로를 적는다.
   304  
   305        <div class="warning"><h3>보안:</h3>
   306        <p>프로그램을 사용한다면 프로그램은 웹서버를 시작한 사용자
   307        권한으로 실행된다. 서버를 root로 시작한다면 프로그램도
   308        root로 실행하므로 프로그램이 안전한지 확인하라.</p>
   309        </div>
   310        <div class="warning"><h3>주의</h3>
   311          <p>유닉스가 아닌 플래폼에서 파일경로를 입력할때 플래폼이
   312          백슬래쉬를 사용하더라도 반드시 슬래쉬를 사용해야 한다.
   313          일반적으로 설정파일에서는 항상 슬래쉬를 사용하는 것이
   314          좋다.</p>
   315        </div></dd>
   316      </dl>
   317  
   318      <p>두번째 아규먼트는 로그파일에 기록할 내용을 지정한다.
   319      전에 <code class="directive"><a href="#logformat">LogFormat</a></code>으로
   320      정의한 <var>nickname</var>을 사용하거나 직접 <a href="#formats">로그 형식</a> 절에서 설명한 <var>format</var>
   321      문자열을 사용할 수 있다.</p>
   322  
   323      <p>예를 들어, 다음 두 지시어는 똑같은 일을 한다.</p>
   324  
   325      <div class="example"><p><code>
   326        # 형식 별칭을 사용한 CustomLog<br />
   327        LogFormat "%h %l %u %t \"%r\" %&gt;s %b" common<br />
   328        CustomLog logs/access_log common<br />
   329        <br />
   330        # 직접 형식 문자열을 사용한 CustomLog<br />
   331        CustomLog logs/access_log "%h %l %u %t \"%r\" %&gt;s %b"
   332      </code></p></div>
   333  
   334      <p>세번째 아규먼트는 없어도 되며, 특정 서버 환경변수 유무에
   335      따라 요청을 로그에 기록할지 여부를 결정한다. 요청에 지정한
   336      <a href="../env.html">환경변수</a>가 정의되있다면 (혹은
   337      '<code>env=!<var>name</var></code>'를 사용한 경우 없다면)
   338      요청을 로그에 기록한다.</p>
   339  
   340      <p><code class="module"><a href="../mod/mod_setenvif.html">mod_setenvif</a></code>나 <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>
   341      모듈을 사용하여 요청별로 환경변수를 설정할 수 있다. 예를
   342      들어, 서버가 GIF 그림에 대한 모든 요청을 주서버 로그가 아닌
   343      다른 로그파일에 기록하려면,</p>
   344      
   345      <div class="example"><p><code>
   346        SetEnvIf Request_URI \.gif$ gif-image<br />
   347        CustomLog gif-requests.log common env=gif-image<br />
   348        CustomLog nongif-requests.log common env=!gif-image
   349      </code></p></div>
   350  
   351  </div>
   352  <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
   353  <div class="directive-section"><h2><a name="LogFormat" id="LogFormat">LogFormat</a> <a name="logformat" id="logformat">지시어</a></h2>
   354  <table class="directive">
   355  <tr><th><a href="directive-dict.html#Description">설명:</a></th><td>로그파일에 사용할 형식을 기술한다</td></tr>
   356  <tr><th><a href="directive-dict.html#Syntax">문법:</a></th><td><code>LogFormat <var>format</var>|<var>nickname</var>
   357  [<var>nickname</var>]</code></td></tr>
   358  <tr><th><a href="directive-dict.html#Default">기본값:</a></th><td><code>LogFormat "%h %l %u %t \"%r\" %&gt;s %b"</code></td></tr>
   359  <tr><th><a href="directive-dict.html#Context">사용장소:</a></th><td>주서버설정, 가상호스트</td></tr>
   360  <tr><th><a href="directive-dict.html#Status">상태:</a></th><td>Base</td></tr>
   361  <tr><th><a href="directive-dict.html#Module">모듈:</a></th><td>mod_log_config</td></tr>
   362  </table>
   363      <p>이 지시어는 접근 로그파일의 형식을 지정한다.</p>
   364  
   365      <p><code class="directive">LogFormat</code> 지시어는 두가지 형식으로
   366      사용한다. 첫번째 형식은 아규먼트를 한개만 사용하여 다음
   367      <code class="directive">TransferLog</code> 지시어들이 사용할 로그
   368      형식을 지정한다. 이 아규먼트에 위의 <a href="#formats">로그
   369      형식 지정하기</a> 절에서 설명한 <var>format</var>을 직접
   370      사용하거나, 다음에 설명할 <code class="directive">LogFormat</code>
   371      지시어로 미리 정의한 (로그 형식을 지칭하는) <var>nickname</var>을
   372      사용할 수 있다.</p>
   373  
   374      <p><code class="directive">LogFormat</code> 지시어의 두번째 형식은
   375      <var>format</var>과 <var>nickname</var>을 연결한다. 그러면
   376      뒤에서 사용하는 <code class="directive">LogFormat</code>이나 <code class="directive"><a href="#customlog">CustomLog</a></code> 지시어에 반복해서
   377      형식 문자열을 모두 입력하는 대신 <var>nickname</var>을 사용할
   378      수 있다. 별칭을 정의하는 <code class="directive">LogFormat</code>
   379      지시어는 <strong>이 외에는 아무 기능을 하지 않는다</strong>.
   380      즉, 별칭<em>만</em>을 정의하며, 실제로 형식을 적용하거나
   381      형식을 기본값으로 만들지 않는다. 그러므로 다음에 나오는
   382      <code class="directive"><a href="#transferlog">TransferLog</a></code>
   383      지시어에 영향을 주지 않는다. 또,
   384      <code class="directive">LogFormat</code>은 별칭으로 다른 별칭을
   385      정의할 수 있다. 별칭 이름에는 퍼센트 기호(<code>%</code>)를
   386      사용할 수 없음을 주의하라.</p>
   387  
   388      <div class="example"><h3>예제</h3><p><code>
   389        LogFormat "%v %h %l %u %t \"%r\" %&gt;s %b" vhost_common
   390      </code></p></div>
   391  
   392  </div>
   393  <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
   394  <div class="directive-section"><h2><a name="TransferLog" id="TransferLog">TransferLog</a> <a name="transferlog" id="transferlog">지시어</a></h2>
   395  <table class="directive">
   396  <tr><th><a href="directive-dict.html#Description">설명:</a></th><td>로그파일 위치를 설정한다</td></tr>
   397  <tr><th><a href="directive-dict.html#Syntax">문법:</a></th><td><code>TransferLog <var>file</var>|<var>pipe</var></code></td></tr>
   398  <tr><th><a href="directive-dict.html#Context">사용장소:</a></th><td>주서버설정, 가상호스트</td></tr>
   399  <tr><th><a href="directive-dict.html#Status">상태:</a></th><td>Base</td></tr>
   400  <tr><th><a href="directive-dict.html#Module">모듈:</a></th><td>mod_log_config</td></tr>
   401  </table>
   402      <p>이 지시어는 <code class="directive"><a href="#customlog">CustomLog</a></code> 지시어와 아규먼트와
   403      기능이 비슷하지만, 로그 형식을 직접 지정하거나 요청을 조건에
   404      따라 로그에 남길 수 없다. 대신 가장 최근 사용한 (별칭을
   405      정의하지 않은) <code class="directive"><a href="#logformat">LogFormat</a></code> 지시어가 지정한
   406      로그 형식을 사용한다. 미리 형식을 지정하지 않았다면 Common
   407      Log Format을 사용한다.</p>
   408  
   409      <div class="example"><h3>예제</h3><p><code>
   410        LogFormat "%h %l %u %t \"%r\" %&gt;s %b \"%{Referer}i\" \"%{User-agent}i\""<br />
   411        TransferLog logs/access_log
   412      </code></p></div>
   413  
   414  </div>
   415  </div>
   416  <div class="bottomlang">
   417  <p><span>가능한 언어: </span><a href="../en/mod/mod_log_config.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
   418  <a href="../ja/mod/mod_log_config.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
   419  <a href="../ko/mod/mod_log_config.html" title="Korean">&nbsp;ko&nbsp;</a> |
   420  <a href="../tr/mod/mod_log_config.html" hreflang="tr" rel="alternate" title="T&#252;rk&#231;e">&nbsp;tr&nbsp;</a></p>
   421  </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">Comments</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>
   422  <script type="text/javascript"><!--//--><![CDATA[//><!--
   423  var comments_shortname = 'httpd';
   424  var comments_identifier = 'http://httpd.apache.org/docs/2.2/mod/mod_log_config.html';
   425  (function(w, d) {
   426      if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
   427          d.write('<div id="comments_thread"><\/div>');
   428          var s = d.createElement('script');
   429          s.type = 'text/javascript';
   430          s.async = true;
   431          s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
   432          (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
   433      }
   434      else { 
   435          d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
   436      }
   437  })(window, document);
   438  //--><!]]></script></div><div id="footer">
   439  <p class="apache">Copyright 2017 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
   440  <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[//><!--
   441  if (typeof(prettyPrint) !== 'undefined') {
   442      prettyPrint();
   443  }
   444  //--><!]]></script>
   445  </body></html>