mirror of
https://github.com/apache/httpd.git
synced 2025-08-30 15:01:14 +03:00
c1a02e3595
adding of some docs that Paul Sutton sent to the list on October 10th. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@77082 13f79535-47bb-0310-9956-ffa450edef68
80 lines
2.5 KiB
HTML
80 lines
2.5 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">
|
|
<HTML>
|
|
<HEAD>
|
|
<TITLE>Apache module mod_usertrack</TITLE>
|
|
</HEAD>
|
|
|
|
<BODY>
|
|
<!--#include virtual="header.html" -->
|
|
<H1>Module mod_usertrack</h1>
|
|
|
|
Previous releases of Apache have included a module which generates a
|
|
'clickstream' log of user activity on a site, using cookies. This was
|
|
called the "cookies" module, mod_cookies. In Apache 1.2 and later, this module
|
|
has
|
|
been renamed the "user tracking" module, mod_usertrack. This module
|
|
has been
|
|
simplified and new directives added.
|
|
|
|
<hr>
|
|
|
|
<h2>Logging</h2>
|
|
|
|
Previously, the cookies module (now the user tracking module) did its
|
|
own logging, using the <tt>CookieLog</tt> directive. In this release,
|
|
this module does no logging at all. Instead, a configurable log
|
|
format file should be used to log user clickstreams. This is possible
|
|
because the logging module now allows <a
|
|
href="multilogs.html">multiple log files</a>. The cookie itself is
|
|
logged by using the text <tt>%{cookie}n </tt>
|
|
|
|
in the log file format. For example:
|
|
<pre>
|
|
CustomLog logs/clickstream "%{cookie}i %r %t"
|
|
</pre>
|
|
|
|
For backward compatibility the configurable log module implements the
|
|
old <tt>CookieLog</tt> directive, but this should be upgrade to the
|
|
above <tt>CustomLog</tt> directive.
|
|
|
|
<h2>Directives</h2>
|
|
|
|
<ul>
|
|
<li><a href="#cookieenable">CookieEnable</a>
|
|
<li><a href="#cookieexpires">CookieExpires</a>
|
|
</ul>
|
|
|
|
<hr>
|
|
|
|
<a name="cookieexpires"><h2>CookieEnable</h2></A>
|
|
<strong>Sytnax:</strong> CookieEnable <em>on | off</em><br>
|
|
<strong>Context:</strong> server config, virtual host, directory,
|
|
.htaccess<br>
|
|
<strong>Override:</strong> FileInfo<br>
|
|
<strong>Status:</strong> optional<br>
|
|
<strong>Module:</strong> mod_usertrack<p>
|
|
|
|
When the user track module is compiled in, Apache will start
|
|
sending a user-tracking cookie for all new requests. This directive
|
|
can be used to turn this behavior on or off on a per-server or
|
|
per-directory basis.
|
|
|
|
<a name="cookieexpires"><h2>CookieExpires</h2></A>
|
|
<strong>Sytnax:</strong> CookieExpires <em>expiry-period</em><br>
|
|
<strong>Context:</strong> server config, virtual host<br>
|
|
<strong>Status:</strong> optional<br>
|
|
<strong>Module:</strong> mod_usertrack<p>
|
|
|
|
When used,
|
|
this directive sets an expiry time on the cookie generated by the
|
|
usertrack module. The <i>expiry-period</i> can be given either as a
|
|
number of seconds, or in the format such as "2 weeks 3 days 7 hours".
|
|
Valid denominations are: years, months, weeks, hours, minues and
|
|
seconds.
|
|
|
|
|
|
<!--#include virtual="footer.html" -->
|
|
</BODY>
|
|
</HTML>
|
|
|