mod_logio.html.en revision 1f1b6bf13313fdd14a45e52e553d3ff28689b717
27c043596ef154c881a7d572c65d32cbf537685cnd<?xml version="1.0" encoding="ISO-8859-1"?>
27c043596ef154c881a7d572c65d32cbf537685cnd<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
27c043596ef154c881a7d572c65d32cbf537685cnd<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
27c043596ef154c881a7d572c65d32cbf537685cnd XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
27c043596ef154c881a7d572c65d32cbf537685cnd This file is generated from xml source: DO NOT EDIT
27c043596ef154c881a7d572c65d32cbf537685cnd XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd -->
96ad5d81ee4a2cc66a4ae19893efc8aa6d06fae7jailletc<title>mod_logio - Apache HTTP Server Version 2.5</title>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
d29d9ab4614ff992b0e8de6e2b88d52b6f1f153erbowen<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" />
2e545ce2450a9953665f701bb05350f0d3f26275nd<script src="/style/scripts/prettify.min.js" type="text/javascript">
d29d9ab4614ff992b0e8de6e2b88d52b6f1f153erbowen</script>
d29d9ab4614ff992b0e8de6e2b88d52b6f1f153erbowen
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<link href="/images/favicon.ico" rel="shortcut icon" /></head>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<body>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<div id="page-header">
af33a4994ae2ff15bc67d19ff1a7feb906745bf8rbowen<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/quickreference.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>
3f08db06526d6901aa08c110b5bc7dde6bc39905nd<p class="apache">Apache HTTP Server Version 2.5</p>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<img alt="" src="/images/feather.gif" /></div>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="/images/left.gif" /></a></div>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<div id="path">
3f08db06526d6901aa08c110b5bc7dde6bc39905nd<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.5</a> &gt; <a href="./">Modules</a></div>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<div id="page-content">
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<div id="preamble"><h1>Apache Module mod_logio</h1>
3b3b7fc78d1f5bfc2769903375050048ff41ff26nd<div class="toplang">
4aa805f8500255bc52a4c03259fe46df10a1d07cyoshiki<p><span>Available Languages: </span><a href="/en/mod/mod_logio.html" title="English">&nbsp;en&nbsp;</a> |
7f5b59ccc63c0c0e3e678a168f09ee6a2f51f9d0nd<a href="/ja/mod/mod_logio.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
1d980e5489836e977ba59b419e27b0ec875c4bd3takashi<a href="/ko/mod/mod_logio.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
f086b4b402fa9a2fefc7dda85de2a3cc1cd0a654rjung<a href="/tr/mod/mod_logio.html" hreflang="tr" rel="alternate" title="T�rk�e">&nbsp;tr&nbsp;</a></p>
3b3b7fc78d1f5bfc2769903375050048ff41ff26nd</div>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Logging of input and output bytes per request</td></tr>
49597532146e35a9726761912865184aff6bd3b7yoshiki<tr><th><a href="module-dict.html#Status">Status:</a></th><td>Extension</td></tr>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<tr><th><a href="module-dict.html#ModuleIdentifier">Module�Identifier:</a></th><td>logio_module</td></tr>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<tr><th><a href="module-dict.html#SourceFile">Source�File:</a></th><td>mod_logio.c</td></tr></table>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<h3>Summary</h3>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd
27c043596ef154c881a7d572c65d32cbf537685cnd
27c043596ef154c881a7d572c65d32cbf537685cnd <p>This module provides the logging of input and output number of
27c043596ef154c881a7d572c65d32cbf537685cnd bytes received/sent per request. The numbers reflect the actual bytes
27c043596ef154c881a7d572c65d32cbf537685cnd as received on the network, which then takes into account the
27c043596ef154c881a7d572c65d32cbf537685cnd headers and bodies of requests and responses. The counting is done
27c043596ef154c881a7d572c65d32cbf537685cnd before SSL/TLS on input and after SSL/TLS on output, so the numbers
27c043596ef154c881a7d572c65d32cbf537685cnd will correctly reflect any changes made by encryption.</p>
27c043596ef154c881a7d572c65d32cbf537685cnd
27c043596ef154c881a7d572c65d32cbf537685cnd <p>This module requires <code class="module"><a href="/mod/mod_log_config.html">mod_log_config</a></code>.</p>
27c043596ef154c881a7d572c65d32cbf537685cnd
ce46b8465b8a7b38499712404e338645b349bcdccovener <div class="note">When KeepAlive connections are used with SSL, the overhead of the SSL
ce46b8465b8a7b38499712404e338645b349bcdccovener handshake is reflected in the byte count of the first request on the
ce46b8465b8a7b38499712404e338645b349bcdccovener connection. When per-directory SSL renegotiation occurs, the bytes are associated
ce46b8465b8a7b38499712404e338645b349bcdccovener with the request that triggered the renegotiation.</div>
ce46b8465b8a7b38499712404e338645b349bcdccovener
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd</div>
c44eeebd065e2c8cd028016b45c58afb480aaf8fdruggeri<div id="quickview"><h3>Topics</h3>
c44eeebd065e2c8cd028016b45c58afb480aaf8fdruggeri<ul id="topics">
c44eeebd065e2c8cd028016b45c58afb480aaf8fdruggeri<li><img alt="" src="/images/down.gif" /> <a href="#formats">Custom Log Formats</a></li>
c44eeebd065e2c8cd028016b45c58afb480aaf8fdruggeri</ul><h3 class="directives">Directives</h3>
0bd1ddab48139fbbe68f4e257fe669dc19f58fe9rbowen<ul id="toc">
0bd1ddab48139fbbe68f4e257fe669dc19f58fe9rbowen<li><img alt="" src="/images/down.gif" /> <a href="#logiotrackttfb">LogIOTrackTTFB</a></li>
0bd1ddab48139fbbe68f4e257fe669dc19f58fe9rbowen</ul>
c44eeebd065e2c8cd028016b45c58afb480aaf8fdruggeri<h3>See also</h3>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<ul class="seealso">
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<li><code class="module"><a href="/mod/mod_log_config.html">mod_log_config</a></code></li>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<li><a href="/logs.html">Apache Log Files</a></li>
30471a4650391f57975f60bbb6e4a90be7b284bfhumbedooh</ul><ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<div class="section">
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<h2><a name="formats" id="formats">Custom Log Formats</a></h2>
27c043596ef154c881a7d572c65d32cbf537685cnd
27c043596ef154c881a7d572c65d32cbf537685cnd
1eae0091cf6a35da681598538728df98df20badbtrawick <p>This module adds three new logging directives. The characteristics of the
ace1172cbd86221d041b0a647147a1b0e60d4ba2nd request itself are logged by placing "<code>%</code>" directives in
ace1172cbd86221d041b0a647147a1b0e60d4ba2nd the format string, which are replaced in the log file by the values as
ace1172cbd86221d041b0a647147a1b0e60d4ba2nd follows:</p>
ace1172cbd86221d041b0a647147a1b0e60d4ba2nd
db99fa79ac42b9cc42b63386eb289aecb0f3cb9cnd <table class="bordered"><tr class="header"><th>Format&nbsp;String</th>
ace1172cbd86221d041b0a647147a1b0e60d4ba2nd <th>Description</th></tr>
9860a26381c920213ebbc3be9297dbf45cdfb3batrawick<tr><td><code>%I</code></td>
ace1172cbd86221d041b0a647147a1b0e60d4ba2nd <td>Bytes received, including request and headers, cannot be
ace1172cbd86221d041b0a647147a1b0e60d4ba2nd zero.</td></tr>
9860a26381c920213ebbc3be9297dbf45cdfb3batrawick<tr class="odd"><td><code>%O</code></td>
ace1172cbd86221d041b0a647147a1b0e60d4ba2nd <td>Bytes sent, including headers, cannot be zero.</td></tr>
51e213aed94e1ca678a7551c8a215b8caed301e7jim<tr><td><code>%S</code></td>
9860a26381c920213ebbc3be9297dbf45cdfb3batrawick <td>Bytes transferred (received and sent), including request and headers,
1eae0091cf6a35da681598538728df98df20badbtrawick cannot be zero. This is the combination of %I and %O.<br />
1eae0091cf6a35da681598538728df98df20badbtrawick Available in Apache 2.4.7 and later</td></tr>
0bd1ddab48139fbbe68f4e257fe669dc19f58fe9rbowen<tr class="odd"><td><code>%^FB</code></td>
0bd1ddab48139fbbe68f4e257fe669dc19f58fe9rbowen <td>Delay in microseconds between when the request arrived and the
0bd1ddab48139fbbe68f4e257fe669dc19f58fe9rbowen first byte of the response headers are written. Only available if
0bd1ddab48139fbbe68f4e257fe669dc19f58fe9rbowen <code class="directive">LogIOTrackTTFB</code> is set to ON.
0bd1ddab48139fbbe68f4e257fe669dc19f58fe9rbowen </td></tr>
27c043596ef154c881a7d572c65d32cbf537685cnd</table>
27c043596ef154c881a7d572c65d32cbf537685cnd
27c043596ef154c881a7d572c65d32cbf537685cnd <p>Usually, the functionality is used like this:</p>
27c043596ef154c881a7d572c65d32cbf537685cnd
27c043596ef154c881a7d572c65d32cbf537685cnd <dl>
27c043596ef154c881a7d572c65d32cbf537685cnd <dt>Combined I/O log format:</dt>
27c043596ef154c881a7d572c65d32cbf537685cnd <dd><code>"%h %l %u %t \"%r\" %&gt;s %b \"%{Referer}i\"
27c043596ef154c881a7d572c65d32cbf537685cnd \"%{User-agent}i\" %I %O"</code></dd>
27c043596ef154c881a7d572c65d32cbf537685cnd </dl>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd</div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="directive-section"><h2><a name="LogIOTrackTTFB" id="LogIOTrackTTFB">LogIOTrackTTFB</a> <a name="logiotrackttfb" id="logiotrackttfb">Directive</a></h2>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<table class="directive">
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable tracking of time to first byte (TTFB)</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>LogIOTrackTTFB ON|OFF</code></td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>LogIOTrackTTFB OFF</code></td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>none</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_logio</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar</table>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>This directive configures whether this module tracks the delay
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar between the request being read and the first byte of the response
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar headers being written. The resulting value may be logged with the
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code>%^FB</code> format.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar</div>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd</div>
3b3b7fc78d1f5bfc2769903375050048ff41ff26nd<div class="bottomlang">
4aa805f8500255bc52a4c03259fe46df10a1d07cyoshiki<p><span>Available Languages: </span><a href="/en/mod/mod_logio.html" title="English">&nbsp;en&nbsp;</a> |
7f5b59ccc63c0c0e3e678a168f09ee6a2f51f9d0nd<a href="/ja/mod/mod_logio.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
1d980e5489836e977ba59b419e27b0ec875c4bd3takashi<a href="/ko/mod/mod_logio.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
f086b4b402fa9a2fefc7dda85de2a3cc1cd0a654rjung<a href="/tr/mod/mod_logio.html" hreflang="tr" rel="alternate" title="T�rk�e">&nbsp;tr&nbsp;</a></p>
727872d18412fc021f03969b8641810d8896820bhumbedooh</div><div class="top"><a href="#page-header"><img src="/images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&amp;A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
0d0ba3a410038e179b695446bb149cce6264e0abnd<script type="text/javascript"><!--//--><![CDATA[//><!--
727872d18412fc021f03969b8641810d8896820bhumbedoohvar comments_shortname = 'httpd';
cc7e1025de9ac63bd4db6fe7f71c158b2cf09fe4humbedoohvar comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_logio.html';
0d0ba3a410038e179b695446bb149cce6264e0abnd(function(w, d) {
cc7e1025de9ac63bd4db6fe7f71c158b2cf09fe4humbedooh if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
727872d18412fc021f03969b8641810d8896820bhumbedooh d.write('<div id="comments_thread"><\/div>');
0d0ba3a410038e179b695446bb149cce6264e0abnd var s = d.createElement('script');
0d0ba3a410038e179b695446bb149cce6264e0abnd s.type = 'text/javascript';
0d0ba3a410038e179b695446bb149cce6264e0abnd s.async = true;
ac082aefa89416cbdc9a1836eaf3bed9698201c8humbedooh s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
0d0ba3a410038e179b695446bb149cce6264e0abnd (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
0d0ba3a410038e179b695446bb149cce6264e0abnd }
0d0ba3a410038e179b695446bb149cce6264e0abnd else {
727872d18412fc021f03969b8641810d8896820bhumbedooh d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
0d0ba3a410038e179b695446bb149cce6264e0abnd }
0d0ba3a410038e179b695446bb149cce6264e0abnd})(window, document);
30471a4650391f57975f60bbb6e4a90be7b284bfhumbedooh//--><!]]></script></div><div id="footer">
205f749042ed530040a4f0080dbcb47ceae8a374rjung<p class="apache">Copyright 2015 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>
af33a4994ae2ff15bc67d19ff1a7feb906745bf8rbowen<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/quickreference.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[//><!--
0d0ba3a410038e179b695446bb149cce6264e0abndif (typeof(prettyPrint) !== 'undefined') {
7fec19672a491661b2fe4b29f685bc7f4efa64d4nd prettyPrint();
7fec19672a491661b2fe4b29f685bc7f4efa64d4nd}
7fec19672a491661b2fe4b29f685bc7f4efa64d4nd//--><!]]></script>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd</body></html>