diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-27 06:33:50 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-27 06:33:50 +0000 |
commit | fe39ffb8b90ae4e002ed73fe98617cd590abb467 (patch) | |
tree | b80e5956907d8aeaaffe4e4f0c068c0e6157ce8b /docs/manual/mod/mod_log_config.html | |
parent | Initial commit. (diff) | |
download | apache2-fe39ffb8b90ae4e002ed73fe98617cd590abb467.tar.xz apache2-fe39ffb8b90ae4e002ed73fe98617cd590abb467.zip |
Adding upstream version 2.4.56.upstream/2.4.56upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to '')
-rw-r--r-- | docs/manual/mod/mod_log_config.html | 21 | ||||
-rw-r--r-- | docs/manual/mod/mod_log_config.html.en | 606 | ||||
-rw-r--r-- | docs/manual/mod/mod_log_config.html.fr.utf8 | 645 | ||||
-rw-r--r-- | docs/manual/mod/mod_log_config.html.ja.utf8 | 510 | ||||
-rw-r--r-- | docs/manual/mod/mod_log_config.html.ko.euc-kr | 441 | ||||
-rw-r--r-- | docs/manual/mod/mod_log_config.html.tr.utf8 | 586 |
6 files changed, 2809 insertions, 0 deletions
diff --git a/docs/manual/mod/mod_log_config.html b/docs/manual/mod/mod_log_config.html new file mode 100644 index 0000000..98ae674 --- /dev/null +++ b/docs/manual/mod/mod_log_config.html @@ -0,0 +1,21 @@ +# GENERATED FROM XML -- DO NOT EDIT + +URI: mod_log_config.html.en +Content-Language: en +Content-type: text/html; charset=UTF-8 + +URI: mod_log_config.html.fr.utf8 +Content-Language: fr +Content-type: text/html; charset=UTF-8 + +URI: mod_log_config.html.ja.utf8 +Content-Language: ja +Content-type: text/html; charset=UTF-8 + +URI: mod_log_config.html.ko.euc-kr +Content-Language: ko +Content-type: text/html; charset=EUC-KR + +URI: mod_log_config.html.tr.utf8 +Content-Language: tr +Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_log_config.html.en b/docs/manual/mod/mod_log_config.html.en new file mode 100644 index 0000000..e0ac24c --- /dev/null +++ b/docs/manual/mod/mod_log_config.html.en @@ -0,0 +1,606 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> +<!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>mod_log_config - Apache HTTP Server Version 2.4</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<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" /> +<script src="../style/scripts/prettify.min.js" type="text/javascript"> +</script> + +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body> +<div id="page-header"> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p> +<p class="apache">Apache HTTP Server Version 2.4</p> +<img alt="" src="../images/feather.png" /></div> +<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Apache Module mod_log_config</h1> +<div class="toplang"> +<p><span>Available Languages: </span><a href="../en/mod/mod_log_config.html" title="English"> en </a> | +<a href="../fr/mod/mod_log_config.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | +<a href="../ja/mod/mod_log_config.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_log_config.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | +<a href="../tr/mod/mod_log_config.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> +</div> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Logging of the requests made to the server</td></tr> +<tr><th><a href="module-dict.html#Status">Status:</a></th><td>Base</td></tr> +<tr><th><a href="module-dict.html#ModuleIdentifier">Module Identifier:</a></th><td>log_config_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Source File:</a></th><td>mod_log_config.c</td></tr></table> +<h3>Summary</h3> + + <p>This module provides for flexible logging of client + requests. Logs are written in a customizable format, and may be + written directly to a file, or to an external program. + Conditional logging is provided so that individual requests may + be included or excluded from the logs based on characteristics + of the request.</p> + + <p>Three directives are provided by this module: + <code class="directive"><a href="#transferlog">TransferLog</a></code> to create + a log file, <code class="directive"><a href="#logformat">LogFormat</a></code> + to set a custom format, and <code class="directive"><a href="#customlog">CustomLog</a></code> to define a log file and format in one + step. The <code class="directive">TransferLog</code> and <code class="directive">CustomLog</code> directives can be used multiple times in each + server to cause each request to be logged to multiple files.</p> +</div> +<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><h3>Topics</h3> +<ul id="topics"> +<li><img alt="" src="../images/down.gif" /> <a href="#formats">Custom Log Formats</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#security">Security Considerations</a></li> +</ul><h3 class="directives">Directives</h3> +<ul id="toc"> +<li><img alt="" src="../images/down.gif" /> <a href="#bufferedlogs">BufferedLogs</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#customlog">CustomLog</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#globallog">GlobalLog</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#logformat">LogFormat</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#transferlog">TransferLog</a></li> +</ul> +<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>See also</h3> +<ul class="seealso"> +<li><a href="../logs.html">Apache Log Files</a></li> +<li><a href="#comments_section">Comments</a></li></ul></div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="formats" id="formats">Custom Log Formats</a></h2> + + <p>The format argument to the <code class="directive"><a href="#logformat">LogFormat</a></code> and <code class="directive"><a href="#customlog">CustomLog</a></code> directives is a string. This string is + used to log each request to the log file. It can contain literal + characters copied into the log files and the C-style control + characters "\n" and "\t" to represent new-lines and tabs. + Literal quotes and backslashes should be escaped with + backslashes.</p> + + <p>The characteristics of the request itself are logged by + placing "<code>%</code>" directives in the format string, which are + replaced in the log file by the values as follows:</p> + + <table class="bordered"><tr class="header"><th>Format String</th> + <th>Description</th></tr> +<tr><td><code>%%</code></td> + <td>The percent sign.</td></tr> +<tr class="odd"><td><code>%a</code></td> + <td>Client IP address of the request (see the + <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code> module).</td></tr> +<tr><td><code>%{c}a</code></td> + <td>Underlying peer IP address of the connection (see the + <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code> module).</td></tr> +<tr class="odd"><td><code>%A</code></td> + <td>Local IP-address.</td></tr> +<tr><td><code>%B</code></td> + <td>Size of response in bytes, excluding HTTP headers.</td></tr> +<tr class="odd"><td><code>%b</code></td> + <td>Size of response in bytes, excluding HTTP headers. In CLF format, <em>i.e.</em> + a '<code>-</code>' rather than a 0 when no bytes are sent.</td></tr> +<tr><td><code>%{<var>VARNAME</var>}C</code></td> + <td>The contents of cookie <var>VARNAME</var> in the request sent + to the server. Only version 0 cookies are fully supported.</td></tr> +<tr class="odd"><td><code>%D</code></td> + <td>The time taken to serve the request, in microseconds.</td></tr> +<tr><td><code>%{<var>VARNAME</var>}e</code></td> + <td>The contents of the environment variable + <var>VARNAME</var>.</td></tr> +<tr class="odd"><td><code>%f</code></td> + <td>Filename.</td></tr> +<tr><td><code>%h</code></td> + <td>Remote hostname. Will log the IP address if <code class="directive"><a href="../mod/core.html#hostnamelookups">HostnameLookups</a></code> is set to + <code>Off</code>, which is the default. If it logs the hostname + for only a few hosts, you probably have access control + directives mentioning them by name. See <a href="mod_authz_host.html#reqhost">the Require host + documentation</a>.</td></tr> +<tr class="odd"><td><code>%{c}h</code></td> + <td>Like <code>%h</code>, but always reports on the hostname of the + underlying TCP connection and not any modifications to the + remote hostname by modules like <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code>.</td></tr> +<tr><td><code>%H</code></td> + <td>The request protocol.</td></tr> +<tr class="odd"><td><code>%{<var>VARNAME</var>}i</code></td> + <td>The contents of <code><var>VARNAME</var>:</code> header line(s) + in the request sent to the server. Changes made by other + modules (e.g. <code class="module"><a href="../mod/mod_headers.html">mod_headers</a></code>) affect this. If you're + interested in what the request header was prior to when most + modules would have modified it, use <code class="module"><a href="../mod/mod_setenvif.html">mod_setenvif</a></code> + to copy the header into an internal environment variable and log + that value with the <code>%{<var>VARNAME</var>}e</code> described + above. + </td></tr> +<tr><td><code>%k</code></td> + <td>Number of keepalive requests handled on this connection. Interesting if + <code class="directive"><a href="../mod/core.html#keepalive">KeepAlive</a></code> is being used, so that, + for example, a '1' means the first keepalive request after the initial + one, '2' the second, etc...; + otherwise this is always 0 (indicating the initial request).</td></tr> +<tr class="odd"><td><code>%l</code></td> + <td>Remote logname (from identd, if supplied). This will return a + dash unless <code class="module"><a href="../mod/mod_ident.html">mod_ident</a></code> is present and <code class="directive"><a href="../mod/mod_ident.html#identitycheck">IdentityCheck</a></code> is set + <code>On</code>.</td></tr> +<tr><td><code>%L</code></td> + <td>The request log ID from the error log (or '-' if nothing has been + logged to the error log for this request). Look for the + matching error log line to see what request caused what error.</td></tr> +<tr class="odd"><td><code>%m</code></td> + <td>The request method.</td></tr> +<tr><td><code>%{<var>VARNAME</var>}n</code></td> + <td>The contents of note <var>VARNAME</var> from another + module.</td></tr> +<tr class="odd"><td><code>%{<var>VARNAME</var>}o</code></td> + <td>The contents of <code><var>VARNAME</var>:</code> header line(s) + in the reply.</td></tr> +<tr><td><code>%p</code></td> + <td>The canonical port of the server serving the request.</td></tr> +<tr class="odd"><td><code>%{<var>format</var>}p</code></td> + <td>The canonical port of the server serving the request, or the + server's actual port, or the client's actual port. Valid formats + are <code>canonical</code>, <code>local</code>, or <code>remote</code>. + </td></tr> +<tr><td><code>%P</code></td> + <td>The process ID of the child that serviced the request.</td></tr> +<tr class="odd"><td><code>%{<var>format</var>}P</code></td> + <td>The process ID or thread ID of the child that serviced the + request. Valid formats are <code>pid</code>, <code>tid</code>, + and <code>hextid</code>. + </td></tr> +<tr><td><code>%q</code></td> + <td>The query string (prepended with a <code>?</code> if a query + string exists, otherwise an empty string).</td></tr> +<tr class="odd"><td><code>%r</code></td> + <td>First line of request.</td></tr> +<tr><td><code>%R</code></td> + <td>The handler generating the response (if any).</td></tr> +<tr class="odd"><td><code>%s</code></td> + <td>Status. For requests that have been internally redirected, this is + the status of the <em>original</em> request. Use <code>%>s</code> + for the final status.</td></tr> +<tr><td><code>%t</code></td> + <td>Time the request was received, in the format <code>[18/Sep/2011:19:18:28 -0400]</code>. + The last number indicates the timezone offset from GMT</td></tr> +<tr class="odd"><td><code>%{<var>format</var>}t</code></td> + <td>The time, in the form given by format, which should be in + an extended <code>strftime(3)</code> format (potentially localized). + If the format starts with <code>begin:</code> (default) the time is taken + at the beginning of the request processing. If it starts with + <code>end:</code> it is the time when the log entry gets written, + close to the end of the request processing. In addition to the formats + supported by <code>strftime(3)</code>, the following format tokens are + supported: + <table> + <tr><td><code>sec</code></td><td>number of seconds since the Epoch</td></tr> + <tr><td><code>msec</code></td><td>number of milliseconds since the Epoch</td></tr> + <tr><td><code>usec</code></td><td>number of microseconds since the Epoch</td></tr> + <tr><td><code>msec_frac</code></td><td>millisecond fraction</td></tr> + <tr><td><code>usec_frac</code></td><td>microsecond fraction</td></tr> + </table> + These tokens can not be combined with each other or <code>strftime(3)</code> + formatting in the same format string. You can use multiple + <code>%{<var>format</var>}t</code> tokens instead. + </td></tr> +<tr><td><code>%T</code></td> + <td>The time taken to serve the request, in seconds.</td></tr> +<tr class="odd"><td><code>%{<var>UNIT</var>}T</code></td> + <td>The time taken to serve the request, in a time unit given by + <code>UNIT</code>. Valid units are <code>ms</code> for milliseconds, + <code>us</code> for microseconds, and <code>s</code> for seconds. + Using <code>s</code> gives the same result as <code>%T</code> + without any format; using <code>us</code> gives the same result + as <code>%D</code>. Combining <code>%T</code> with a unit is + available in 2.4.13 and later.</td></tr> +<tr><td><code>%u</code></td> + <td>Remote user if the request was authenticated. May be bogus if return status + (<code>%s</code>) is 401 (unauthorized).</td></tr> +<tr class="odd"><td><code>%U</code></td> + <td>The URL path requested, not including any query string.</td></tr> +<tr><td><code>%v</code></td> + <td>The canonical <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> + of the server serving the request.</td></tr> +<tr class="odd"><td><code>%V</code></td> + <td>The server name according to the <code class="directive"><a href="../mod/core.html#usecanonicalname">UseCanonicalName</a></code> setting.</td></tr> +<tr><td><code>%X</code></td> + <td>Connection status when response is completed: + + <table> + + <tr><td><code>X</code> =</td> + <td>Connection aborted before the response completed.</td></tr> + <tr><td><code>+</code> =</td> + <td>Connection may be kept alive after the response is + sent.</td></tr> + <tr><td><code>-</code> = </td> + <td>Connection will be closed after the response is + sent.</td></tr> + </table> + + </td></tr> +<tr class="odd"><td><code>%I</code></td> + <td>Bytes received, including request and headers. Cannot be zero. + You need to enable <code class="module"><a href="../mod/mod_logio.html">mod_logio</a></code> to use this.</td></tr> +<tr><td><code>%O</code></td> + <td>Bytes sent, including headers. May be zero in rare cases + such as when a request is aborted before a response is sent. + You need to enable <code class="module"><a href="../mod/mod_logio.html">mod_logio</a></code> to use this.</td></tr> +<tr class="odd"><td><code>%S</code></td> + <td>Bytes transferred (received and sent), including request and headers, + cannot be zero. This is the combination of %I and %O. You need to + enable <code class="module"><a href="../mod/mod_logio.html">mod_logio</a></code> to use this.</td></tr> +<tr><td><code>%{<var>VARNAME</var>}^ti</code></td> + <td>The contents of <code><var>VARNAME</var>:</code> trailer line(s) + in the request sent to the server. </td></tr> +<tr class="odd"><td><code>%{<var>VARNAME</var>}^to</code></td> + <td>The contents of <code><var>VARNAME</var>:</code> trailer line(s) + in the response sent from the server. </td></tr> +</table> + + <h3><a name="modifiers" id="modifiers">Modifiers</a></h3> + + <p>Particular items can be restricted to print only for + responses with specific HTTP status codes by placing a + comma-separated list of status codes immediately following the + "%". The status code list may be preceded by a "<code>!</code>" to + indicate negation.</p> + + <table class="bordered"><tr class="header"><th>Format String</th> + <th>Meaning</th></tr> +<tr> + <td><code>%400,501{User-agent}i</code></td> + <td>Logs <code>User-agent</code> on 400 errors and 501 errors only. For + other status codes, the literal string <code>"-"</code> will be + logged.</td></tr> +<tr class="odd"><td><code>%!200,304,302{Referer}i</code></td> + <td>Logs <code>Referer</code> on all requests that do + <em>not</em> return one of the three specified codes, + "<code>-</code>" otherwise. + </td></tr> +</table> + + <p>The modifiers "<" and ">" can be used for requests that + have been internally redirected to choose whether the original + or final (respectively) request should be consulted. By + default, the <code>%</code> directives <code>%s, %U, %T, + %D,</code> and <code>%r</code> look at the original request + while all others look at the final request. So for example, + <code>%>s</code> can be used to record the final status of + the request and <code>%<u</code> can be used to record the + original authenticated user on a request that is internally + redirected to an unauthenticated resource.</p> + + + + <h3><a name="format-notes" id="format-notes">Format Notes</a></h3> + + <p>For security reasons, starting with version 2.0.46, + non-printable and other special characters in <code>%r</code>, + <code>%i</code> and <code>%o</code> are escaped using + <code>\x<var>hh</var></code> sequences, where <var>hh</var> + stands for the hexadecimal representation of the raw + byte. Exceptions from this rule are <code>"</code> and + <code>\</code>, which are escaped by prepending a backslash, and + all whitespace characters, which are written in their C-style + notation (<code>\n</code>, <code>\t</code>, etc). In versions + prior to 2.0.46, no escaping was performed on these strings so + you had to be quite careful when dealing with raw log files.</p> + + <p>Since httpd 2.0, unlike 1.3, the <code>%b</code> and + <code>%B</code> format strings do not represent the number of + bytes sent to the client, but simply the size in bytes of the + HTTP response (which will differ, for instance, if the + connection is aborted, or if SSL is used). The <code>%O</code> + format provided by <code class="module"><a href="../mod/mod_logio.html">mod_logio</a></code> will log the + actual number of bytes sent over the network.</p> + + <div class="note"> + <p>Note: <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> is implemented as a + quick-handler and not as a standard handler. Therefore, the + <code>%R</code> format string will not return any handler + information when content caching is involved.</p> + </div> + + + + <h3><a name="examples" id="examples">Examples</a></h3> + + <p>Some commonly used log format strings are:</p> + + <dl> + <dt>Common Log Format (CLF)</dt> + <dd><code>"%h %l %u %t \"%r\" %>s %b"</code></dd> + + <dt>Common Log Format with Virtual Host</dt> + <dd><code>"%v %h %l %u %t \"%r\" %>s %b"</code></dd> + + <dt>NCSA extended/combined log format</dt> + <dd><code>"%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" + \"%{User-agent}i\""</code></dd> + + <dt>Referer log format</dt> + <dd><code>"%{Referer}i -> %U"</code></dd> + + <dt>Agent (Browser) log format</dt> + <dd><code>"%{User-agent}i"</code></dd> + </dl> + + <p>You can use the <code>%{format}t</code> directive multiple + times to build up a time format using the extended format tokens + like <code>msec_frac</code>:</p> + <dl> +<dt>Timestamp including milliseconds</dt> +<dd><code>"%{%d/%b/%Y %T}t.%{msec_frac}t %{%z}t"</code></dd> + + </dl> + + +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="security" id="security">Security Considerations</a></h2> + <p>See the <a href="../misc/security_tips.html#serverroot">security tips</a> + document for details on why your security could be compromised + if the directory where logfiles are stored is writable by + anyone other than the user that starts the server.</p> +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="BufferedLogs" id="BufferedLogs">BufferedLogs</a> <a name="bufferedlogs" id="bufferedlogs">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Buffer log entries in memory before writing to disk</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>BufferedLogs On|Off</code></td></tr> +<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>BufferedLogs Off</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr> +<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_log_config</td></tr> +</table> + <p>The <code class="directive">BufferedLogs</code> directive causes + <code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code> to store several log entries in + memory and write them together to disk, rather than writing them + after each request. On some systems, this may result in more + efficient disk access and hence higher performance. It may be + set only once for the entire server; it cannot be configured + per virtual-host.</p> + + <div class="note">This directive should be used with caution as a crash might + cause loss of logging data.</div> + +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="CustomLog" id="CustomLog">CustomLog</a> <a name="customlog" id="customlog">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets filename and format of log file</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>CustomLog <var>file</var>|<var>pipe</var> +<var>format</var>|<var>nickname</var> +[env=[!]<var>environment-variable</var>| +expr=<var>expression</var>]</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr> +<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_log_config</td></tr> +</table> + <p>The <code class="directive">CustomLog</code> directive is used to + log requests to the server. A log format is specified, and the + logging can optionally be made conditional on request + characteristics using environment variables.</p> + + <p>The first argument, which specifies the location to which + the logs will be written, can take one of the following two + types of values:</p> + + <dl> + <dt><var>file</var></dt> + <dd>A filename, relative to the <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>.</dd> + + <dt><var>pipe</var></dt> + <dd>The pipe character "<code>|</code>", followed by the path + to a program to receive the log information on its standard + input. See the notes on <a href="../logs.html#piped">piped logs</a> + for more information. + + <div class="warning"><h3>Security:</h3> + <p>If a program is used, then it will be run as the user who + started <code class="program"><a href="../programs/httpd.html">httpd</a></code>. This will be root if the server was + started by root; be sure that the program is secure.</p> + </div> + <div class="warning"><h3>Note</h3> + <p>When entering a file path on non-Unix platforms, care should be taken + to make sure that only forward slashed are used even though the platform + may allow the use of back slashes. In general it is a good idea to always + use forward slashes throughout the configuration files.</p> + </div></dd> + </dl> + + <p>The second argument specifies what will be written to the + log file. It can specify either a <var>nickname</var> defined by + a previous <code class="directive"><a href="#logformat">LogFormat</a></code> + directive, or it can be an explicit <var>format</var> string as + described in the <a href="#formats">log formats</a> section.</p> + + <p>For example, the following two sets of directives have + exactly the same effect:</p> + + <pre class="prettyprint lang-config"># CustomLog with format nickname +LogFormat "%h %l %u %t \"%r\" %>s %b" common +CustomLog "logs/access_log" common + +# CustomLog with explicit format string +CustomLog "logs/access_log" "%h %l %u %t \"%r\" %>s %b"</pre> + + + <p>The third argument is optional and controls whether or + not to log a particular request. The condition can be the + presence or absence (in the case of a '<code>env=!<var>name</var></code>' + clause) of a particular variable in the server + <a href="../env.html">environment</a>. Alternatively, the condition + can be expressed as arbitrary boolean <a href="../expr.html">expression</a>. If the condition is not satisfied, the request + will not be logged. References to HTTP headers in the expression + will not cause the header names to be added to the Vary header.</p> + + <p>Environment variables can be set on a per-request + basis using the <code class="module"><a href="../mod/mod_setenvif.html">mod_setenvif</a></code> + and/or <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> modules. For + example, if you want to record requests for all GIF + images on your server in a separate logfile but not in your main + log, you can use:</p> + + <pre class="prettyprint lang-config">SetEnvIf Request_URI \.gif$ gif-image +CustomLog "gif-requests.log" common env=gif-image +CustomLog "nongif-requests.log" common env=!gif-image</pre> + + + <p>Or, to reproduce the behavior of the old RefererIgnore + directive, you might use the following:</p> + + <pre class="prettyprint lang-config">SetEnvIf Referer example\.com localreferer +CustomLog "referer.log" referer env=!localreferer</pre> + + +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="GlobalLog" id="GlobalLog">GlobalLog</a> <a name="globallog" id="globallog">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets filename and format of log file</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>GlobalLog<var>file</var>|<var>pipe</var> +<var>format</var>|<var>nickname</var> +[env=[!]<var>environment-variable</var>| +expr=<var>expression</var>]</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr> +<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_log_config</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache HTTP Server 2.4.19 and later</td></tr> +</table> + + <p>The <code class="directive">GlobalLog</code> directive defines a log shared + by the main server configuration and all defined virtual hosts.</p> + + <p>The <code class="directive">GlobalLog</code> directive is identical to + the <code class="directive">CustomLog</code> directive, apart from the following + differences:</p> + <ul> + <li><code class="directive">GlobalLog</code> is not valid in virtual host + context.</li> + <li><code class="directive">GlobalLog</code> is used by virtual hosts that + define their own <code class="directive">CustomLog</code>, unlike a + globally specified <code class="directive">CustomLog</code>.</li> + </ul> + +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="LogFormat" id="LogFormat">LogFormat</a> <a name="logformat" id="logformat">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Describes a format for use in a log file</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LogFormat <var>format</var>|<var>nickname</var> +[<var>nickname</var>]</code></td></tr> +<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>LogFormat "%h %l %u %t \"%r\" %>s %b"</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr> +<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_log_config</td></tr> +</table> + <p>This directive specifies the format of the access log + file.</p> + + <p>The <code class="directive">LogFormat</code> directive can take one of two + forms. In the first form, where only one argument is specified, + this directive sets the log format which will be used by logs + specified in subsequent <code class="directive">TransferLog</code> + directives. The single argument can specify an explicit + <var>format</var> as discussed in the <a href="#formats">custom log + formats</a> section above. Alternatively, it can use a + <var>nickname</var> to refer to a log format defined in a + previous <code class="directive">LogFormat</code> directive as described + below.</p> + + <p>The second form of the <code class="directive">LogFormat</code> + directive associates an explicit <var>format</var> with a + <var>nickname</var>. This <var>nickname</var> can then be used in + subsequent <code class="directive">LogFormat</code> or + <code class="directive"><a href="#customlog">CustomLog</a></code> directives + rather than repeating the entire format string. A + <code class="directive">LogFormat</code> directive that defines a nickname + <strong>does nothing else</strong> -- that is, it <em>only</em> + defines the nickname, it doesn't actually apply the format and make + it the default. Therefore, it will not affect subsequent + <code class="directive"><a href="#transferlog">TransferLog</a></code> directives. + In addition, <code class="directive">LogFormat</code> cannot use one nickname + to define another nickname. Note that the nickname should not contain + percent signs (<code>%</code>).</p> + + <div class="example"><h3>Example</h3><pre class="prettyprint lang-config">LogFormat "%v %h %l %u %t \"%r\" %>s %b" vhost_common</pre> +</div> + + +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="TransferLog" id="TransferLog">TransferLog</a> <a name="transferlog" id="transferlog">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Specify location of a log file</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>TransferLog <var>file</var>|<var>pipe</var></code></td></tr> +<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr> +<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_log_config</td></tr> +</table> + <p>This directive has exactly the same arguments and effect as + the <code class="directive"><a href="#customlog">CustomLog</a></code> + directive, with the exception that it does not allow the log format + to be specified explicitly or for conditional logging of requests. + Instead, the log format is determined by the most recently specified + <code class="directive"><a href="#logformat">LogFormat</a></code> directive + which does not define a nickname. Common Log Format is used if no + other format has been specified.</p> + + <div class="example"><h3>Example</h3><pre class="prettyprint lang-config">LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\"" +TransferLog logs/access_log</pre> +</div> + +</div> +</div> +<div class="bottomlang"> +<p><span>Available Languages: </span><a href="../en/mod/mod_log_config.html" title="English"> en </a> | +<a href="../fr/mod/mod_log_config.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | +<a href="../ja/mod/mod_log_config.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_log_config.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | +<a href="../tr/mod/mod_log_config.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> +</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&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed 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 Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div> +<script type="text/javascript"><!--//--><![CDATA[//><!-- +var comments_shortname = 'httpd'; +var comments_identifier = 'http://httpd.apache.org/docs/2.4/mod/mod_log_config.html'; +(function(w, d) { + if (w.location.hostname.toLowerCase() == "httpd.apache.org") { + d.write('<div id="comments_thread"><\/div>'); + var s = d.createElement('script'); + s.type = 'text/javascript'; + s.async = true; + s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; + (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); + } + else { + d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); + } +})(window, document); +//--><!]]></script></div><div id="footer"> +<p class="apache">Copyright 2023 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> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- +if (typeof(prettyPrint) !== 'undefined') { + prettyPrint(); +} +//--><!]]></script> +</body></html>
\ No newline at end of file diff --git a/docs/manual/mod/mod_log_config.html.fr.utf8 b/docs/manual/mod/mod_log_config.html.fr.utf8 new file mode 100644 index 0000000..5590aaa --- /dev/null +++ b/docs/manual/mod/mod_log_config.html.fr.utf8 @@ -0,0 +1,645 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> +<!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>mod_log_config - Serveur HTTP Apache Version 2.4</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<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" /> +<script src="../style/scripts/prettify.min.js" type="text/javascript"> +</script> + +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body> +<div id="page-header"> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p> +<p class="apache">Serveur HTTP Apache Version 2.4</p> +<img alt="" src="../images/feather.png" /></div> +<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Module Apache mod_log_config</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_log_config.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_log_config.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_log_config.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_log_config.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | +<a href="../tr/mod/mod_log_config.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> +</div> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Journalisation des requêtes envoyées au +serveur</td></tr> +<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>log_config_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_log_config.c</td></tr></table> +<h3>Sommaire</h3> + + <p>Ce module apporte une grande souplesse dans la journalisation des + requêtes des clients. Les journaux sont écrits sous un format + personnalisable, et peuvent être enregistrés directement dans un + fichier, ou redirigés vers un programme externe. La journalisation + conditionnelle est supportée, si bien que des requêtes individuelles + peuvent être incluses ou exclues des journaux en fonction de leur + caractéristiques.</p> + + <p>Ce module fournit trois directives : <code class="directive"><a href="#transferlog">TransferLog</a></code> crée un fichier + journal, <code class="directive"><a href="#logformat">LogFormat</a></code> + définit un format personnalisé, et <code class="directive"><a href="#customlog">CustomLog</a></code> définit un fichier journal et un format en + une seule étape. Pour journaliser les requêtes dans plusieurs + fichiers, vous pouvez utiliser plusieurs fois les directives + <code class="directive">TransferLog</code> et + <code class="directive">CustomLog</code> dans chaque serveur.</p> +</div> +<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><h3>Sujets</h3> +<ul id="topics"> +<li><img alt="" src="../images/down.gif" /> <a href="#formats">Formats de journaux personnalisés</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#security">Considérations concernant la +sécurité</a></li> +</ul><h3 class="directives">Directives</h3> +<ul id="toc"> +<li><img alt="" src="../images/down.gif" /> <a href="#bufferedlogs">BufferedLogs</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#customlog">CustomLog</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#globallog">GlobalLog</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#logformat">LogFormat</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#transferlog">TransferLog</a></li> +</ul> +<h3>Traitement des bugs</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">Journal des modifications de httpd</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">Problèmes connus</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_log_config">Signaler un bug</a></li></ul><h3>Voir aussi</h3> +<ul class="seealso"> +<li><a href="../logs.html">Les fichiers journaux +d'Apache</a></li> +<li><a href="#comments_section">Commentaires</a></li></ul></div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="formats" id="formats">Formats de journaux personnalisés</a></h2> + + <p>L'argument format des directives <code class="directive"><a href="#logformat">LogFormat</a></code> et <code class="directive"><a href="#customlog">CustomLog</a></code> est une chaîne de + caractères. Cette chaîne définit le format de la journalisation des + requêtes dans le fichier journal. Elle peut contenir des caractères + littéraux qui seront reproduits dans le fichier journal, et les + caractères de contrôle de style C "\n" et "\t" représentant + respectivement une nouvelle ligne et une tabulation. Les guillemets + et les anti-slashes littéraux doivent être échappés à l'aide + d'anti-slashes.</p> + + <p>Les caractéristiques de la requête en elle-même sont journalisées + en insérant des directives "<code>%</code>" dans la chaîne de + format, celles-ci étant remplacées dans le fichier journal par + certaines valeurs comme suit :</p> + + <table class="bordered"><tr class="header"><th>Chaîne de format</th> + <th>Description</th></tr> +<tr><td><code>%%</code></td> + <td>Le signe "pourcentage"</td></tr> +<tr class="odd"><td><code>%a</code></td> + <td>L'adresse IP distante (voir le module + <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code>).</td></tr> +<tr><td><code>%{c}a</code></td> + <td>Adresse IP distante de la connexion(voir le module + <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code>)</td></tr> +<tr class="odd"><td><code>%A</code></td> + <td>L'adresse IP locale</td></tr> +<tr><td><code>%B</code></td> + <td>La taille de la réponse en octets, en excluant les en-têtes + HTTP.</td></tr> +<tr class="odd"><td><code>%b</code></td> + <td>La taille de la réponse en octets, en excluant les en-têtes + HTTP. Au format CLF , c'est à dire un '<code>-</code>' à la + place d'un 0 lorsqu'aucun octet n'est renvoyé.</td></tr> +<tr><td><code>%{<var>NOMVAR</var>}C</code></td> + <td>Le contenu du cookie <var>NOMVAR</var> dans la requête + envoyée au serveur. Seuls les cookies version 0 sont pleinement + supportés.</td></tr> +<tr class="odd"><td><code>%D</code></td> + <td>Le temps mis à servir la requête, en + microsecondes.</td></tr> +<tr><td><code>%{<var>NOMVAR</var>}e</code></td> + <td>Le contenu de la variable d'environnement + <var>NOMVAR</var></td></tr> +<tr class="odd"><td><code>%f</code></td> + <td>Nom de fichier</td></tr> +<tr><td><code>%h</code></td> + <td>Serveur distant. Contiendra l'adresse IP si la directive + <code class="directive"><a href="../mod/core.html#hostnamelookups">HostnameLookups</a></code> est définie + à <code>Off</code>, ce qui est sa valeur par défaut. Si cette + adresse IP n'est enregistrée que pour certains serveurs, vous + avez probablement défini des directives de contrôle d'accès qui + mentionnent ces derniers par leurs noms. Voir la <a href="mod_authz_host.html#reqhost">documentation de Require + host</a>.</td></tr> +<tr class="odd"><td><code>%{c}h</code></td> + <td>Semblable à <code>%h</code>, mais exploite toujours le nom d'hôte de + la connection TCP sous-jacente, en ignorant toute modification réalisée + sur le nom d'hôte distant par des modules tels que + <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code>.</td></tr> +<tr><td><code>%H</code></td> + <td>Le protocole de la requête</td></tr> +<tr class="odd"><td><code>%{<var>NOMVAR</var>}i</code></td> + <td>Le contenu des lignes d'en-tête + <code><var>NOMVAR</var>:</code> dans la requête envoyée au + serveur. Ces en-têtes sont ajoutés par d'autres modules (par + exemple <code class="module"><a href="../mod/mod_headers.html">mod_headers</a></code>). Si vous êtes intéressé + par ce qu'était l'en-tête de la requête avant d'être modifié + par la plupart des modules, utilisez + <code class="module"><a href="../mod/mod_setenvif.html">mod_setenvif</a></code> pour copier l'en-tête dans une + variable d'environnement interne et journaliser sa valeur via + le champ <code>%{<var>VARNAME</var>}e</code> décrit plus haut. + + </td></tr> +<tr><td><code>%k</code></td> + <td>Nombre de requêtes persistantes en cours pour cette + connexion. Interessant si la directive <code class="directive"><a href="../mod/core.html#keepalive">KeepAlive</a></code> est utilisée ; par exemple, + '1' signifie la première requête après la requête initiale, '2' + la seconde, etc... ; autrement, il s'agit toujours de 0 + (indiquant la requête initiale).</td></tr> +<tr class="odd"><td><code>%l</code></td> + <td>Le nom de connexion distant (en provenance d'identd, si + disponible). Affiche un tiret, sauf si + <code class="module"><a href="../mod/mod_ident.html">mod_ident</a></code> est présent et si <code class="directive"><a href="../mod/mod_ident.html#identitycheck">IdentityCheck</a></code> est à + <code>On</code>.</td></tr> +<tr><td><code>%L</code></td> + <td>L'identifiant du message de journalisation de la requête + dans le journal des erreurs (ou '-' si aucun message n'a + été enregistré dans le journal des erreurs pour cette requête)</td></tr> +<tr class="odd"><td><code>%m</code></td> + <td>La méthode de la requête</td></tr> +<tr><td><code>%{<var>NOMVAR</var>}n</code></td> + <td>Le contenu de la note <var>NOMVAR</var> en provenance d'un + autre module.</td></tr> +<tr class="odd"><td><code>%{<var>NOMVAR</var>}o</code></td> + <td>Le contenu de la ligne d'en-tête + <code><var>NOMVAR</var>:</code> de la réponse.</td></tr> +<tr><td><code>%p</code></td> + <td>Le port canonique du serveur servant la requête</td></tr> +<tr class="odd"><td><code>%{<var>format</var>}p</code></td> + <td>Le port canonique du serveur servant la requête ou le + véritable port du serveur ou le véritable port du client. les + formats valides sont <code>canonical</code>, <code>local</code>, + ou <code>remote</code>. + </td></tr> +<tr><td><code>%P</code></td> + <td>Le numéro de processus du processus enfant qui a servi la + requête.</td></tr> +<tr class="odd"><td><code>%{<var>format</var>}P</code></td> + <td>Le numéro de processus ou le numéro de thread du processus + enfant qui a servi la requête. Les formats valides sont + <code>pid</code>, <code>tid</code>, et <code>hextid</code>. + </td></tr> +<tr><td><code>%q</code></td> + <td>La chaîne d'arguments (préfixée par un <code>?</code> si une + chaîne d'arguments existe, sinon une chaîne vide)</td></tr> +<tr class="odd"><td><code>%r</code></td> + <td>La première ligne de la requête</td></tr> +<tr><td><code>%R</code></td> + <td>Le gestionnaire qui génère la réponse (s'il y en a un).</td></tr> +<tr class="odd"><td><code>%s</code></td> + <td>Statut. Pour les requêtes redirigées en interne, il s'agit + du statut de la requête *originale* --- <code>%>s</code> pour + la dernière.</td></tr> +<tr><td><code>%t</code></td> + <td>Date à laquelle la requête a été reçue (au format anglais + standard)</td></tr> +<tr class="odd"><td><code>%{<var>format</var>}t</code></td> + <td>La date, sous la forme spécifiée par format, qui devrait + être au format étendu <code>strftime(3)</code> (éventuellement + localisé). Si le format commence par <code>begin:</code> (valeur + par défaut), la date est extraite au début du traitement de la + requête ; s'il commence par <code>end:</code>, la date + correspond au moment où l'entrée du journal est inscrite, par + conséquent vers la fin du traitement de la requête. Hormis les + formats supportés par <code>strftime(3)</code>, les formats + suivants sont aussi disponibles : + <table> + <tr><td><code>sec</code></td><td>nombre de secondes depuis Epoch</td></tr> + <tr><td><code>msec</code></td><td>nombre de millisecondes depuis Epoch</td></tr> + <tr><td><code>usec</code></td><td>nombre de microsecondes depuis Epoch</td></tr> + <tr><td><code>msec_frac</code></td><td>fraction de milliseconde</td></tr> + <tr><td><code>usec_frac</code></td><td>fraction de microseconde</td></tr> + </table> + Ces symboles ne peuvent pas être combinés entre eux ou avec un + formatage <code>strftime(3)</code> dans la même chaîne de + format. Par contre, vous pouvez utiliser plusieurs symboles + <code>%{<var>format</var>}t</code>.</td></tr> +<tr><td><code>%T</code></td> + <td>Le temps mis pour servir la requête, en secondes.</td></tr> +<tr class="odd"><td><code>%{<var>UNIT</var>}T</code></td> + <td>Le temps mis pour traiter la requête dans une unité définie + par <code>UNIT</code>. Les valeurs d'unité valides sont + <code>ms</code> pour millisecondes, <code>us</code> pour + microsecondes et <code>s</code> pour secondes. Si + <code>UNIT</code> est omis, la valeur de l'unité par défaut est + la seconde ; spécifier la valeur d'unité <code>us</code> revient + à utiliser le format <code>%D</code>. La possibilité de + spécifier une valeur d'unité avec le format <code>%T</code> est + disponible depuis la version 2.4.13 du serveur HTTP Apache.</td></tr> +<tr><td><code>%u</code></td> + <td>L'utilisateur distant (en provenance d'auth ; peut être faux + si le statut de retour (<code>%s</code>) est 401).</td></tr> +<tr class="odd"><td><code>%U</code></td> + <td>Le chemin de la requête, à l'exclusion de toute chaîne + d'arguments.</td></tr> +<tr><td><code>%v</code></td> + <td>Le nom canonique du serveur qui a servi la requête, défini + par la directive <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code>.</td></tr> +<tr class="odd"><td><code>%V</code></td> + <td>La nom du serveur en tenant compte de la définition de la + directive <code class="directive"><a href="../mod/core.html#usecanonicalname">UseCanonicalName</a></code>.</td></tr> +<tr><td><code>%X</code></td> + <td>Statut de la connexion lorsque la réponse a été renvoyée + : + + <table> + + <tr><td><code>X</code> =</td> + <td>connexion abandonnée avant l'envoi de la réponse.</td></tr> + <tr><td><code>+</code> =</td> + <td>la connexion peut rester ouverte après l'envoi de la + réponse.</td></tr> + <tr><td><code>-</code> = </td> + <td>la connexion sera fermée après l'envoi de la + réponse.</td></tr> + </table> + + </td></tr> +<tr class="odd"><td><code>%I</code></td> + <td>Le nombre d'octets reçus, en comptant la requête et les + en-têtes, ne peut être nul. Nécessite l'activation de + <code class="module"><a href="../mod/mod_logio.html">mod_logio</a></code>.</td></tr> +<tr><td><code>%O</code></td> + <td>Nombre d'octets envoyés, y compris les en-têtes. Peut être + nul dans les rares cas où une requête est avortée avant que la + réponse ne soit envoyée. Nécessite l'activation de + <code class="module"><a href="../mod/mod_logio.html">mod_logio</a></code>.</td></tr> +<tr class="odd"><td><code>%S</code></td> + <td>Nombre d'octets transmis (en émission et réception), y + compris corps et en-têtes de requête. Ce nombre ne peut pas être + nul, et il correspond à la combinaison des formats %I et %O. + <code class="module"><a href="../mod/mod_logio.html">mod_logio</a></code> doit être chargé pour pouvoir + utiliser ce format.</td></tr> +<tr><td><code>%{<var>VARNAME</var>}^ti</code></td> + <td>Le contenu de <code><var>VARNAME</var>:</code> dans les + paramètres de la requête envoyée au serveur.</td></tr> +<tr class="odd"><td><code>%{<var>VARNAME</var>}^to</code></td> + <td>Le contenu de <code><var>VARNAME</var>:</code> dans les + paramètres de la réponse envoyée par le serveur.</td></tr> +</table> + + <h3><a name="modifiers" id="modifiers">Modificateurs</a></h3> + + <p>Il est possible de restreindre l'enregistrement de certains + éléments + en fonction du code de statut de la réponse, en insérant une liste + de codes de statut séparés par des virgules immédiatement après le + caractère "%". Par exemple, <code>"%400,501{User-agent}i"</code> + n'enregistrera l'en-tête <code>User-agent</code> que dans le cas + d'une erreur 400 ou 501. Avec les autres codes de statut, c'est la + chaîne littérale <code>"-"</code> qui sera enregistrée. La liste + de codes peut être précédée d'un "<code>!</code>" pour inverser la + condition : <code>"%!200,304,302{Referer}i"</code> enregistre + l'en-tête <code>Referer</code> pour toutes les requêtes qui + <em>ne</em> renvoient <em>pas</em> un des trois codes spécifiés.</p> + + <p>Les modificateurs "<" et ">" peuvent être utilisés pour + les requêtes qui ont été redirigées en interne afin de choisir si + c'est respectivement la requête originale ou finale qui doit être + consultée. Par défaut, les directives <code>%s, %U, %T, %D,</code> + et <code>%r</code> consultent la requête originale, alors que + toutes les autres consultent la requête finale. Ainsi, par + exemple, on peut utiliser <code>%>s</code> pour enregistrer le + statut final de la requête, et <code>%<u</code> pour + enregistrer l'utilisateur authentifié à l'origine pour une requête + redirigée en interne vers une ressource sans authentification.</p> + + + + <h3><a name="format-notes" id="format-notes">Quelques Notes</a></h3> + + <p>Pour des raisons de sécurité, à partir de la version 2.0.46, + les caractères non imprimables et autres caractères spéciaux dans + les directives <code>%r</code>, <code>%i</code> et <code>%o</code> + doivent être échappés à l'aide des séquences + <code>\x<var>hh</var></code>, + où <var>hh</var> est le code hexadécimal du caractère spécial. + Comme exceptions à cette règle, les caractères <code>"</code> et + <code>\</code> doivent être échappés par un anti-slash, et tous + les "blancs" doivent être écrits selon leur notation de style C + (<code>\n</code>, <code>\t</code>, etc...). Avant la version + 2.0.46, aucun échappement n'était effectué sur ces chaînes, et il + fallait être très prudent lors de l'exploitation des journaux + bruts.</p> + + <p>A la différence de la version 1.3, depuis httpd 2.0, les chaînes + de format <code>%b</code> et <code>%B</code> ne représentent pas + le nombre d'octets envoyés au client, mais simplement la taille en + octets de la réponse HTTP (les deux étant différents, par exemple, + si la connexion est abandonnée, ou si SSL est utilisé). Le format + <code>%O</code> fourni par <code class="module"><a href="../mod/mod_logio.html">mod_logio</a></code>, + enregistrera le nombre réel d'octets envoyés sur le réseau.</p> + + <p>Note : <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> est implémenté en tant que + gestionnaire basique et non en tant que gestionnaire standard. + C'est pourquoi la chaîne de format <code>%R</code> ne renverra pas + d'information à propos du gestionnaire lorsqu'une mise en cache de + contenu entre en jeu.</p> + + + + <h3><a name="examples" id="examples">Exemples</a></h3> + + <p>Quelques chaînes de format couramment utilisées :</p> + + <dl> + <dt>Format de journal courant (CLF)</dt> + <dd><code>"%h %l %u %t \"%r\" %>s %b"</code></dd> + + <dt>Format de journal courant avec un serveur virtuel</dt> + <dd><code>"%v %h %l %u %t \"%r\" %>s %b"</code></dd> + + <dt>Format de journal NCSA étandu/combiné</dt> + <dd><code>"%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" + \"%{User-agent}i\""</code></dd> + + <dt>Format de journal de la page qui contient le lien vers la + page concernée (Referer)</dt> + <dd><code>"%{Referer}i -> %U"</code></dd> + + <dt>Format de journal de l'agent (Navigateur)</dt> + <dd><code>"%{User-agent}i"</code></dd> + </dl> + + <p>Vous pouvez utiliser plusieurs fois la directive + <code>%{format}t</code> pour construire un format de temps + utilisant les symboles de format étendus tels que + <code>msec_frac</code> :</p> + <dl> +<dt>Format de temps prenant en compte les milisecondes</dt> +<dd><code>"%{%d/%b/%Y %T}t.%{msec_frac}t %{%z}t"</code></dd> + + </dl> + + +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="security" id="security">Considérations concernant la +sécurité</a></h2> + <p>Voir le document <a href="../misc/security_tips.html#serverroot">conseils à matière de + sécurité</a> pour plus de détails sur les raisons pour lesquelles + votre sécurité pourrait être compromise, si le répertoire où sont + stockés les fichiers journaux sont inscriptibles par tout autre + utilisateur que celui qui démarre le serveur.</p> +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="bufferedlogs" id="bufferedlogs">Directive</a> <a name="BufferedLogs" id="BufferedLogs">BufferedLogs</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enregistre les entrées du journal dans un tampon en mémoire +avant de les écrire sur disque</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>BufferedLogs On|Off</code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>BufferedLogs Off</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_log_config</td></tr> +</table> + <p>Lorsque la directive <code class="directive">BufferedLogs</code> est à + "on", <code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code> stocke de nombreuses entrées + du journal en mémoire, et les écrit d'un seul bloc sur disque, + plutôt que de les écrire après chaque requête. Sur certains + systèmes, ceci peut améliorer l'efficacité des accès disque, et par + conséquent les performances. La directive ne peut être définie + qu'une seule fois pour l'ensemble du serveur ; elle ne peut pas être + définie au niveau d'un serveur virtuel.</p> + + <div class="note">Cette directive doit être utilisée avec + précautions car un crash peut provoquer la perte de données de + journalisation.</div> + +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="customlog" id="customlog">Directive</a> <a name="CustomLog" id="CustomLog">CustomLog</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le nom et le format du fichier +journal</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CustomLog <var>fichier</var>|<var>pipe</var> +<var>format</var>|<var>alias</var> +[env=[!]<var>variable-environnement</var>| +expr=<var>expression</var>]</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_log_config</td></tr> +</table> + <p>La directive <code class="directive">CustomLog</code> permet de contrôler + la journalisation des requêtes destinées au serveur. Un format de + journal est spécifié, et la journalisation peut s'effectuer de + manière conditionnelle en fonction des caractéristiques de la + requête en utilisant des variables d'environnement.</p> + + <p>Le premier argument, qui spécifie l'emplacement où les journaux + seront écrits, accepte deux types de valeurs :</p> + + <dl> + <dt><var>fichier</var></dt> + <dd>Un nom de fichier, relatif au répertoire défini par la + directive <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>.</dd> + + <dt><var>pipe</var></dt> + <dd>Le caractère pipe "<code>|</code>", suivi du chemin vers un + programme qui recevra les informations de la journalisation sur + son entrée standard. Voir les notes à propos de la <a href="../logs.html#piped">journalisation redirigée</a> pour plus + d'informations. + + <div class="warning"><h3>Sécurité :</h3> + <p>Si les journaux sont redirigés vers un programme, ce dernier + s'exécutera sous l'utilisateur qui a démarré + <code class="program"><a href="../programs/httpd.html">httpd</a></code>. Ce sera l'utilisateur root si le serveur + a été démarré par root ; vérifiez que le programme est + sécurisé.</p> + </div> + <div class="warning"><h3>Note</h3> + <p>Lors de la spécification d'un chemin de fichier sur les + plate-formes non-Unix, il faut prendre soin de ne pas oublier + que seuls les slashes directs doivent être utilisés, même si la + plate-forme autorise l'emploi d'anti-slashes. D'une manière + générale, c'est une bonne idée que de n'utiliser que des slashes + directs dans les fichiers de configuration.</p> + </div></dd> + </dl> + + <p>Le second argument permet de définir ce qui va être écrit dans le + fichier journal. Il peut contenir soit un <var>alias</var> prédéfini + par une directive <code class="directive"><a href="#logformat">LogFormat</a></code>, soit une chaîne de + <var>format</var> explicite comme décrit dans la section <a href="#formats">formats de journaux</a>.</p> + + <p>Par exemple, les deux blocs de directives suivants produisent le + même effet :</p> + + <pre class="prettyprint lang-config"># Journal personnalisé avec alias de format +LogFormat "%h %l %u %t \"%r\" %>s %b" common +CustomLog "logs/access_log" common + +# Journal personnalisé avec chaîne de format explicite +CustomLog "logs/access_log" "%h %l %u %t \"%r\" %>s %b"</pre> + + + <p>Le troisième argument est optionnel et permet de contrôler si une + requête doit être ou non journalisée. Dans le cas d'une clause + '<code>env=!<var>nom</var></code>', la condition peut être la + présence ou l'absence d'une variable particulière dans + l'<a href="../env.html">environnement du serveur</a>. Dans le cas + d'une clause 'expr=<var>expression</var>', la condition consiste + en une <a href="../expr.html">expression</a> booléenne + quelconque. Si la condition n'est pas vérifiée, la requête ne sera + pas journalisée. D'éventuelles références à des en-têtes HTTP dans + l'expression rationnelle n'entraîneront pas l'ajout des noms + d'en-tête correspondants à l'en-tête Vary.</p> + + <p>Les variables d'environnement peuvent être définies au niveau de + chaque requête en utilisant les modules + <code class="module"><a href="../mod/mod_setenvif.html">mod_setenvif</a></code> et/ou <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>. + Par exemple, si vous voulez enregistrer les requêtes pour toutes les + images GIF sur votre serveur dans un fichier journal séparé, et pas + dans votre journal principal, vous pouvez utiliser :</p> + + <pre class="prettyprint lang-config">SetEnvIf Request_URI \.gif$ gif-image +CustomLog "gif-requests.log" common env=gif-image +CustomLog "nongif-requests.log" common env=!gif-image</pre> + + + <p>Ou, pour reproduire le comportement de l'ancienne directive + RefererIgnore, vous pouvez utiliser :</p> + + <pre class="prettyprint lang-config">SetEnvIf Referer example\.com localreferer +CustomLog "referer.log" referer env=!localreferer</pre> + + +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="globallog" id="globallog">Directive</a> <a name="GlobalLog" id="GlobalLog">GlobalLog</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le nom et le format du fichier journal</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>GlobalLog<var>file</var>|<var>pipe</var> +<var>format</var>|<var>nickname</var> +[env=[!]<var>environment-variable</var>| +expr=<var>expression</var>]</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_log_config</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.19 du serveur HTTP Apache</td></tr> +</table> + + <p>La directive <code class="directive">GlobalLog</code> permet de spécifier un + journal partagé entre le serveur principal et tous les serveurs virtuels + définis.</p> + + <p>Elle est identique à la directive <code class="directive">CustomLog</code> à ces + différences près : </p> + <ul> + <li>Elle n'est pas valide dans un contexte de serveur virtuel.</li> + <li>A la différence d'une directive <code class="directive">CustomLog</code> + définie globalement, elle est prise en compte par les serveurs virtuels + qui définissent leur propre directive <code class="directive">CustomLog</code>.</li> + </ul> + +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="logformat" id="logformat">Directive</a> <a name="LogFormat" id="LogFormat">LogFormat</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Décrit un format utilisable dans un fichier +journal</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LogFormat <var>format</var>|<var>alias</var> +[<var>alias</var>]</code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>LogFormat "%h %l %u %t \"%r\" %>s %b"</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_log_config</td></tr> +</table> + <p>Cette directive permet de spécifier le format du fichier journal + des accès.</p> + + <p>La directive <code class="directive">LogFormat</code> se présente sous + deux formes. Sous la première forme, qui ne possède qu'un seul + argument, la directive définit le format qui sera utilisé dans les + journaux spécifiés par les directives + <code class="directive">TransferLog</code> ultérieures. L'argument unique + peut contenir un <var>format</var> explicite comme décrit dans la + section <a href="#formats">formats de journaux personnalisés</a> + ci-dessus. Il peut aussi contenir un <var>alias</var> faisant + référence à un format de journal prédéfini par une directive + <code class="directive">LogFormat</code> comme décrit plus loin.</p> + + <p>Sous sa seconde forme, la directive + <code class="directive">LogFormat</code> associe un <var>format</var> + explicite à un <var>alias</var>. Cet <var>alias</var> peut + ensuite s'utiliser dans les directives + <code class="directive">LogFormat</code> ou <code class="directive"><a href="#customlog">CustomLog</a></code> ultérieures, ce qui + évite d'avoir à répéter l'ensemble de la chaîne de format. Une + directive <code class="directive">LogFormat</code> qui définit un alias + <strong>ne fait rien d'autre</strong> -- c'est à dire qu'<em>elle ne + fait que</em> définir l'alias, elle n'applique pas le format et n'en + fait pas le format par défaut. Par conséquent, elle n'affecte pas + les directives <code class="directive"><a href="#transferlog">TransferLog</a></code> ultérieures. En + outre, la directive <code class="directive">LogFormat</code> ne peut pas + utiliser un alias pour en définir un autre. Notez que l'alias ne + doit pas contenir de caractère pourcent (<code>%</code>).</p> + + <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">LogFormat "%v %h %l %u %t \"%r\" %>s %b" serveur_virtuel_commun</pre> +</div> + + +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="transferlog" id="transferlog">Directive</a> <a name="TransferLog" id="TransferLog">TransferLog</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Spécifie l'emplacement d'un fichier journal</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>TransferLog <var>fichier</var>|<var>pipe</var></code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_log_config</td></tr> +</table> + <p>Cette directive possède exactement les mêmes arguments et produit + les mêmes effets que la directive <code class="directive"><a href="#customlog">CustomLog</a></code>, à l'exception qu'elle + ne permet pas de spécifier un format de journal explicite ou la + journalisation conditionnelle des requêtes. En l'occurrence, le + format de journal est déterminé par la dernière définition d'une + directive <code class="directive"><a href="#logformat">LogFormat</a></code> + qui ne définit pas d'alias. Si aucun format particulier n'a été + spécifié, c'est le Common Log Format qui sera utilisé.</p> + + <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\"" +TransferLog logs/access_log</pre> +</div> + +</div> +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_log_config.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_log_config.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_log_config.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_log_config.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | +<a href="../tr/mod/mod_log_config.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> +</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">Commentaires</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 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 Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div> +<script type="text/javascript"><!--//--><![CDATA[//><!-- +var comments_shortname = 'httpd'; +var comments_identifier = 'http://httpd.apache.org/docs/2.4/mod/mod_log_config.html'; +(function(w, d) { + if (w.location.hostname.toLowerCase() == "httpd.apache.org") { + d.write('<div id="comments_thread"><\/div>'); + var s = d.createElement('script'); + s.type = 'text/javascript'; + s.async = true; + s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; + (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); + } + else { + d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); + } +})(window, document); +//--><!]]></script></div><div id="footer"> +<p class="apache">Copyright 2023 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- +if (typeof(prettyPrint) !== 'undefined') { + prettyPrint(); +} +//--><!]]></script> +</body></html>
\ No newline at end of file diff --git a/docs/manual/mod/mod_log_config.html.ja.utf8 b/docs/manual/mod/mod_log_config.html.ja.utf8 new file mode 100644 index 0000000..0e9ea2a --- /dev/null +++ b/docs/manual/mod/mod_log_config.html.ja.utf8 @@ -0,0 +1,510 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="ja" xml:lang="ja"><head> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> +<!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>mod_log_config - Apache HTTP サーバ バージョン 2.4</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<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" /> +<script src="../style/scripts/prettify.min.js" type="text/javascript"> +</script> + +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body> +<div id="page-header"> +<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> +<p class="apache">Apache HTTP サーバ バージョン 2.4</p> +<img alt="" src="../images/feather.png" /></div> +<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<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.4</a> > <a href="./">モジュール</a></div> +<div id="page-content"> +<div id="preamble"><h1>Apache モジュール mod_log_config</h1> +<div class="toplang"> +<p><span>翻訳済み言語: </span><a href="../en/mod/mod_log_config.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_log_config.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | +<a href="../ja/mod/mod_log_config.html" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_log_config.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | +<a href="../tr/mod/mod_log_config.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> +</div> +<div class="outofdate">この日本語訳はすでに古くなっている + 可能性があります。 + 最近更新された内容を見るには英語版をご覧下さい。 + </div> +<table class="module"><tr><th><a href="module-dict.html#Description">説明:</a></th><td>サーバへのリクエストのロギング</td></tr> +<tr><th><a href="module-dict.html#Status">ステータス:</a></th><td>Base</td></tr> +<tr><th><a href="module-dict.html#ModuleIdentifier">モジュール識別子:</a></th><td>log_config_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">ソースファイル:</a></th><td>mod_log_config.c</td></tr></table> +<h3>概要</h3> + + <p> + このモジュールはクライアントのリクエストを柔軟にログ収集する機能を + 提供します。ログはカスタマイズ可能な書式で書かれ、ファイルに直接 + 書いたり、外部プログラムに渡したりすることができます。個々のリクエストを + 特徴に応じてログに書いたり書かなかったりできるように、条件による + ログ収集も提供されています。</p> + + <p>このモジュールは三つのディレクティブ提供します: + ログファイルを作成するための <code class="directive"><a href="#transferlog">TransferLog</a></code>, + 新しい書式を 定義する <code class="directive"><a href="#logformat">LogFormat</a></code>, + ログファイルと 書式を一度に定義する <code class="directive"><a href="#customlog">CustomLog</a></code> です。 + 各リクエストが複数回ログ収集されるようにするために + <code class="directive">TransferLog</code> ディレクティブと + <code class="directive">CustomLog</code> + ディレクティブは複数回使用することができます。</p> +</div> +<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><h3>トピック</h3> +<ul id="topics"> +<li><img alt="" src="../images/down.gif" /> <a href="#formats">カスタムログ書式</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#security">セキュリティに関して</a></li> +</ul><h3 class="directives">ディレクティブ</h3> +<ul id="toc"> +<li><img alt="" src="../images/down.gif" /> <a href="#bufferedlogs">BufferedLogs</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#customlog">CustomLog</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#globallog">GlobalLog</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#logformat">LogFormat</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#transferlog">TransferLog</a></li> +</ul> +<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> +<ul class="seealso"> +<li><a href="../logs.html">Apache ログファイル</a></li> +<li><a href="#comments_section">コメント</a></li></ul></div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="formats" id="formats">カスタムログ書式</a></h2> + + <p><code class="directive"><a href="#logformat">LogFormat</a></code> ディレクティブと + <code class="directive"><a href="#customlog">CustomLog</a></code> + ディレクティブの書式を指定する引数は文字列です。この文字列を使ってそれぞれの + リクエストがログファイルにログ収集されます。その文字列には + ログファイルにそのまま + 書かれる文字列や、それぞれ改行とタブを表す C 言語 + 形式の制御文字 "\n" と "\t" + とを含めることができます。そのまま出力させたい引用符とバックスラッシュは + バックスラッシュでエスケープする必要があります。</p> + + <p>リクエストの特徴そのものは "<code>%</code>" + ディレクティブを書式の文字列に書くことで + ログ収集されます。"%" + ディレクティブはログファイル中では以下のような + 値で置換されます:</p> + + <table class="bordered"><tr class="header"><th>フォーマット文字列</th> + <th>説明</th></tr> +<tr><td><code>%%</code></td> + <td>パーセント記号</td></tr> +<tr class="odd"><td><code>%a</code></td> + <td>リモート IP アドレス</td></tr> +<tr><td><code>%A</code></td> + <td>ローカル IP アドレス</td></tr> +<tr class="odd"><td><code>%B</code></td> + <td>レスポンスのバイト数。HTTP ヘッダは除く。</td></tr> +<tr><td><code>%b</code></td> + <td>レスポンスのバイト数。HTTP ヘッダは除く。CLF 書式。 + <em>すなわち</em>、1 バイトも送られなかったときは 0 ではなく、 + '<code>-</code>' になる</td></tr> +<tr class="odd"><td><code>%{<var>Foobar</var>}C</code></td> + <td>サーバに送られたリクエスト中のクッキー <var>Foobar</var> の値</td></tr> +<tr><td><code>%D</code></td> + <td>リクエストを処理するのにかかった時間、マイクロ秒単位</td></tr> +<tr class="odd"><td><code>%{<var>FOOBAR</var>}e</code></td> + <td>環境変数 <var>FOOBAR</var> の内容</td></tr> +<tr><td><code>%f</code></td> + <td>ファイル名</td></tr> +<tr class="odd"><td><code>%h</code></td> + <td>リモートホスト</td></tr> +<tr><td><code>%H</code></td> + <td>リクエストプロトコル</td></tr> +<tr class="odd"><td><code>%{<var>Foobar</var>}i</code></td> + <td>サーバに送られたリクエストの <code><var>Foobar</var>:</code> + ヘッダの内容</td></tr> +<tr><td><code>%l</code></td> + <td>(identd からもし提供されていれば) リモートログ名。 + これは <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> + ディレクティブが <code>On</code> に設定されていない限り、 + <code>-</code> になります。</td></tr> +<tr class="odd"><td><code>%m</code></td> + <td>リクエストメソッド</td></tr> +<tr><td><code>%{<var>Foobar</var>}n</code></td> + <td>他のモジュールからのメモ <var>Foobar</var> の内容</td></tr> +<tr class="odd"><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 class="odd"><td><code>%{<var>format</var>}p</code></td> + <td>サーバがリクエストを処理しているポートの公式 + <span class="transnote">(<em>訳注:</em> canonical)</span> のポート番号か、 + サーバの実際のポート番号か、クライアント側の実際のポート番号かです。 + format に使える文字列は <code>canonical</code>, <code>local</code>, + <code>remote</code> になります。 + </td></tr> +<tr><td><code>%P</code></td> + <td>リクエストを扱った子プロセスのプロセス ID</td></tr> +<tr class="odd"><td><code>%{<var>format</var>}P</code></td> + <td>リクエストを扱ったワーカーのプロセス ID かスレッド ID。 + <var>format</var> として有効な値は <code>pid</code>, <code>tid</code>, + <code>hextid</code> です。<code>hextid</code> を使うには + APR 1.2.0 以降が必要です。 + </td></tr> +<tr><td><code>%q</code></td> + <td>問い合せ文字列 (存在する場合は前に <code>?</code> が追加される。 + そうでない場合は空文字列)</td></tr> +<tr class="odd"><td><code>%r</code></td> + <td>リクエストの最初の行</td></tr> +<tr><td><code>%s</code></td> + <td>ステータス。内部でリダイレクトされたリクエストは、元々の + リクエストのステータス --- 最後のステータスは <code>%>s</code> + </td></tr> +<tr class="odd"><td><code>%t</code></td> + <td>リクエストを受付けた時刻。 + CLF の時刻の書式 (標準の英語の書式)</td></tr> +<tr><td><code>%{<var>format</var>}t</code></td> + <td><var>format</var> で与えられた書式による時刻。format は + <code>strftime (3)</code> の + 書式である必要がある。(地域化されている可能性がある)</td></tr> +<tr class="odd"><td><code>%T</code></td> + <td>リクエストを扱うのにかかった時間、秒単位</td></tr> +<tr><td><code>%u</code></td> + <td>リモートユーザ (認証によるもの。ステータス (<code>%s</code>) が + 401 のときは意味がないものである可能性がある) + </td></tr> +<tr class="odd"><td><code>%U</code></td> + <td>リクエストされた URL パス。クエリ文字列は含まない</td></tr> +<tr><td><code>%v</code></td> + <td>リクエストを扱っているサーバの正式な <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code></td></tr> +<tr class="odd"><td><code>%V</code></td> + <td><code class="directive"><a href="../mod/core.html#usecanonicalname">UseCanonicalName</a></code> の設定によるサーバ名</td></tr> +<tr><td><code>%X</code></td> + <td>応答が完了したときの接続ステータス: + + <table> + + <tr><td><code>X</code> =</td> + <td>応答が完了する前に接続が異常終了</td></tr> + <tr><td><code>+</code> =</td> + <td>応答が送られた後に接続を持続することが可能</td></tr> + <tr><td><code>-</code> = </td> + <td>応答が送られた後に接続が切られる</td></tr> + </table> + + <p>(このディレクティブは Apache + 1.3 の後期のバージョンでは <code>%c</code> に割り当てられて + いましたが、これは歴史的に ssl が使用している + <code>%{<var>var</var>}c</code> + 構文と衝突していました。)</p></td></tr> +<tr class="odd"><td><code>%I</code></td> + <td>リクエストとヘッダを含む、受け取ったバイト数。 + 0 にはならない。 + これを使用するためには <code class="module"><a href="../mod/mod_logio.html">mod_logio</a></code> が必要</td></tr> +<tr><td><code>%O</code></td> + <td>ヘッダを含む、送信したバイト数。0 にはならない。 + これを使用するためには <code class="module"><a href="../mod/mod_logio.html">mod_logio</a></code> が必要</td></tr> +</table> + + <h3><a name="modifiers" id="modifiers">修飾子</a></h3> + + <p>特定の要素は "%" の直後に HTTP ステータスコードをカンマ区切りで + 指定することで、表示を制限することができます。例えば + <code>"%400,501{User-agent}i"</code> では、 + 400 と 500 番エラーでのみ <code>User-agent</code> をログします。 + 他のステータスコードでは <code>"-"</code> という文字列が + ログされます。ステータスコードのリストは "<code>!</code>" + で否定を指定することができます : + <code>"%!200,304,302{Referer}i"</code> は、指定された + 3 つのコードの<em>どれにも該当しない</em>リクエスト全てで + <code>Referer</code> をログします。</p> + + <p>修飾子 "<" と ">" は内部リダイレクトされたリクエストのログに + 元のリクエストか最終的なリクエストのどちらを使用するかを + 指定するために使います。デフォルトでは、<code>%</code> ディレクティブの + <code>%s, %U, %T, %D, %r</code> は元のリクエストを、他は最終的なリクエストを + 使用します。例えば、リクエストの最終ステータスを記録するには + <code>%>s</code> を、内部的に認証されていないリソースへリダイレクトされた + リクエストで元のリクエストで認証されたユーザを記録するためには + <code>%<u</code> を使うことができます。</p> + + + + <h3><a name="format-notes" id="format-notes">その他注意点</a></h3> + + <p>セキュリティ上の理由により 2.0.46 より、 + <code>%r</code>, <code>%i</code>, <code>%o</code> に入っている、 + 印字不可能な文字と他の特別な文字は、<code>\x<var>hh</var></code> + という形式の文字列でエスケープされるようになりました。<var>hh</var> は + そのままのバイトの値の 16 進での値です。この規則の例外には、 + バックスラッシュを使ってエスケープされる <code>"</code> と <code>\</code> と、 + C 形式の表記法が使われる空白文字 (<code>\n</code>, <code>\t</code> など) + があります。2.0.46 以前のバージョンではエスケープ処理は行われませんので、 + 生ログファイルを扱う際に注意が必要です。</p> + + <p>httpd 2.0 では 1.3 とは異なり、<code>%b</code> と <code>%B</code> + フォーマット文字列はクライアントに送信されたバイト数そのものではなく、 + HTTP レスポンスのバイト数です (これらは異なるもので、たとえば、 + コネクションが途中で破棄された場合や、SSL 使用時に一致しません) 。 + <code class="module"><a href="../mod/mod_logio.html">mod_logio</a></code> で提供されている <code>%O</code> + フォーマット文字列で、ネットワーク経由で実際に転送されたバイト数を + 記録できます。</p> + + + + <h3><a name="examples" id="examples">例</a></h3> + + <p>よく使われるフォーマット文字列は:</p> + + <dl> + <dt>Common Log Format (CLF)</dt> + <dd><code>"%h %l %u %t \"%r\" %>s %b"</code></dd> + + <dt>バーチャルホスト付き Common Log Format</dt> + <dd><code>"%v %h %l %u %t \"%r\" %>s %b"</code></dd> + + <dt>NCSA extended/combined ログ書式</dt> + <dd><code>"%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" + \"%{User-agent}i\""</code></dd> + + <dt>Referer ログ書式</dt> + <dd><code>"%{Referer}i -> %U"</code></dd> + + <dt>Agent (ブラウザ) ログ書式</dt> + <dd><code>"%{User-agent}i"</code></dd> + </dl> + +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="security" id="security">セキュリティに関して</a></h2> + <p>ログファイルが保存されているディレクトリがサーバを起動した以外のユーザで + 書き込み可能なときにセキュリティの問題が発生する理由の詳細は<a href="../misc/security_tips.html#serverroot">セキュリティのこつ</a> + を参照してください。</p> +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="BufferedLogs" id="BufferedLogs">BufferedLogs</a> <a name="bufferedlogs" id="bufferedlogs">ディレクティブ</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">説明:</a></th><td>ディスクに書き出す前にメモリにログエントリをバッファする</td></tr> +<tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>BufferedLogs On|Off</code></td></tr> +<tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>BufferedLogs Off</code></td></tr> +<tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル</td></tr> +<tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Base</td></tr> +<tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_log_config</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>2.0.41 以降</td></tr> +</table> + <p><code class="directive">BufferedLogs</code> ディレクティブを使うと + <code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code> の挙動が変化して、 + 複数のログを書き出す際に、それぞれのリクエスト処理後毎に + 書き出すのではなく、いったんメモリに蓄えてから、 + まとめてディスクに書き出すようになります。 + この結果ディスクアクセスがより効率的になり、 + 高いパフォーマンスの得られるシステムもあるでしょう。 + このディレクティブはサーバ全体で一度だけ設定できます; + バーチャルホストごとに設定することはできません。</p> + + <div class="note">このディレクティブは実験的なものですので、 + 使用する際は注意してください。</div> + +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="CustomLog" id="CustomLog">CustomLog</a> <a name="customlog" id="customlog">ディレクティブ</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">説明:</a></th><td>ログファイルの名前と書式を設定する</td></tr> +<tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>CustomLog <var>file</var>|<var>pipe</var> +<var>format</var>|<var>nickname</var> +[env=[!]<var>environment-variable</var>]</code></td></tr> +<tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr> +<tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Base</td></tr> +<tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_log_config</td></tr> +</table> + <p><code class="directive">CustomLog</code> ディレクティブはサーバへのリクエストを + ログ収集するために使われます。ログの書式が指定され、 + 環境変数を使ってロギングが条件に応じて行なわれるようにすることもできます。</p> + + <p>ログが書かれる場所を指定する最初の引数は以下の二つの形式の値を + とることができます:</p> + + <dl> + <dt><var>file</var></dt> + <dd><code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> + からの相対パスで表されるファイル名。</dd> + + <dt><var>pipe</var></dt> + <dd>パイプ文字 "<code>|</code>" と、その後に標準入力からログの + 情報を受けとるプログラムへのパスが続いたもの。 + + <div class="warning"><h3>セキュリティ</h3> + <p>もしプログラムが使用された場合、 + <code class="program"><a href="../programs/httpd.html">httpd</a></code> が起動されたユーザとして実行されます。これはサーバが + root によって起動された場合は root になります。プログラムが + 安全であるように留意してください。</p> + </div> + <div class="warning"><h3>注</h3> + <p>Unix でないプラットフォームでファイルのパスを入力しているときは、 + 使用しているプラットフォームがバックスラッシュの使用を許可していた + として、通常のスラッシュだけを使うように気をつけてください。 + 一般的に、設定ファイル中では常に普通のスラッシュのみを使うようにする + 方が良いです。</p> + </div></dd> + </dl> + + <p>二つめの引数はログファイルに何が書かれるかを指定します。 + 前にある <code class="directive"><a href="#logformat">LogFormat</a></code> ディレクティブにより + 定義された <var>nickname</var> か、<a href="#formats">ログの書式</a> + のところで説明されている、明示的な <var>format</var> 文字列の + どちらかを指定することができます。</p> + + <p>例えば、以下の二つのディレクティブ群は全く同じ効果をもたらします:</p> + + <div class="example"><p><code> + # CustomLog with format nickname<br /> + LogFormat "%h %l %u %t \"%r\" %>s %b" common<br /> + CustomLog logs/access_log common<br /> + <br /> + # CustomLog with explicit format string<br /> + CustomLog logs/access_log "%h %l %u %t \"%r\" %>s %b" + </code></p></div> + + <p>三つ目の引数は省略可能で、サーバの環境にある変数があるかないかに + 応じてリクエストをログ収集するかどうかを制御するために使うことができます。 + 指定された<a href="../env.html">環境変数</a>がリクエストに対して + 設定されていた場合 ('<code>env=!<var>name</var></code>' 文が使われたときは + 設定されていない場合)、リクエストがログ収集されます。</p> + + <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> モジュールの両方もしくは + 片方を用いてリクエストごとに設定することができます。 + 例えば、サーバにあるすべての GIF 画像へのリクエストを別のログファイル + には記録したいけれど、メインログには記録したくない、というときは + 以下のものを使うことができます:</p> + + <div class="example"><p><code> + SetEnvIf Request_URI \.gif$ gif-image<br /> + CustomLog gif-requests.log common env=gif-image<br /> + CustomLog nongif-requests.log common env=!gif-image + </code></p></div> + + <p>古い RefererIgnore ディレクティブと同じ挙動をさせたい場合は、 + 次のようにします:</p> + + <div class="example"><p><code> + SetEnvIf Referer example\.com localreferer<br /> + CustomLog referer.log referer env=!localreferer + </code></p></div> + +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="GlobalLog" id="GlobalLog">GlobalLog</a> <a name="globallog" id="globallog">ディレクティブ</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Sets filename and format of log file</td></tr> +<tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>GlobalLog<var>file</var>|<var>pipe</var> +<var>format</var>|<var>nickname</var> +[env=[!]<var>environment-variable</var>| +expr=<var>expression</var>]</code></td></tr> +<tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル</td></tr> +<tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Base</td></tr> +<tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_log_config</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>Available in Apache HTTP Server 2.4.19 and later</td></tr> +</table><p>このディレクティブの解説文書は + まだ翻訳されていません。英語版をご覧ください。 + </p></div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="LogFormat" id="LogFormat">LogFormat</a> <a name="logformat" id="logformat">ディレクティブ</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">説明:</a></th><td>ログファイルで使用する書式を設定する</td></tr> +<tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>LogFormat <var>format</var>|<var>nickname</var> +[<var>nickname</var>]</code></td></tr> +<tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>LogFormat "%h %l %u %t \"%r\" %>s %b"</code></td></tr> +<tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr> +<tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Base</td></tr> +<tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_log_config</td></tr> +</table> + <p>このディレクティブはアクセスログファイルの書式を指定します。</p> + + <p><code class="directive">LogFormat</code> ディレクティブは二つの形式のどちらかを + とることができます。最初の形式では一つの引数のみが指定され、 + 続く <code class="directive">TransferLog</code> + で指定されたログで使われるログの書式を設定します。この単独の引数では + 上の<a href="#formats">カスタムログ書式</a>で説明されているように + <var>format</var> を明示的に指定することができます。 + もしくは、下で説明されているように前に <code class="directive">LogFormat</code> + ディレクティブで定義されたログの書式を <var>nickname</var>を使って + 参照することもできます。</p> + + <p><code class="directive">LogFormat</code> ディレクティブの二つめの形式は + <var>format</var> に <var>nickname</var> を与えます。 + フォーマット文字列全体を再び書くかわりに、 + この <var>nickname</var> を続きの <code class="directive">LogFormat</code> ディレクティブや + <code class="directive">CustomLog</code> ディレクティブで使うことができます。 + Nickname を定義する <code class="directive">LogFormat</code> ディレクティブは + <strong>他には何もしません</strong> -- すなわち、ニックネームを定義 + する<em>だけ</em>で、実際に書式を適用してデフォルトにするということは行ないません。 + ですから、これは続く <code class="directive"><a href="#transferlog">TransferLog</a></code> + ディレクティブには影響を与えません。 + さらに、<code class="directive">LogFormat</code> ディレクティブは既存の nickname を + 使って別の nickname を定義することはできません。Nickname には + パーセント記号 (<code>%</code>) が含まれていてはいけないことにも注意 + してください。</p> + + <div class="example"><h3>例</h3><p><code> + LogFormat "%v %h %l %u %t \"%r\" %>s %b" vhost_common + </code></p></div> + +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="TransferLog" id="TransferLog">TransferLog</a> <a name="transferlog" id="transferlog">ディレクティブ</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">説明:</a></th><td>ログファイルの位置を指定</td></tr> +<tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>TransferLog <var>file</var>|<var>pipe</var></code></td></tr> +<tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr> +<tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Base</td></tr> +<tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_log_config</td></tr> +</table> + <p>このディレクティブは、ログ書式を直接指定できないことと、 + 条件付きロギングが無いことを除くと、<code class="directive"><a href="#customlog">CustomLog</a></code> と全く同じ引数と効果があります。 + 直接ログ書式を指定する代わりに、ログの書式はそこまでで一番最後に指定された + ニックネームを定義しない + <code class="directive"><a href="#logformat">LogFormat</a></code> ディレクティブ + で定義されたものを使います。 + もし他の書式が全く指定されていないときは Common Log Format + が使われます。</p> + + <div class="example"><h3>例</h3><p><code> + LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\""<br /> + TransferLog logs/access_log + </code></p></div> + +</div> +</div> +<div class="bottomlang"> +<p><span>翻訳済み言語: </span><a href="../en/mod/mod_log_config.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_log_config.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | +<a href="../ja/mod/mod_log_config.html" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_log_config.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | +<a href="../tr/mod/mod_log_config.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> +</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 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 Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div> +<script type="text/javascript"><!--//--><![CDATA[//><!-- +var comments_shortname = 'httpd'; +var comments_identifier = 'http://httpd.apache.org/docs/2.4/mod/mod_log_config.html'; +(function(w, d) { + if (w.location.hostname.toLowerCase() == "httpd.apache.org") { + d.write('<div id="comments_thread"><\/div>'); + var s = d.createElement('script'); + s.type = 'text/javascript'; + s.async = true; + s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; + (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); + } + else { + d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); + } +})(window, document); +//--><!]]></script></div><div id="footer"> +<p class="apache">Copyright 2023 The Apache Software Foundation.<br />この文書は <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> のライセンスで提供されています。.</p> +<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[//><!-- +if (typeof(prettyPrint) !== 'undefined') { + prettyPrint(); +} +//--><!]]></script> +</body></html>
\ No newline at end of file diff --git a/docs/manual/mod/mod_log_config.html.ko.euc-kr b/docs/manual/mod/mod_log_config.html.ko.euc-kr new file mode 100644 index 0000000..c344687 --- /dev/null +++ b/docs/manual/mod/mod_log_config.html.ko.euc-kr @@ -0,0 +1,441 @@ +<?xml version="1.0" encoding="EUC-KR"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="ko" xml:lang="ko"><head> +<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" /> +<!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>mod_log_config - Apache HTTP Server Version 2.4</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<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" /> +<script src="../style/scripts/prettify.min.js" type="text/javascript"> +</script> + +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body> +<div id="page-header"> +<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> +<p class="apache">Apache HTTP Server Version 2.4</p> +<img alt="" src="../images/feather.png" /></div> +<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./"></a></div> +<div id="page-content"> +<div id="preamble"><h1>ġ mod_log_config</h1> +<div class="toplang"> +<p><span> : </span><a href="../en/mod/mod_log_config.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_log_config.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | +<a href="../ja/mod/mod_log_config.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_log_config.html" title="Korean"> ko </a> | +<a href="../tr/mod/mod_log_config.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> +</div> +<div class="outofdate"> ֽ ƴմϴ. + ֱٿ ϼ.</div> +<table class="module"><tr><th><a href="module-dict.html#Description">:</a></th><td> û α Ѵ</td></tr> +<tr><th><a href="module-dict.html#Status">:</a></th><td>Base</td></tr> +<tr><th><a href="module-dict.html#ModuleIdentifier">:</a></th><td>log_config_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">ҽ:</a></th><td>mod_log_config.c</td></tr></table> +<h3></h3> + + <p> Ŭ̾Ʈ û α Ӱ Ѵ. + ڽ ϴ α ְ, ̳ ܺ + α α ִ. α ϸ + û ݿ û α ߰ϰų ִ.</p> + + <p> þ Ѵ. <code class="directive"><a href="#transferlog">TransferLog</a></code> α + , <code class="directive"><a href="#logformat">LogFormat</a></code> + ϴ ϰ, <code class="directive"><a href="#customlog">CustomLog</a></code> ѹ αϰ + Ѵ. <code class="directive">TransferLog</code> + <code class="directive">CustomLog</code> þ ϸ + û Ͽ ִ.</p> +</div> +<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><h3></h3> +<ul id="topics"> +<li><img alt="" src="../images/down.gif" /> <a href="#formats">α ϱ</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#security">Ȼ </a></li> +</ul><h3 class="directives">þ</h3> +<ul id="toc"> +<li><img alt="" src="../images/down.gif" /> <a href="#bufferedlogs">BufferedLogs</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#customlog">CustomLog</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#globallog">GlobalLog</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#logformat">LogFormat</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#transferlog">TransferLog</a></li> +</ul> +<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> +<ul class="seealso"> +<li><a href="../logs.html">ġ α</a></li> +<li><a href="#comments_section">Comments</a></li></ul></div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="formats" id="formats">α ϱ</a></h2> + + <p><code class="directive"><a href="#logformat">LogFormat</a></code> + <code class="directive"><a href="#customlog">CustomLog</a></code> + þ ƱԸƮ ڿ̴. ڿ û + αϿ Ѵ. ڿ αϿ ״ Ǵ + ڿ ٲް Ÿ C "\n" "\t" ڸ + ִ. αϿ ǥ 齽 տ + ݵ 齽 Ѵ.</p> + + <p>û Ư¡ ڿ "<code>%</code>" þ + Ͽ Ѵ. þ αϿ + ȴ.</p> + + <table class="bordered"><tr class="header"><th> ڿ</th> + <th></th></tr> +<tr><td><code>%%</code></td> + <td>ۼƮ ȣ</td></tr> +<tr class="odd"><td><code>%...a</code></td> + <td> IP-ּ</td></tr> +<tr><td><code>%...A</code></td> + <td>() IP-ּ</td></tr> +<tr class="odd"><td><code>%...B</code></td> + <td>HTTP Ʈ.</td></tr> +<tr><td><code>%...b</code></td> + <td>HTTP Ʈ. CLF İ + 0 '<code>-</code>' ´.</td></tr> +<tr class="odd"><td><code>%...{<var>Foobar</var>}C</code></td> + <td> û <var>Foobar</var> Ű + .</td></tr> +<tr><td><code>%...D</code></td> + <td>û óϴµ ɸ ð (ũ ).</td></tr> +<tr class="odd"><td><code>%...{<var>FOOBAR</var>}e</code></td> + <td>ȯ溯 <var>FOOBAR</var> </td></tr> +<tr><td><code>%...f</code></td> + <td>ϸ</td></tr> +<tr class="odd"><td><code>%...h</code></td> + <td> ȣƮ</td></tr> +<tr><td><code>%...H</code></td> + <td>û </td></tr> +<tr class="odd"><td><code>%...{<var>Foobar</var>}i</code></td> + <td> û <code><var>Foobar</var>:</code> + .</td></tr> +<tr><td><code>%...l</code></td> + <td>(ִٸ identd ) αθ. + <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> + <code>On</code> ƴϸ ȣ Ѵ.</td></tr> +<tr class="odd"><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 class="odd"><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 class="odd"><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 class="odd"><td><code>%...q</code></td> + <td>ǹڿ (ǹڿ ִٸ տ <code>?</code> + ̰, ٸ ڿ)</td></tr> +<tr><td><code>%...r</code></td> + <td>û ù° </td></tr> +<tr class="odd"><td><code>%...s</code></td> + <td>(status). ̷ǵ û ** + û ̴. û ´ <code>%...>s</code>.</td></tr> +<tr><td><code>%...t</code></td> + <td>common log format ð (ǥ ) ð</td></tr> +<tr class="odd"><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 class="odd"><td><code>%...u</code></td> + <td> (auth ϸ, (<code>%s</code>) + 401 ̻ )</td></tr> +<tr><td><code>%...U</code></td> + <td>ǹڿ û URL .</td></tr> +<tr class="odd"><td><code>%...v</code></td> + <td>û <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code>.</td></tr> +<tr><td><code>%...V</code></td> + <td><code class="directive"><a href="../mod/core.html#usecanonicalname">UseCanonicalName</a></code> + .</td></tr> +<tr class="odd"><td><code>%...X</code></td> + <td> . + + <table> + + <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 . + ̸ Ϸ <code class="module"><a href="../mod/mod_logio.html">mod_logio</a></code> ʿϴ.</td></tr> +<tr class="odd"><td><code>%...O</code></td> + <td> ۽ Ʈ 0 . ̸ + Ϸ <code class="module"><a href="../mod/mod_logio.html">mod_logio</a></code> ʿϴ.</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> "<" ">" ̷ǵ û + ó û û Ѵ. ⺻ + <code>%s, %U, %T, %D, %r</code> ó û , + <code>%</code> þ û . + <code>%>s</code> û (status) ϰ, + <code>%<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\" %>s %b"</code></dd> + + <dt>ȣƮ Common Log Format</dt> + <dd><code>"%v %h %l %u %t \"%r\" %>s %b"</code></dd> + + <dt>NCSA extended/combined α </dt> + <dd><code>"%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" + \"%{User-agent}i\""</code></dd> + + <dt>Referer α </dt> + <dd><code>"%{Referer}i -> %U"</code></dd> + + <dt>Agent () α </dt> + <dd><code>"%{User-agent}i"</code></dd> + </dl> + + <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> + <code>%p</code> Ѵ. αм α û + ϴ ȣƮ ˱ ȣƮ ã ˰ + ʿ ̵ <code class="directive"><a href="../mod/core.html#usecanonicalname">UseCanonicalName</a></code> ϴ.</p> +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="security" id="security">Ȼ </a></h2> + <p> ϴ ڿܿ ٸ ڰ α ϴ + 丮 ȿ + <a href="../misc/security_tips.html#serverroot"> </a> + ϶.</p> +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="BufferedLogs" id="BufferedLogs">BufferedLogs</a> <a name="bufferedlogs" id="bufferedlogs">þ</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">:</a></th><td>Buffer log entries in memory before writing to disk</td></tr> +<tr><th><a href="directive-dict.html#Syntax">:</a></th><td><code /></td></tr> +<tr><th><a href="directive-dict.html#Context">:</a></th><td>ּ</td></tr> +<tr><th><a href="directive-dict.html#Status">:</a></th><td>Base</td></tr> +<tr><th><a href="directive-dict.html#Module">:</a></th><td>mod_log_config</td></tr> +</table><p>Documentation not yet translated. Please see English version of document.</p> +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="CustomLog" id="CustomLog">CustomLog</a> <a name="customlog" id="customlog">þ</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">:</a></th><td>α ̸ Ѵ</td></tr> +<tr><th><a href="directive-dict.html#Syntax">:</a></th><td><code>CustomLog <var>file</var>|<var>pipe</var> +<var>format</var>|<var>nickname</var> +[env=[!]<var>environment-variable</var>]</code></td></tr> +<tr><th><a href="directive-dict.html#Context">:</a></th><td>ּ, ȣƮ</td></tr> +<tr><th><a href="directive-dict.html#Status">:</a></th><td>Base</td></tr> +<tr><th><a href="directive-dict.html#Module">:</a></th><td>mod_log_config</td></tr> +</table> + <p> û α 涧 <code class="directive">CustomLog</code> + þ Ѵ. α ϰ, ȯ溯 Ͽ + û Ư¡ α ִ.</p> + + <p>α Ҹ ϴ ù° ƱԸƮ + ϳ Ѵ.</p> + + <dl> + <dt><var>file</var></dt> + <dd><code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> + ϸ.</dd> + + <dt><var>pipe</var></dt> + <dd> "<code>|</code>"ڿ α ǥԷ + α θ ´. + + <div class="warning"><h3>:</h3> + <p>α Ѵٸ α + ȴ. root Ѵٸ α + root ϹǷ α Ȯ϶.</p> + </div> + <div class="warning"><h3></h3> + <p>н ƴ ÷ ϰθ ԷҶ ÷ + 齽 ϴ ݵ ؾ Ѵ. + Ϲ Ͽ ϴ + .</p> + </div></dd> + </dl> + + <p>ι° ƱԸƮ αϿ Ѵ. + <code class="directive"><a href="#logformat">LogFormat</a></code> + <var>nickname</var> ϰų <a href="#formats">α </a> <var>format</var> + ڿ ִ.</p> + + <p> , þ Ȱ Ѵ.</p> + + <div class="example"><p><code> + # Ī CustomLog<br /> + LogFormat "%h %l %u %t \"%r\" %>s %b" common<br /> + CustomLog logs/access_log common<br /> + <br /> + # ڿ CustomLog<br /> + CustomLog logs/access_log "%h %l %u %t \"%r\" %>s %b" + </code></p></div> + + <p>° ƱԸƮ Ǹ, Ư ȯ溯 + û α θ Ѵ. û + <a href="../env.html">ȯ溯</a> ǵִٸ (Ȥ + '<code>env=!<var>name</var></code>' ٸ) + û α Ѵ.</p> + + <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> + Ͽ û ȯ溯 ִ. + , GIF û ּ αװ ƴ + ٸ αϿ Ϸ,</p> + + <div class="example"><p><code> + SetEnvIf Request_URI \.gif$ gif-image<br /> + CustomLog gif-requests.log common env=gif-image<br /> + CustomLog nongif-requests.log common env=!gif-image + </code></p></div> + +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="GlobalLog" id="GlobalLog">GlobalLog</a> <a name="globallog" id="globallog">þ</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">:</a></th><td>Sets filename and format of log file</td></tr> +<tr><th><a href="directive-dict.html#Syntax">:</a></th><td><code>GlobalLog<var>file</var>|<var>pipe</var> +<var>format</var>|<var>nickname</var> +[env=[!]<var>environment-variable</var>| +expr=<var>expression</var>]</code></td></tr> +<tr><th><a href="directive-dict.html#Context">:</a></th><td>ּ</td></tr> +<tr><th><a href="directive-dict.html#Status">:</a></th><td>Base</td></tr> +<tr><th><a href="directive-dict.html#Module">:</a></th><td>mod_log_config</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">:</a></th><td>Available in Apache HTTP Server 2.4.19 and later</td></tr> +</table><p>The documentation for this directive has + not been translated yet. Please have a look at the English + version.</p></div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="LogFormat" id="LogFormat">LogFormat</a> <a name="logformat" id="logformat">þ</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">:</a></th><td>αϿ Ѵ</td></tr> +<tr><th><a href="directive-dict.html#Syntax">:</a></th><td><code>LogFormat <var>format</var>|<var>nickname</var> +[<var>nickname</var>]</code></td></tr> +<tr><th><a href="directive-dict.html#Default">⺻:</a></th><td><code>LogFormat "%h %l %u %t \"%r\" %>s %b"</code></td></tr> +<tr><th><a href="directive-dict.html#Context">:</a></th><td>ּ, ȣƮ</td></tr> +<tr><th><a href="directive-dict.html#Status">:</a></th><td>Base</td></tr> +<tr><th><a href="directive-dict.html#Module">:</a></th><td>mod_log_config</td></tr> +</table> + <p> þ α Ѵ.</p> + + <p><code class="directive">LogFormat</code> þ ΰ + Ѵ. ù° ƱԸƮ Ѱ Ͽ + <code class="directive">TransferLog</code> þ α + Ѵ. ƱԸƮ <a href="#formats">α + ϱ</a> <var>format</var> + ϰų, <code class="directive">LogFormat</code> + þ ̸ (α Īϴ) <var>nickname</var> + ִ.</p> + + <p><code class="directive">LogFormat</code> þ ι° + <var>format</var> <var>nickname</var> Ѵ. + ڿ ϴ <code class="directive">LogFormat</code>̳ <code class="directive"><a href="#customlog">CustomLog</a></code> þ ݺؼ + ڿ Էϴ <var>nickname</var> + ִ. Ī ϴ <code class="directive">LogFormat</code> + þ <strong> ܿ ƹ ʴ´</strong>. + , Ī<em></em> ϸ, ϰų + ⺻ ʴ´. Ƿ + <code class="directive"><a href="#transferlog">TransferLog</a></code> + þ ʴ´. , + <code class="directive">LogFormat</code> Ī ٸ Ī + ִ. Ī ̸ ۼƮ ȣ(<code>%</code>) + ϶.</p> + + <div class="example"><h3></h3><p><code> + LogFormat "%v %h %l %u %t \"%r\" %>s %b" vhost_common + </code></p></div> + +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="TransferLog" id="TransferLog">TransferLog</a> <a name="transferlog" id="transferlog">þ</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">:</a></th><td>α ġ Ѵ</td></tr> +<tr><th><a href="directive-dict.html#Syntax">:</a></th><td><code>TransferLog <var>file</var>|<var>pipe</var></code></td></tr> +<tr><th><a href="directive-dict.html#Context">:</a></th><td>ּ, ȣƮ</td></tr> +<tr><th><a href="directive-dict.html#Status">:</a></th><td>Base</td></tr> +<tr><th><a href="directive-dict.html#Module">:</a></th><td>mod_log_config</td></tr> +</table> + <p> þ <code class="directive"><a href="#customlog">CustomLog</a></code> þ ƱԸƮ + , α ϰų û ǿ + α . ֱ (Ī + ) <code class="directive"><a href="#logformat">LogFormat</a></code> þ + α Ѵ. ̸ ʾҴٸ Common + Log Format Ѵ.</p> + + <div class="example"><h3></h3><p><code> + LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\""<br /> + TransferLog logs/access_log + </code></p></div> + +</div> +</div> +<div class="bottomlang"> +<p><span> : </span><a href="../en/mod/mod_log_config.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_log_config.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | +<a href="../ja/mod/mod_log_config.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_log_config.html" title="Korean"> ko </a> | +<a href="../tr/mod/mod_log_config.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> +</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&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed 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 Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div> +<script type="text/javascript"><!--//--><![CDATA[//><!-- +var comments_shortname = 'httpd'; +var comments_identifier = 'http://httpd.apache.org/docs/2.4/mod/mod_log_config.html'; +(function(w, d) { + if (w.location.hostname.toLowerCase() == "httpd.apache.org") { + d.write('<div id="comments_thread"><\/div>'); + var s = d.createElement('script'); + s.type = 'text/javascript'; + s.async = true; + s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; + (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); + } + else { + d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); + } +})(window, document); +//--><!]]></script></div><div id="footer"> +<p class="apache">Copyright 2023 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> +<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[//><!-- +if (typeof(prettyPrint) !== 'undefined') { + prettyPrint(); +} +//--><!]]></script> +</body></html>
\ No newline at end of file diff --git a/docs/manual/mod/mod_log_config.html.tr.utf8 b/docs/manual/mod/mod_log_config.html.tr.utf8 new file mode 100644 index 0000000..0fc980a --- /dev/null +++ b/docs/manual/mod/mod_log_config.html.tr.utf8 @@ -0,0 +1,586 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="tr" xml:lang="tr"><head> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> +<!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>mod_log_config - Apache HTTP Sunucusu Sürüm 2.4</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<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" /> +<script src="../style/scripts/prettify.min.js" type="text/javascript"> +</script> + +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body> +<div id="page-header"> +<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p> +<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p> +<img alt="" src="../images/feather.png" /></div> +<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="../">Sürüm 2.4</a> > <a href="./">Modüller</a></div> +<div id="page-content"> +<div id="preamble"><h1>Apache Modülü mod_log_config</h1> +<div class="toplang"> +<p><span>Mevcut Diller: </span><a href="../en/mod/mod_log_config.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_log_config.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | +<a href="../ja/mod/mod_log_config.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_log_config.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | +<a href="../tr/mod/mod_log_config.html" title="Türkçe"> tr </a></p> +</div> +<table class="module"><tr><th><a href="module-dict.html#Description">Açıklama:</a></th><td>Sunucuya yapılan isteklerin günlük kayıtlarının tutulması +</td></tr> +<tr><th><a href="module-dict.html#Status">Durum:</a></th><td>Temel</td></tr> +<tr><th><a href="module-dict.html#ModuleIdentifier">Modül Betimleyici:</a></th><td>log_config_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Kaynak Dosyası:</a></th><td>mod_log_config.c</td></tr></table> +<h3>Özet</h3> + + <p>Bu modül istemci isteklerinin esnek şekilde günlüklenmesi ile + ilgilidir. Günlükler kişiselleştirilebilir biçemdedir ve doğrudan bir + dosyaya yazılabileceği gibi boru üzerinden harici bir sürece de + yazılabilir. İsteğin özelliklerine bağlı olarak bazı isteklerin + günlüklere kaydedilmesi veya kaydedilmemesi mümkün kılınmıştır.</p> + + <p>Bu modül üç yönerge içermektedir: Bir günlük dosyası oluşturmak için + <code class="directive"><a href="#transferlog">TransferLog</a></code>, günlük + biçemini kişiselleştirmek için <code class="directive"><a href="#logformat">LogFormat</a></code> ve tek başına bir günlük + dosyasını hem tanımlayıp hem de biçemleyen <code class="directive"><a href="#customlog">CustomLog</a></code> yönergesi. Her isteğin + çok sayıda dosyaya günlüklenmesini sağlamak için yapılandırma dosyasında + her sunucu için birden fazla <code class="directive">TransferLog</code> ve + <code class="directive">CustomLog</code> yönergesi belirtilebilir.</p> +</div> +<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><h3>Konular</h3> +<ul id="topics"> +<li><img alt="" src="../images/down.gif" /> <a href="#formats">Günlük Girdilerinin Kişiselleştirilmesi</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#security">Güvenlik Kaygıları</a></li> +</ul><h3 class="directives">Yönergeler</h3> +<ul id="toc"> +<li><img alt="" src="../images/down.gif" /> <a href="#bufferedlogs">BufferedLogs</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#customlog">CustomLog</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#globallog">GlobalLog</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#logformat">LogFormat</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#transferlog">TransferLog</a></li> +</ul> +<h3>Bulunan hatalar</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd günlüğü</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">Bilinenler</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_log_config">Hata bildir</a></li></ul><h3>Ayrıca bakınız:</h3> +<ul class="seealso"> +<li><a href="../logs.html">Apache Günlük Dosyaları</a></li> +<li><a href="#comments_section">Yorumlar</a></li></ul></div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="formats" id="formats">Günlük Girdilerinin Kişiselleştirilmesi</a></h2> + + <p><code class="directive"><a href="#logformat">LogFormat</a></code> ve <code class="directive"><a href="#customlog">CustomLog</a></code> yönergelerinin biçem + argümanı bir dizgedir. Bu dizge her isteği günlük dosyasına günlüklemek + için kullanılır. Doğrudan günlük dosyalarına kopyalanmak üzere dizgesel + sabitler içerebileceği gibi satırsonu ve sekme karakterleri olarak C + tarzı "\n" ve "\t" denetim karakterlerini de içerebilir. Dizgesel sabit + olarak kullanılan tırnak ve tersbölü imlerinin tersbölü ile öncelenmesi + gerekir.</p> + + <p>İstek özellikleri biçem dizgesine “<code>%</code>” imli belirteçler + yerleştirilerek günlüklenir. Bu belirteçler ve anlamları:</p> + + <table class="bordered"><tr class="header"><th>Belirteç</th> + <th>Açıklama</th></tr> +<tr><td><code>%%</code></td> + <td>Yüzde imi.</td></tr> +<tr class="odd"><td><code>%a</code></td> + <td>Uzak IP adresi ve isteğin portu + (<code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code> modülüne bakın).</td></tr> +<tr><td><code>%{c}a</code></td> + <td>bağlantının emsal IP adresi and portu + (<code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code> modülüne bakın).</td></tr> +<tr class="odd"><td><code>%A</code></td> + <td>Yerel IP adresi.</td></tr> +<tr><td><code>%B</code></td> + <td>HTTP başlıkları hariç, yanıtın bayt cinsinden uzunluğu.</td></tr> +<tr class="odd"><td><code>%b</code></td> + <td>HTTP başlıkları hariç, yanıtın bayt cinsinden uzunluğu. OGB + biçeminde hiç bayt gönderilmemişse günlüğe '<code>-</code>' yerine + '<code>0</code>' çıktılanır.</td></tr> +<tr><td><code>%{<var>DEĞİŞKEN</var>}C</code></td> + <td>İstek içinde sunucuya gönderilen <var>DEĞİŞKEN</var> çerezinin + içeriği. Sadece 0 sürümlü çerezler tam olarak desteklenir.</td></tr> +<tr class="odd"><td><code>%D</code></td> + <td>Mikrosaniye cinsinden isteği sunmak için harcanan zaman.</td></tr> +<tr><td><code>%{<var>DEĞİŞKEN</var>}e</code></td> + <td><var>DEĞİŞKEN</var> ortam değişkeninin içeriği.</td></tr> +<tr class="odd"><td><code>%f</code></td> + <td>Dosya ismi.</td></tr> +<tr><td><code>%h</code></td> + <td>Uzak konak ismi. <code class="directive"><a href="../mod/core.html#hostnamelookups">HostnameLookups</a></code> yönergesine öntanımlı olan + <code>Off</code> değeri atanmışsa, IP adresi günlüğe kaydedilir. Bir + kaç konak için konak ismi de günlüğe kaydoluyorsa muhtemelen onların + isimlerini içeren erişim denetim yönergelerine sahipsinizdir. Bak: <a href="mod_authz_host.html#reqhost">Require host</a>.</td></tr> +<tr class="odd"><td><code>%{c}h</code></td> + <td><code>%h</code> gibi, ancak her zaman, temel TCP bağlantısının + konak adı kaydedilir, ancak <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code> gibi modüller + tarafından uzak konak adında yapılan değişiklikler kaydedilmez.</td></tr> +<tr><td><code>%H</code></td> + <td>İstek Protokolü.</td></tr> +<tr class="odd"><td><code>%{<var>DEĞİŞKEN</var>}i</code></td> + <td>İstekle birlikte sunucuya gönderilen + <code><var>DEĞİŞKEN</var>:</code> başlık satır(lar)ının + içeriği. Diğer modüllerde (örn. <code class="module"><a href="../mod/mod_headers.html">mod_headers</a></code>) + yapılan değişikliklerden etkilenir. Modüllerin çoğu bunu + değiştirdiğinde önceki istek başlık isminin ne olduğuyla + ilgileniyorsanız, başlığı bir ortam değişkenine kaydetmek için + <code class="module"><a href="../mod/mod_setenvif.html">mod_setenvif</a></code> modülünü kullanın ve yukarıda + açıklandığı gibi bu değeri <code>%{<var>DEĞİŞKEN</var>}e</code> ile + günlüğe kaydedin.</td></tr> +<tr><td><code>%k</code></td> + <td>Bu bağlantıda işlenen isteklerin sayısı; yani örneğin, + '1' değeri bağlantı kurulduktan sonraki ilk kalıcı bağlantıyı, + '2', ikinci bağlantıyı, ..., vb. gösterir; + <code class="directive"><a href="../mod/core.html#keepalive">KeepAlive</a></code> kullanılmışsa + değer anlamlıdır; aksi takdirde değer daima 0’dır.</td></tr> +<tr class="odd"><td><code>%l</code></td> + <td>Uzak kullanıcı kimliği (sağlanmışsa, identd üzerinden). + <code class="module"><a href="../mod/mod_ident.html">mod_ident</a></code> modülü mevcut ve <code class="directive"><a href="../mod/mod_ident.html#identitycheck">IdentityCheck</a></code> yönergesine değer + olarak <code>On</code> atanmış olmadıkça bu belirteç için günlüğe + tire imi yazılır.</td></tr> +<tr><td><code>%L</code></td> + <td>Hata günlüğündeki istek günlük kimliği (veya bu istek için hata + günlüğüne hiçbir şey kaydedilmemise '-'). Bu hataya neyin sebep + olduğunu öğrenmek için ilgili hata günlüğü satırına bakın.</td></tr> +<tr class="odd"><td><code>%m</code></td> + <td>İstek yöntemi.</td></tr> +<tr><td><code>%{<var>DEĞİŞKEN</var>}n</code></td> + <td>Diğer modüldeki <var>DEĞİŞKEN</var> bilgisinin içeriği.</td></tr> +<tr class="odd"><td><code>%{<var>DEĞİŞKEN</var>}o</code></td> + <td>Yanıttaki <code><var>DEĞİŞKEN</var>:</code> başlık satır(lar)ının + içeriği.</td></tr> +<tr><td><code>%p</code></td> + <td>Sunucunun isteği sunduğu meşru port.</td></tr> +<tr class="odd"><td><code>%{<var>biçem</var>}p</code></td> + <td>Sunucunun veya istemcinin gerçek portu veya sunucunun isteği + sunduğu meşru port. Geçerli biçemler: <code>canonical</code>, + <code>local</code> ve <code>remote</code> (anlamları sırasıyla: + meşru, yerel ve uzak).</td></tr> +<tr><td><code>%P</code></td> + <td>İsteği sunan çocuk sürecin süreç kimliği.</td></tr> +<tr class="odd"><td><code>%{<var>biçem</var>}P</code></td> + <td>İsteği sunan çocuk sürecin süreç kimliği (<code>pid</code>) veya + evre kimliği (<code>tid</code>). Geçerli biçemler: <code>pid</code>, + <code>tid</code>, <code>hextid</code>.</td></tr> +<tr><td><code>%q</code></td> + <td>Sorgu dizgesi (bir sorgu dizgesi mevcutsa önüne bir <code>?</code> + eklenir yoksa hiçbir şey eklenmez).</td></tr> +<tr class="odd"><td><code>%r</code></td> + <td>İsteğin ilk satırı.</td></tr> +<tr><td><code>%s</code></td> + <td>Durum. Dahili olarak yönlendirilmiş istekler için isteğin + <em>özgün</em> durumudur. İsteğin son durumu için + <code>%>s</code> kullanınız.</td></tr> +<tr class="odd"><td><code>%t</code></td> + <td><code>[18/Sep/2011:19:18:28 -0400]</code> biçeminde isteğin + alındığı tarih ve saat. Sondaki sayı zaman diliminin GMT'ye + uzaklığıdır.</td></tr> +<tr><td><code>%{<var>biçem</var>}t</code></td> + <td>İsteğin alındığı tarih ve saat; <var>biçem</var> + uzatılmış <code>strftime(3)</code> biçeminde belirtilmelidir (genelde + yerelleştirme amaçlı). <code>begin:</code> (öntanımlı) ile başlayan + biçemlerde süre isteğin başlangıcına göredir. <code>end:</code> ile + başlayan biçemlerde ise süre isteğin işlenmesinin bi,tmesine yakın, + günlük girdisinin yazılmaya başladığı ana göredir. + <code>strftime(3)</code> tarafından desteklenen biçemlere ek olarak + aşağıdaki biçem dizgecikleri de desteklenmektedir: + <table> + <tr><td><code>sec</code></td><td>Mutlak zaman başlangıcından (epoch) + beri geçen saniye sayısı</td></tr> + <tr><td><code>msec</code></td><td>Mutlak zaman başlangıcından beri + geçen milisaniye sayısı</td></tr> + <tr><td><code>usec</code></td><td>Mutlak zaman başlangıcından beri + geçen mikrosaniye sayısı</td></tr> + <tr><td><code>msec_frac</code></td><td>milisaniyelik kesir</td></tr> + <tr><td><code>usec_frac</code></td><td>mikrosaniyelik kesir</td></tr> + </table> + Bu dizgecikler, aynı biçem dizgesi içinde bir diğeriyle birlikte veya + <code>strftime(3)</code> biçemlemesiyle birlikte yer alamazlar fakat + çok sayıda <code>%{<var>biçem</var>}t</code> kullanılabilir. + </td></tr> +<tr class="odd"><td><code>%T</code></td> + <td>Saniye cinsinden, isteği sunmak için harcanan zaman.</td></tr> +<tr><td><code>%{<var>BİRİM</var>}T</code></td> + <td><var>BİRİM</var> ile belirtilen zaman birimi cinsinden, isteği + sunmak için harcanan zaman. Geçerli birimler: milisaniye için + <code>ms</code>, mikrosaniye için <code>us</code>, saniye için + <code>s</code>. <code>s</code> kullanımı birimsiz <code>%T</code> ile + aynı sonucu verir; <code>us</code> kullanımı <code>%D</code> ile aynı + sonucu verir. Birimli <code>%T</code> kullanımı 2.4.13 ve sonrasında + geçerlidir.</td></tr> +<tr class="odd"><td><code>%u</code></td> + <td>Uzak kullanıcı (kimlik doğrulaması istenmişse vardır; durum kodu + (<code>%s</code>) 401 ise yanlış olabilir).</td></tr> +<tr><td><code>%U</code></td> + <td>Herhangi bir sorgu dizgesi içermeksizin istenen URL yolu.</td></tr> +<tr class="odd"><td><code>%v</code></td> + <td>İsteği sunan sunucunun meşru sunucu ismi (<code class="directive"><a href="../mod/core.html#servername">ServerName</a></code>).</td></tr> +<tr><td><code>%V</code></td> + <td><code class="directive"><a href="../mod/core.html#usecanonicalname">UseCanonicalName</a></code> ayarı ile + ilgili sunucu ismi.</td></tr> +<tr class="odd"><td><code>%X</code></td> + <td>Yanıt tamamlandığında bağlantı durumu: + + <table> + + <tr><td><code>X</code> =</td> + <td>Yanıt tamamlanmadan bağlantı koptu.</td></tr> + <tr><td><code>+</code> =</td> + <td>Yanıt gönderildikten sonra bağlantı canlı kalabilir.</td></tr> + <tr><td><code>-</code> = </td> + <td>Yanıt gönderildikten sonra bağlantı kapatılacak.</td></tr> + </table></td></tr> +<tr><td><code>%I</code></td> + <td>İstek ve başlıklar dahil alınan bayt sayısı. Sıfır olamaz. Bunu + kullanmak için <code class="module"><a href="../mod/mod_logio.html">mod_logio</a></code> etkin olmalıdır.</td></tr> +<tr class="odd"><td><code>%O</code></td> + <td>Başlıklar dahil gönderilen bayt sayısı. Bir yanıtın + gönderilmesinden önce istekten vazgeçilmesi gibi nadir durumlarda + sıfır olabilir. Bunu kullanmak için <code class="module"><a href="../mod/mod_logio.html">mod_logio</a></code> etkin + olmalıdır.</td></tr> +<tr><td><code>%S</code></td> + <td>Aktarılan bayt sayısı (alınan ve gönderilen), istekler ve başlıklar + dahil; sıfır olamaz. %I ve %O'nun birleşimidir. Bunu kullanmak için + <code class="module"><a href="../mod/mod_logio.html">mod_logio</a></code> etkinleştirilmelidir.</td></tr> +<tr class="odd"><td><code>%{<var>ALANADI</var>}^ti</code></td> + <td>Sunucuya gönderilen istekteki <code><var>ALANADI</var>:</code> + Trailer satır(lar)ının içeriği.</td></tr> +<tr><td><code>%{<var>VARNAME</var>}^to</code></td> + <td>Sunucudan gönderilen yanıttaki <code><var>ALANADI</var>:</code> + Trailer satır(lar)ının içeriği.</td></tr> +</table> + + <h3><a name="modifiers" id="modifiers">Değiştiriciler</a></h3> + + <p>Belli öğelerin sadece belli durum kodlarıyla ilgili yanıtlarla + basılabilmesi için bu durum kodları % iminden hemen sonra virgüllerle + ayrılmış olarak yazılabilir. Olumsuzlama belirtmek için durum kodu listesinin önüne bir "<code>!</code>" konabilir.</p> + + <table class="bordered"><tr class="header"><th>Biçem Dizgesi</th> + <th>Anlamı</th></tr> +<tr><td><code>%400,501{User-agent}i</code></td> + <td>Sadece 400 ve 501 hatalarında <code>User-agent</code> günlüğe + kaydedilir. Diğer durum kodları için günlüğe <code>"-"</code> yazılır. + </td></tr> +<tr class="odd"><td><code>%!200,304,302{Referer}i</code></td> + <td>200,304,302 durum kodlarından biriyle dönmeyen tüm istekler için + <code>Referer</code> başlığı durum koduyla birlikte günlüğe + kaydedilir. Aksi takdirde günlüğe "<code>-</code>" yazılır. + </td></tr> +</table> + + <p>İsteğin dahili olarak yönlendirilmesinde özgün durumunun mu yoksa son + durumunun mu hesaba katılacağı "<" ve ">" değiştiricileri ile + belirtilebilir. Öntanımlı olarak <code>%s, %U, %T, %D,</code> ve + <code>%r</code> belirteçleri isteğin özgün durumuna bakarken diğerleri + son durumuna bakarlar. Bu bakımdan örneğin, <code>%>s</code> + belirteci, özgün istekteki kimliği doğrulanmış kullanıcının, dahili + olarak kimlik doğrulaması gerekmeyen bir özkaynağa yönlendirilmesi + halinde isteğin son durumunu kaydetmekte kullanılabilir.</p> + + + + <h3><a name="format-notes" id="format-notes">Bazı Bilgiler</a></h3> + + <p>Güvenlik nedeniyle, 2.0.46 sürümünden itibaren <code>%r</code>, + <code>%i</code> ve <code>%o</code> belirteçlerinde basılamayan + karakterler ve diğer özel karakterler <code>\x<var>hh</var></code> + dizilimleri biçeminde öncelenmektedir. Burada <var>hh</var> yerine + karakter numarasının onaltılık gösterimi yazılır. Bir tersbölü ile + öncelenmesi gereken <code>"</code> ve <code>\</code> ile + <code>\n</code>, <code>\t</code> gibi C tarzı gösterimler bu kuralın + dışındadır. 2.0.46 sürümünün öncesinde bu dizgeler öncelenmezdi ve ham + günlük dosyalarıyla çalışırken dikkatli olmak gerekirdi.</p> + + <p>2.0 sürümünden beri 1.3 sürümünün aksine <code>%b</code> ve + <code>%B</code> biçem belirteçleri, istemciye gönderilen bayt sayısını + değil, HTTP yanıtının bayt sayısını ifade ederdi (bu yanıt, örneğin, + SSL kullanıldığında veya bağlantı koptuğunda farklı uzunlukta olur). + Artık, ağa gönderilen gerçek bayt sayısını günlüğe kaydetmek için + <code class="module"><a href="../mod/mod_logio.html">mod_logio</a></code> modülü tarafından sağlanan <code>%O</code> + biçem belirteci kullanılmaktadır.</p> + + <div class="note"> + <p>Ek bilgi: <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> standat bir eylemci olarak değil + hızlı bir eylemci olarak gerçeklenmiştir. Bu nedenle, içerik + arabelleklemesi sözkonusu olduğunda <code>%R</code> biçem dizgesi + herhangi bir eylemci bilgisi döndürmeyecektir.</p> + </div> + + + + <h3><a name="examples" id="examples">Örnekler</a></h3> + + <p>Genelde herkesçe kullanılan günlük kaydı biçemleme dizgelerinden + bazıları:</p> + + <dl> + <dt>Ortak Günlük Biçemi (OGB)</dt> + <dd><code>"%h %l %u %t \"%r\" %>s %b"</code></dd> + + <dt>Sanal Konaklı Ortak Günlük Biçemi</dt> + <dd><code>"%v %h %l %u %t \"%r\" %>s %b"</code></dd> + + <dt>NCSA uzun/birleşik günlük biçemi</dt> + <dd><code>"%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" + \"%{User-agent}i\""</code></dd> + + <dt>Referer başlığını içeren günlük biçemi</dt> + <dd><code>"%{Referer}i -> %U"</code></dd> + + <dt>User-agent başlığını içeren günlük biçemi</dt> + <dd><code>"%{User-agent}i"</code></dd> + </dl> + + <p><code>msec_frac</code> gibi ek biçem dizgeciklerini kullanan bir zaman + biçemi belirtmek isterseniz <code>%{format}t</code> biçem dizgesini + defalarca kullanabilirsiniz:</p> + <dl> + <dt>Milisaniyeleri de içeren bir zaman damgası</dt> + <dd><code>"%{%d/%b/%Y %T}t.%{msec_frac}t %{%z}t"</code></dd> + </dl> + +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="security" id="security">Güvenlik Kaygıları</a></h2> + <p>Günlük dosyarının kaydedildiği dizine sunucuyu başlatan kullanıcı + dışında diğer kullanıcılar tarafından yazılabiliyor olması halinde + güvenliğinizden nasıl feragat etmiş olacağınız <a href="../misc/security_tips.html#serverroot">güvenlik ipuçları</a> + belgesinde açıklanmıştır.</p> +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="BufferedLogs" id="BufferedLogs">BufferedLogs</a> <a name="bufferedlogs" id="bufferedlogs">Yönergesi</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Açıklama:</a></th><td>Günlük girdilerini diske yazmadan önce bellekte tamponlar +</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Sözdizimi:</a></th><td><code>BufferedLogs On|Off</code></td></tr> +<tr><th><a href="directive-dict.html#Default">Öntanımlı:</a></th><td><code>BufferedLogs Off</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Bağlam:</a></th><td>sunucu geneli</td></tr> +<tr><th><a href="directive-dict.html#Status">Durum:</a></th><td>Temel</td></tr> +<tr><th><a href="directive-dict.html#Module">Modül:</a></th><td>mod_log_config</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Uyumluluk:</a></th><td>2.0.41 ve sonrasında mevcuttur.</td></tr> +</table> + <p><code class="directive">BufferedLogs</code> yönergesi, + <code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code> modülünün çeşitli günlük girdilerini her + isteğin hemen ardından tek tek değil, bir bütün halinde diske yazılmak + üzere bellekte saklanmasını sağlar. Bu, bazı sistemlerde daha verimli + disk erişimi, dolayısıyla daha yüksek başarım sağlayabilir. Sadece + sunucu geneli için belirtilebilir, sanal konaklar için ayrı ayrı + yapılandırılamaz.</p> + + <div class="note">Bir çökme günlük verisi kaybına sebep olacağından bu yönerge + dikkatli kullanılmalıdır.</div> + +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="CustomLog" id="CustomLog">CustomLog</a> <a name="customlog" id="customlog">Yönergesi</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Açıklama:</a></th><td>Günlük dosyasın ismini ve girdi biçemini belirler.</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Sözdizimi:</a></th><td><code>CustomLog <var>dosya</var>|<var>borulu-süreç</var> +<var>biçem</var>|<var>takma-ad</var> +[env=[!]<var>ortam-değişkeni</var>]| +expr=<var>ifade</var>]</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Bağlam:</a></th><td>sunucu geneli, sanal konak</td></tr> +<tr><th><a href="directive-dict.html#Status">Durum:</a></th><td>Temel</td></tr> +<tr><th><a href="directive-dict.html#Module">Modül:</a></th><td>mod_log_config</td></tr> +</table> + <p><code class="directive">CustomLog</code> yönergesi istekleri günlüğe kaydetmek + için kullanılır. Yönerge ile bir günlük biçemi belirtilebilir ve günlük + kaydı isteğin özelliklerine bağlı olarak ortam değişkenleri vasıtasıyla + şarta bağlı kılınabilir.</p> + + <p>İlk argümanda günlüğün yazılacağı yer belirtilir. İki tür yer + belirtilebilir:</p> + + <dl> + <dt><var>dosya</var></dt> + <dd><code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> yönergesinin + değerine göreli bir dosya ismi.</dd> + + <dt><var>borulu-süreç</var></dt> + <dd>"<code>|</code>" boru karakteri ile öncelenmiş olarak günlük + bilgisini standart girdisinden kabul edecek sürecin ismi (veya komut + satırı) Daha fazla bilgi için <a href="../logs.html#piped">borulu + günlükler</a>e bakınız. + + <div class="warning"><h3>Güvenlik:</h3> + <p>Bir borulu süreç kullanılmışsa, süreç <code class="program"><a href="../programs/httpd.html">httpd</a></code>’yi + başlatan kullanıcı tarafından başlatılacaktır. Sunucu root tarafından + başlatılıyorsa bu root olacaktır; bu bakımdan günlük kaydını alacak + programın güvenilir olması önemlidir.</p> + </div> + <div class="warning"><h3>Bilginize</h3> + <p>Dosya yolunu belirtirken tersbölü çizgisi kullanılan Unix dışı + platformlarda bile yapılandırma dosyasında bu amaçla normal bölü + çizgilerini kullanmaya özen gösterilmelidir.</p> + </div></dd> + </dl> + + <p>İkinci argümanda günlüğe ne yazılacağı belirtilir. Ya evvelce + <code class="directive"><a href="#logformat">LogFormat</a></code> yönergesi ile + tanımlanmış bir <var>takma-ad</var> ya da içeriği <a href="#formats">Günlük Girdilerinin Kişiselleştirilmesi</a> bölümünde + açıklanmış bir <var>biçem</var> dizgesi olabilir.</p> + + <p>Örneğin, aşağıdaki iki yönerge kümesi aynı etkiye sahiptir:</p> + + <pre class="prettyprint lang-config"># Biçem dizgesi yerine takma ad içeren CustomLog +LogFormat "%h %l %u %t \"%r\" %>s %b" common +CustomLog "logs/access_log" common + +# Biçem dizgesinin kendisini içeren CustomLog +CustomLog "logs/access_log" "%h %l %u %t \"%r\" %>s %b"</pre> + + + <p>Üçüncü argüman isteğe bağlı olup,belli bir isteğin günlüğe kaydedilip + kaydedilmeyeceğini belirler. Koşul, sunucu <a href="../env.html">ortamında</a> belli bir değişkenin varlığı veya + yokluğu olabilir (bir '<code>env=!<var>isim</var></code>' durumu). + İstenirse koşul keyfi bir mantıksal <a href="../expr.html">ifade</a> + olarak da belirtilebilir. Eğer koşul sağlanmazsa istek günlüğe + kaydedilmez. İfadede bulunan HTTP başlıklarına başvurular bu başlık + isimlerinin Vary başlığına eklenmesine sebep olmaz.</p> + + <p>Ortam değişkenleri <code class="module"><a href="../mod/mod_setenvif.html">mod_setenvif</a></code> + ve/veya <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> modülleri kullanılarak her istek + için ayrı ayrı atanabilir. Örneğin, GIF biçemli resimler için yapılan + istekleri ana günlük dosyasına değil de başka bir dosyaya kaydetmek + isterseniz:</p> + + <pre class="prettyprint lang-config">SetEnvIf Request_URI \.gif$ gif-image +CustomLog "gif-requests.log" common env=gif-image +CustomLog "nongif-requests.log" common env=!gif-image</pre> + + + <p>Veya eski <code>RefererIgnore</code> yönergesinin davranışını taklit + etmek isterseniz:</p> + + <pre class="prettyprint lang-config">SetEnvIf Referer example\.com localreferer +CustomLog "referer.log" referer env=!localreferer</pre> + + +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="GlobalLog" id="GlobalLog">GlobalLog</a> <a name="globallog" id="globallog">Yönergesi</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Açıklama:</a></th><td>Günlük dosyasının ismini ve biçemini belirler</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Sözdizimi:</a></th><td><code>GlobalLog <var>dosya</var>|<var>boru</var>|<var>sağlayıcı</var> +<var>biçem</var>|<var>takma_ad</var> +[env=[!]<var>ortam_değişkeni</var>| +expr=<var>ifade</var>]</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Bağlam:</a></th><td>sunucu geneli</td></tr> +<tr><th><a href="directive-dict.html#Status">Durum:</a></th><td>Temel</td></tr> +<tr><th><a href="directive-dict.html#Module">Modül:</a></th><td>mod_log_config</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Uyumluluk:</a></th><td>Apache HTTP Sunucusunun 2.4.19 ve sonraki sürümlerinde kullanılabilir.</td></tr> +</table> + + <p><code class="directive">GlobalLog</code> yönergesi ana sunucu yapılandırması ve + tüm tanımlı sanal konaklarca paylaşılan bir günlük tanımlar.</p> + + <p><code class="directive">GlobalLog</code> yönergesi aşağıdaki farklar dışında + <code class="directive">CustomLog</code> yönergesine eşdeğerdir:</p> + <ul> + <li><code class="directive">GlobalLog</code> sanal konak bağlamında belirtilirse + geçersizdir.</li> + <li>Sanal konaklar küresel bağlamda belirtilmiş bir + <code class="directive">CustomLog</code> yönergesinin tersine + <code class="directive">GlobalLog</code> yönergesini kendi + <code class="directive">CustomLog</code> yönergesiymiş gibi kullanır.</li> + </ul> + +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="LogFormat" id="LogFormat">LogFormat</a> <a name="logformat" id="logformat">Yönergesi</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Açıklama:</a></th><td>Bir günlük dosyasında kullanılmak üzere girdi biçemi tanımlar. +</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Sözdizimi:</a></th><td><code>LogFormat <var>biçem</var>|<var>takma-ad</var> +[<var>takma-ad</var>]</code></td></tr> +<tr><th><a href="directive-dict.html#Default">Öntanımlı:</a></th><td><code>LogFormat "%h %l %u %t \"%r\" %>s %b"</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Bağlam:</a></th><td>sunucu geneli, sanal konak</td></tr> +<tr><th><a href="directive-dict.html#Status">Durum:</a></th><td>Temel</td></tr> +<tr><th><a href="directive-dict.html#Module">Modül:</a></th><td>mod_log_config</td></tr> +</table> + <p>Bu yönerge erişim günlüğü dosyasının girdi biçemini belirler.</p> + + <p><code class="directive">LogFormat</code> yönergesi iki şekilde kullanılabilir. + Tek argüman belirtilebilen ilkinde daha sonra + <code class="directive">TransferLog</code> yönergelerinde belirtilen günlüklerde + kullanılmak üzere günlük biçemini belirler. Bu günlük biçemi yukarıda + açıklanan <a href="#formats"><var>biçem</var></a> belirteçlerinden + oluşur. Bu tek argüman yerine aşağıda açıklandığı gibi önceki bir + <code class="directive">LogFormat</code> yönergesinde tanımlanmış bir günlük + biçemine atıf yapan bir <var>takma-ad</var> da belirtilebilir.</p> + + <p><code class="directive">LogFormat</code> yönergesinin ikinci kullanım şeklinde + <var>biçem</var> bir <var>takma-ad</var> için tanımlanır. Bu takma ad + daha sonraki <code class="directive">LogFormat</code> veya <code class="directive"><a href="#customlog">CustomLog</a></code> yönergelerinde aynı biçem + dizgesini uzun uzadıya yazmamak için <var>takma-ad</var> olarak + kullanılır. Bir <code class="directive">LogFormat</code> yönergesi bir takma ad + tanımlamaktan <strong>başka bir şey yapmaz</strong>; yani, yaptığı iş + sadece bir takma ad tanımlamaktan ibarettir, biçemi uygulamaz veya + biçemi öntanımlı hale getirmez. Bu bakımdan sonraki <code class="directive"><a href="#transferlog">TransferLog</a></code> yönergelerini de + etkilemeyecektir. Ayrıca, <code class="directive">LogFormat</code> yönergesi bir + takma ada başka bir takma ad tanımlamakta da kullanılamaz. Bir takma + adın yüzde imi (<code>%</code>) içeremeyeceğine de dikkat ediniz.</p> + + <pre class="prettyprint lang-config">LogFormat "%v %h %l %u %t \"%r\" %>s %b" vhost_common</pre> + + +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="TransferLog" id="TransferLog">TransferLog</a> <a name="transferlog" id="transferlog">Yönergesi</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Açıklama:</a></th><td>Bir günlük dosyasının yerini belirtir.</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Sözdizimi:</a></th><td><code>TransferLog <var>dosya</var>|<var>borulu-süreç</var> +[<var>takma-ad</var>]</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Bağlam:</a></th><td>sunucu geneli, sanal konak</td></tr> +<tr><th><a href="directive-dict.html#Status">Durum:</a></th><td>Temel</td></tr> +<tr><th><a href="directive-dict.html#Module">Modül:</a></th><td>mod_log_config</td></tr> +</table> + <p>Bir günlük biçemi tanımlanmasını ve şarta bağlı günlük kaydını mümkün + kılmaması haricinde <code class="directive"><a href="#customlog">CustomLog</a></code> yönergesi gibidir. Günlük biçemi yerine kendinden + önce yer alan bir <code class="directive"><a href="#logformat">LogFormat</a></code> yönergesinde tanımlanan + bir takma ad kullanılır. Açıkça bir günlük biçemi takma adı + belirtilmedikçe Ortak Günlük Biçemi öntanımlıdır.</p> + + <pre class="prettyprint lang-config">LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\"" +TransferLog "logs/access_log"</pre> + + +</div> +</div> +<div class="bottomlang"> +<p><span>Mevcut Diller: </span><a href="../en/mod/mod_log_config.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_log_config.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | +<a href="../ja/mod/mod_log_config.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_log_config.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | +<a href="../tr/mod/mod_log_config.html" title="Türkçe"> tr </a></p> +</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">Yorumlar</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 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 Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div> +<script type="text/javascript"><!--//--><![CDATA[//><!-- +var comments_shortname = 'httpd'; +var comments_identifier = 'http://httpd.apache.org/docs/2.4/mod/mod_log_config.html'; +(function(w, d) { + if (w.location.hostname.toLowerCase() == "httpd.apache.org") { + d.write('<div id="comments_thread"><\/div>'); + var s = d.createElement('script'); + s.type = 'text/javascript'; + s.async = true; + s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; + (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); + } + else { + d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); + } +})(window, document); +//--><!]]></script></div><div id="footer"> +<p class="apache">Copyright 2023 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p> +<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- +if (typeof(prettyPrint) !== 'undefined') { + prettyPrint(); +} +//--><!]]></script> +</body></html>
\ No newline at end of file |