Sun Microsystems Netscape Enterprise Server, Administrator'S Manual

Page: 190 / 532

Setting Log Preferences
190 Netscape Enterprise Server Administrator’s Guide
For more information on the NSAPI logging functions, including valid directives
and parameters, see the
NSAPI Programmer’s Guide for Enterprise Server 4.0.
Easy Cookie Logging
In previous versions of Enterprise Server, if you want to log the value of a
specific cookie, you had to write a plugin API that extracted the cookie’s value
out of the “
Cookie
” header sent by the client, insert this value as a new
variable to the request’s
pblock
, and log that new variable.
Enterprise Server 4.0 has an easy way to log a specific cookie using the flexlog
facility. Add “
Req->headers.cookie. cookie_name
” to the line that
initializes the
felxlog
subsystem in the configuration file
obj.conf
. This
logs the value of the cookie variable
cookie_name
if the cookie variable is
present in the request’s headers, and logs “-” if it is not present.
Relaxed Logging
There is an unpleasant side effect to logging a variable other than the following
standard variables:
Status
,
Content-Length
,
Client-Host
,
Full-
Request
,
Method
,
Protocol
,
Query-String
,
URI
,
Referer
,
User-
Agent
,
Authorization
, and
Auth-User
. Because other variables cannot
be provided by the static file accelerator cache, the accelerator cache will not
be used at all. Therefore performance numbers will decrease significantly for
requests that would typically benefit from the accelerator, such as static files
and images.
Enterprise Server 4.0 eases the requirements of the log subsystem. Adding
“
relaxed. logname = true
” to the “
flex-init
” line in
obj.conf
allows
you to log variables outside of the standard set and still use the accelerator
cache. If the accelerator is used, unavailable variables are logged as “
-
”. The
server does not use the accelerator for dynamic content such as CGI scrips or
SHTML pages, so all the variables are always logged correctly for these
requests.