mod_log_config.xml.ko revision 17ade6df5ec233536985eb1c130a906c725dd614
938c687542a2f620cc7e781ddba4f3911dc1320dyoshiki<?xml version="1.0" encoding="EUC-KR" ?>
d8a47f7a3f857a43664484552cf83bf170e4629dnd<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
938c687542a2f620cc7e781ddba4f3911dc1320dyoshiki<?xml-stylesheet type="text/xsl" href="/style/manual.ko.xsl"?>
d8a47f7a3f857a43664484552cf83bf170e4629dnd<!-- English Revision: 105989:1331035 (outdated) -->
938c687542a2f620cc7e781ddba4f3911dc1320dyoshiki
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd<!--
6fbd2e53c97ea6976d93e0ac521adabc55e0fb73nd Licensed to the Apache Software Foundation (ASF) under one or more
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd contributor license agreements. See the NOTICE file distributed with
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd this work for additional information regarding copyright ownership.
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd The ASF licenses this file to You under the Apache License, Version 2.0
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd (the "License"); you may not use this file except in compliance with
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd the License. You may obtain a copy of the License at
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd http://www.apache.org/licenses/LICENSE-2.0
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd Unless required by applicable law or agreed to in writing, software
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd distributed under the License is distributed on an "AS IS" BASIS,
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd See the License for the specific language governing permissions and
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd limitations under the License.
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd-->
7db9f691a00ead175b03335457ca296a33ddf31bnd
938c687542a2f620cc7e781ddba4f3911dc1320dyoshiki<modulesynopsis metafile="mod_log_config.xml.meta">
938c687542a2f620cc7e781ddba4f3911dc1320dyoshiki
938c687542a2f620cc7e781ddba4f3911dc1320dyoshiki<name>mod_log_config</name>
938c687542a2f620cc7e781ddba4f3911dc1320dyoshiki<description>�������� ��û�� �α׿� ����Ѵ�</description>
938c687542a2f620cc7e781ddba4f3911dc1320dyoshiki<status>Base</status>
938c687542a2f620cc7e781ddba4f3911dc1320dyoshiki<sourcefile>mod_log_config.c</sourcefile>
938c687542a2f620cc7e781ddba4f3911dc1320dyoshiki<identifier>log_config_module</identifier>
938c687542a2f620cc7e781ddba4f3911dc1320dyoshiki
07ab565873bfd241828a89261b1260c448a0799eyoshiki<summary>
07ab565873bfd241828a89261b1260c448a0799eyoshiki <p>�� ����� Ŭ���̾�Ʈ�� ��û�� �α׿� �����Ӱ� ����Ѵ�.
07ab565873bfd241828a89261b1260c448a0799eyoshiki �ڽ��� ���ϴ� ������� �α׸� ����� �� �ְ�, �����̳� �ܺ�
07ab565873bfd241828a89261b1260c448a0799eyoshiki ���α׷��� ���� �α׸� ���� ���� �ִ�. ������ �α׸� ����ϸ�
938c687542a2f620cc7e781ddba4f3911dc1320dyoshiki ��û�� ���ݿ� ��� ��û�� �α׿� �߰��ϰų� ������ �� �ִ�.</p>
<p>�� ����� ������ ���þ �����Ѵ�. <directive
module="mod_log_config">TransferLog</directive>�� �������
�����, <directive module="mod_log_config">LogFormat</directive>��
���ϴ� ����� ���ϰ�, <directive
module="mod_log_config">CustomLog</directive>�� �ѹ� �α����ϰ�
����� ��� �����Ѵ�. <directive>TransferLog</directive>��
<directive>CustomLog</directive> ���þ ������ ����ϸ�
��û�� ���� ���Ͽ� ����� �� �ִ�.</p>
</summary>
<seealso><a href="/logs.html">����ġ �α�����</a></seealso>
<section id="formats"><title>�α� ��� �����ϱ�</title>
<p><directive module="mod_log_config">LogFormat</directive>��
<directive module="mod_log_config">CustomLog</directive>
���þ��� ��� �ƱԸ�Ʈ�� ���ڿ��̴�. �� ���ڿ��� ��� ��û��
�α����Ͽ� ����Ѵ�. ���ڿ����� �α����Ͽ� �״�� ����Ǵ�
���ڿ� ��ٲް� ���� ��Ÿ���� C�� "\n"�� "\t" ����ڸ�
����� �� �ִ�. �α����Ͽ� ���ǥ�� �齽������ ������ �տ�
�ݵ�� �齽������ ������ �Ѵ�.</p>
<p>��û�� Ư¡�� ��� ���ڿ��� "<code>%</code>" ���þ
����Ͽ� ����Ѵ�. �� ���þ�� �α����Ͽ��� ������ ����
����ȴ�.</p>
<table border="1" style="zebra">
<columnspec><column width=".2"/><column width=".8"/></columnspec>
<tr><th>���&nbsp;���ڿ�</th>
<th>����</th></tr>
<tr><td><code>%%</code></td>
<td>�ۼ�Ʈ ��ȣ</td></tr>
<tr><td><code>%...a</code></td>
<td>��� IP-�ּ�</td></tr>
<tr><td><code>%...A</code></td>
<td>(����) IP-�ּ�</td></tr>
<tr><td><code>%...B</code></td>
<td>HTTP ����� ������ ��� ����Ʈ��.</td></tr>
<tr><td><code>%...b</code></td>
<td>HTTP ����� ������ ��� ����Ʈ��. CLF ��İ� ����
����� ������ ��� ��� 0 ��� '<code>-</code>'�� ���´�.</td></tr>
<tr><td><code>%...{<var>Foobar</var>}C</code></td>
<td>������ ������ ��û���� <var>Foobar</var> ��Ű��
����.</td></tr>
<tr><td><code>%...D</code></td>
<td>��û�� ó���ϴµ� �ɸ� �ð� (����ũ���� ����).</td></tr>
<tr><td><code>%...{<var>FOOBAR</var>}e</code></td>
<td>ȯ�溯�� <var>FOOBAR</var>�� ����</td></tr>
<tr><td><code>%...f</code></td>
<td>���ϸ�</td></tr>
<tr><td><code>%...h</code></td>
<td>��� ȣ��Ʈ</td></tr>
<tr><td><code>%...H</code></td>
<td>��û ��������</td></tr>
<tr><td><code>%...{<var>Foobar</var>}i</code></td>
<td>������ ������ ��û���� <code><var>Foobar</var>:</code>
����� ����.</td></tr>
<tr><td><code>%...l</code></td>
<td>(�ִٸ� identd�� ������) ��� �α��θ�.
<module>mod_ident</module>�� �ְ� <directive
module="mod_ident">IdentityCheck</directive>��
<code>On</code>�� �ƴϸ� �����ȣ�� ����Ѵ�.</td></tr>
<tr><td><code>%...m</code></td>
<td>��û �޽��</td></tr>
<tr><td><code>%...{<var>Foobar</var>}n</code></td>
<td>�ٸ� ����� ����� <var>Foobar</var> ��Ʈ(note)
����.</td></tr>
<tr><td><code>%...{<var>Foobar</var>}o</code></td>
<td>������ <code><var>Foobar</var>:</code> ��� ����.</td></tr>
<tr><td><code>%...p</code></td>
<td>��û�� �����ϴ� ������ ���� ��Ʈ</td></tr>
<tr><td><code>%...P</code></td>
<td>��û�� �����ϴ� �ڽ��� ���μ��� ID.</td></tr>
<tr><td><code>%...{<var>format</var>}P</code></td>
<td>��û�� �����ϴ� �ڽ��� ���μ��� ID Ȥ�� ������
ID. format���� <code>pid</code>�� <code>tid</code>��
�����ϴ�.
</td></tr>
<tr><td><code>%...q</code></td>
<td>���ǹ��ڿ� (���ǹ��ڿ��� �ִٸ� �տ� <code>?</code>��
���̰�, ��ٸ� �� ���ڿ�)</td></tr>
<tr><td><code>%...r</code></td>
<td>��û�� ù��° ��</td></tr>
<tr><td><code>%...s</code></td>
<td>����(status). ���� �����̷��ǵ� ��û�� ��� *��*
��û�� �����̴�. ���� ��û�� ���´� <code>%...&gt;s</code>.</td></tr>
<tr><td><code>%...t</code></td>
<td>common log format �ð� ���(ǥ�� ���� ���)�� �ð�</td></tr>
<tr><td><code>%...{<var>format</var>}t</code></td>
<td><code>strftime(3)</code> ��� format�� �ð�. (�����ð���
�� ����)</td></tr>
<tr><td><code>%...T</code></td>
<td>��û�� ó���ϴµ� �ɸ� �ð� (�� ����).</td></tr>
<tr><td><code>%...u</code></td>
<td>��� ����� (auth�� �����ϸ�, ����(<code>%s</code>)��
401�� ��� �̻��� ���� ���� �� ����)</td></tr>
<tr><td><code>%...U</code></td>
<td>���ǹ��ڿ��� ������ ��û URL ���.</td></tr>
<tr><td><code>%...v</code></td>
<td>��û�� ������ ������ ���� <directive
module="core">ServerName</directive>.</td></tr>
<tr><td><code>%...V</code></td>
<td><directive module="core">UseCanonicalName</directive>
������ �� ������.</td></tr>
<tr><td><code>%...X</code></td>
<td>������ �������� ���� ����.
<table>
<columnspec><column width=".2"/><column width=".6"/></columnspec>
<tr><td><code>X</code> =</td>
<td>������ ��ġ�� �� ������ ��������.</td></tr>
<tr><td><code>+</code> =</td>
<td>������ �����Ŀ��� ������ ����ִ�(keep alive).</td></tr>
<tr><td><code>-</code> = </td>
<td>������ ������ ������ ��������.</td></tr>
</table>
<p>(����ġ 1.3 �Ĺ� ���� �� ���þ��
<code>%...c</code>������, �������� ssl
<code>%...{<var>var</var>}c</code> ����� ���ļ�
�����ߴ�.)</p></td></tr>
<tr><td><code>%...I</code></td>
<td>��û�� ����� ������ ���� ����Ʈ���� 0�� �� ���.
�̸� ����Ϸ��� <module>mod_logio</module>�� �ʿ��ϴ�.</td></tr>
<tr><td><code>%...O</code></td>
<td>����� ������ �۽� ����Ʈ���� 0�� �� ���. �̸�
����Ϸ��� <module>mod_logio</module>�� �ʿ��ϴ�.</td></tr>
</table>
<p>"<var>...</var>"���� (<em>���� ���</em>,
<code>"%h %u %r %s %b"</code>) �ƹ��͵� ��ų�, �׸��� ������
������ ���´� (������ �������� ������ �ڸ��� "-"�� ����Ѵ�).
������ �տ� "!"�� ���̰ų� �Ⱥ��� HTTP �����ڵ� �������
�ۼ��Ѵ�. ���� ���, "%400,501{User-agent}i"�� 400 (Bad
Request) ����� 501 (Not Implemented) �����϶���
<code>User-agent:</code>�� �α׿� �����,
"%!200,304,302{Referer}i"�� �������� ���°� <em>�ƴ�</em>
��� ��û�� ���� <code>Referer:</code>�� �α׿� �����.</p>
<p>������ "&lt;"�� "&gt;"�� ���� �����̷��ǵ� ��û���� ����
ó�� ��û�� ������ ������ ��û�� ������ �����Ѵ�. �⺻������
<code>%s, %U, %T, %D, %r</code>�� ó�� ��û�� ����, ������
<code>%</code> ���þ�� ������ ��û�� ����. �׷���
<code>%&gt;s</code>�� ��û�� ������ ����(status)�� ����ϰ�,
<code>%&lt;u</code>�� �������� ��ȣ���� �ʴ� �ڿ����� ����
����̷��ǵ� ��쿡�� ó���� ������ ����ڸ� ����Ѵ�.</p>
<p>2.0.46 ������ httpd 2.0 ������ <code>%...r</code>,
<code>%...i</code>, <code>%...o</code>�� ��� ���ڿ��� �״��
�ξ��. ������ Common Log Format�� �䱸������ ������ؼ�����.
��, Ŭ���̾�Ʈ�� ����ڸ� �α׿� ������ �� �ֱ⶧����
�α������� �״�� �ٷ� ���� �����ؾ� �Ѵ�.</p>
<p>���Ȼ� ������ 2.0.46���� ����� �� ��� ���ڳ� �ٸ� Ư�����ڸ�
<code>\x<var>hh</var></code>�� ǥ���Ѵ�. ���⼭ <var>hh</var>��
�ش� ����Ʈ�� 16��� ǥ���� ��Ÿ����. �� ��Ģ�� ���ܴ� �齽������
�տ� ���̴� <code>"</code>�� <code>\</code>, �׸��� C���
����� ��鹮�ڵ�(<code>\n</code>, <code>\t</code> ��)�̴�.</p>
<p>�Ϲ������� ���� ����ϴ� �α� ����� ������ ����.</p>
<dl>
<dt>Common Log Format (CLF)</dt>
<dd><code>"%h %l %u %t \"%r\" %&gt;s %b"</code></dd>
<dt>����ȣ��Ʈ ������ ������ Common Log Format</dt>
<dd><code>"%v %h %l %u %t \"%r\" %&gt;s %b"</code></dd>
<dt>NCSA extended/combined �α� ���</dt>
<dd><code>"%h %l %u %t \"%r\" %&gt;s %b \"%{Referer}i\"
\"%{User-agent}i\""</code></dd>
<dt>Referer �α� ���</dt>
<dd><code>"%{Referer}i -&gt; %U"</code></dd>
<dt>Agent (������) �α� ���</dt>
<dd><code>"%{User-agent}i"</code></dd>
</dl>
<p>��û�� �����ϴ� ������ ���� <directive
module="core">ServerName</directive>�� <directive
module="mpm_common">Listen</directive>�� ���� <code>%v</code>��
<code>%p</code>�� ����Ѵ�. �α׺м� ���α׷��� ������ ��û��
�����ϴ� ȣ��Ʈ�� �˱����� ����ȣ��Ʈ ã�� �˰?����
���� �ʿ��� �̵� ���� <directive
module="core">UseCanonicalName</directive> ������ �����ϴ�.</p>
</section>
<section id="security"><title>���Ȼ� ����� ��</title>
<p>������ �����ϴ� ����ڿܿ� �ٸ� ����ڰ� �α������� �����ϴ�
���丮�� ���� ������ ���� �� ���ȿ� ������ ������
<a href="/misc/security_tips.html#serverroot">���� ��</a>
������ ����϶�.</p>
</section>
<directivesynopsis>
<name>BufferedLogs</name>
<description>Buffer log entries in memory before writing to disk</description>
<contextlist><context>server config</context></contextlist>
<usage><p>Documentation not yet translated. Please see English version of document.</p></usage>
</directivesynopsis>
<directivesynopsis>
<name>CustomLog</name>
<description>�α����� �̸��� ����� �����Ѵ�</description>
<syntax>CustomLog <var>file</var>|<var>pipe</var>
<var>format</var>|<var>nickname</var>
[env=[!]<var>environment-variable</var>]</syntax>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
<p>������ ��û�� �α׿� ���涧 <directive>CustomLog</directive>
���þ ����Ѵ�. �α� ����� �����ϰ�, ȯ�溯���� ����Ͽ�
��û�� Ư¡�� ��� ���������� �α׸� ���� ���� �ִ�.</p>
<p>�α׸� ����� ��Ҹ� �����ϴ� ù��° �ƱԸ�Ʈ���� ����
���� �ϳ��� ����Ѵ�.</p>
<dl>
<dt><var>file</var></dt>
<dd><directive module="core">ServerRoot</directive>��
������� ���ϸ�.</dd>
<dt><var>pipe</var></dt>
<dd>���������� "<code>|</code>"�ڿ� �α� ������ ǥ���Է�����
���� ���α׷� ��θ� ��´�.
<note type="warning"><title>����:</title>
<p>���α׷��� ����Ѵٸ� ���α׷��� �������� ������ �����
�������� ����ȴ�. ������ root�� �����Ѵٸ� ���α׷���
root�� �����ϹǷ� ���α׷��� �������� Ȯ���϶�.</p>
</note>
<note type="warning"><title>����</title>
<p>���н��� �ƴ� �÷��� ���ϰ�θ� �Է��Ҷ� �÷�����
�齽������ ����ϴ��� �ݵ�� �������� ����ؾ� �Ѵ�.
�Ϲ������� �������Ͽ����� �׻� �������� ����ϴ� ����
����.</p>
</note></dd>
</dl>
<p>�ι�° �ƱԸ�Ʈ�� �α����Ͽ� ����� ������ �����Ѵ�.
�� <directive module="mod_log_config">LogFormat</directive>����
������ <var>nickname</var>�� ����ϰų� ���� <a
href="#formats">�α� ���</a> �� ������ <var>format</var>
���ڿ��� ����� �� �ִ�.</p>
<p>���� ���, ���� �� ���þ�� �Ȱ��� ���� �Ѵ�.</p>
<example>
# ��� ��Ī�� ����� CustomLog<br />
LogFormat "%h %l %u %t \"%r\" %&gt;s %b" common<br />
CustomLog logs/access_log common<br />
<br />
# ���� ��� ���ڿ��� ����� CustomLog<br />
CustomLog logs/access_log "%h %l %u %t \"%r\" %&gt;s %b"
</example>
<p>����° �ƱԸ�Ʈ�� �� �Ǹ�, Ư�� ���� ȯ�溯�� ������
��� ��û�� �α׿� ������� ���θ� �����Ѵ�. ��û�� ������
<a href="/env.html">ȯ�溯��</a>�� ���ǵ��ִٸ� (Ȥ��
'<code>env=!<var>name</var></code>'�� ����� ��� ��ٸ�)
��û�� �α׿� ����Ѵ�.</p>
<p><module>mod_setenvif</module>�� <module>mod_rewrite</module>
����� ����Ͽ� ��û���� ȯ�溯���� ������ �� �ִ�. ����
���, ������ GIF �׸��� ���� ��� ��û�� �ּ��� �αװ� �ƴ�
�ٸ� �α����Ͽ� ����Ϸ���,</p>
<example>
SetEnvIf Request_URI \.gif$ gif-image<br />
CustomLog gif-requests.log common env=gif-image<br />
CustomLog nongif-requests.log common env=!gif-image
</example>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>LogFormat</name>
<description>�α����Ͽ� ����� ����� ����Ѵ�</description>
<syntax>LogFormat <var>format</var>|<var>nickname</var>
[<var>nickname</var>]</syntax>
<default>LogFormat "%h %l %u %t \"%r\" %>s %b"</default>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
<p>�� ���þ�� ���� �α������� ����� �����Ѵ�.</p>
<p><directive>LogFormat</directive> ���þ�� �ΰ��� �������
����Ѵ�. ù��° ����� �ƱԸ�Ʈ�� �Ѱ��� ����Ͽ� ����
<directive>TransferLog</directive> ���þ���� ����� �α�
����� �����Ѵ�. �� �ƱԸ�Ʈ�� ���� <a href="#formats">�α�
��� �����ϱ�</a> �� ������ <var>format</var>�� ����
����ϰų�, ������ ������ <directive>LogFormat</directive>
���þ�� �̸� ������ (�α� ����� ��Ī�ϴ�) <var>nickname</var>��
����� �� �ִ�.</p>
<p><directive>LogFormat</directive> ���þ��� �ι�° �����
<var>format</var>�� <var>nickname</var>�� �����Ѵ�. �׷���
�ڿ��� ����ϴ� <directive>LogFormat</directive>�̳� <directive
module="mod_log_config">CustomLog</directive> ���þ �ݺ��ؼ�
��� ���ڿ��� ��� �Է��ϴ� ��� <var>nickname</var>�� �����
�� �ִ�. ��Ī�� �����ϴ� <directive>LogFormat</directive>
���þ�� <strong>�� �ܿ��� �ƹ� ����� ���� �ʴ´�</strong>.
��, ��Ī<em>��</em>�� �����ϸ�, ������ ����� ����ϰų�
����� �⺻������ ������ �ʴ´�. �׷��Ƿ� ������ ������
<directive module="mod_log_config">TransferLog</directive>
���þ ������ ���� �ʴ´�. ��,
<directive>LogFormat</directive>�� ��Ī���� �ٸ� ��Ī��
������ �� �ִ�. ��Ī �̸����� �ۼ�Ʈ ��ȣ(<code>%</code>)��
����� �� ������ �����϶�.</p>
<example><title>����</title>
LogFormat "%v %h %l %u %t \"%r\" %&gt;s %b" vhost_common
</example>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>TransferLog</name>
<description>�α����� ��ġ�� �����Ѵ�</description>
<syntax>TransferLog <var>file</var>|<var>pipe</var></syntax>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
<p>�� ���þ�� <directive
module="mod_log_config">CustomLog</directive> ���þ�� �ƱԸ�Ʈ��
����� ���������, �α� ����� ���� �����ϰų� ��û�� ���ǿ�
��� �α׿� ���� �� ���. ��� ���� �ֱ� ����� (��Ī��
�������� ����) <directive
module="mod_log_config">LogFormat</directive> ���þ ������
�α� ����� ����Ѵ�. �̸� ����� �������� �ʾҴٸ� Common
Log Format�� ����Ѵ�.</p>
<example><title>����</title>
LogFormat "%h %l %u %t \"%r\" %&gt;s %b \"%{Referer}i\" \"%{User-agent}i\""<br />
TransferLog logs/access_log
</example>
</usage>
</directivesynopsis>
</modulesynopsis>