AddLog
After the server has responded to the request, the AddLog directives are executed to record information about the transaction.
If an object contains more than one AddLog directive, all are executed.
The following AddLog-class functions are described in detail in this section:
-
common-log records information about the request in the common log format.
-
flex-log records information about the request in a flexible, configurable format.
-
match-browser matches specific strings in the User-Agent string supplied by the browser, and then modifies the behavior of Proxy Server based upon the results by setting values for specified variables.
-
record-useragent records the client’s IP address and User-Agent header.
-
set-variable enables you to change server settings based upon conditional information in a request, and to manipulate variables in parameter blocks by using specific commands.
common-log
Applicable in AddLog-class directives.
The common-log function records request-specific data in the common log format used by most HTTP servers. A log analyzer is locatedin the /extras/log_anly directory for Proxy Server.
The common log must have been initialized previously by the init-clf function. For information about rotating logs, see flex-rotate-init in the Oracle iPlanet Web Proxy Server 4.0.14 NSAPI Developer’s Guide.
There are also a number of free statistics generators for the common log format.
Parameters
The following table describes parameters for the common-log function.
Table 5–127 common-log Parameters|
Parameter |
Description |
|---|---|
|
name |
(Optional) Provides the name of a log file which must have been given as a parameter to the init-clf function in magnus.conf. If no name is given, the entry is recorded in the global log file. |
|
(Optional) Instructs the server to log the IP address of the remote client rather than looking up and logging the DNS name. This function improves performance if DNS is off in the magnus.conf file. The value of iponly has no significance, and merely must be present, for example, iponly=1. |
|
|
bucket |
(Optional) Common to all obj.conf functions. |
Examples
# Log all accesses to the global log file AddLog fn=common-log # Log accesses from outside our subnet (198.93.5.*) to nonlocallog <Client ip="*~198.93.5.*"> AddLog fn=common-log name=nonlocallog</Client> |
See Also
flex-log
Applicable in AddLog-class directives.
The flex-log function records request-specific data in a flexible log format. This function may also record requests in the common log format. A log analyzer is located in the /extras/flexanlg directory for Proxy Server.
There are also a number of free statistics generators for the common log format.
The log format is specified by the flex-init function call. For information about rotating logs, see flex-rotate-init in the Oracle iPlanet Web Proxy Server 4.0.14 NSAPI Developer’s Guide.
Parameters
The following table describes parameters for the flex-log function.
Table 5–128 flex-log Parameters|
Parameter |
Description |
|---|---|
|
(Optional) Provides the name of a log file, which must have been given as a parameter to the flex-init function in magnus.conf. If no name is given, the entry is recorded in the global log file. |
|
|
(Optional) Instructs the server to log the IP address of the remote client rather than looking up and logging the DNS name. This function improves performance if DNS is off in the magnus.conf file. The value of iponly has no significance, and merely must br present, for example, iponly=1. |
|
|
bucket |
(Optional) Common to all obj.conf functions. |
|
Specifies the number of buffers for a given log file. The default value is determined by the server. Access log entries can be logged in chronological order by using a single buffer per log file. Add buffers-per-file=1 to the Init fn=flex-init line in magnus.conf. This setting ensures that requests are logged in chronological order. This approach results in decreased performance when the server is under heavy load. |
Examples
# Log all accesses to the global log file AddLog fn=flex-log # Log accesses from outside our subnet (198.93.5.*) to nonlocallog <Client ip="*~198.93.5.*"> AddLog fn=flex-log name=nonlocallog</Client> |
See Also
match-browser
See match-browser.
record-useragent
Applicable in AddLog-class directives.
The record-useragent function records the IP address of the client, followed by its User-Agent HTTP header. This value indicates what version of the client was used for this transaction.
Parameters
The following table describes parameters for the record-useragent function.
Table 5–129 record-useragent Parameters|
Parameter |
Description |
|---|---|
|
name |
(Optional) Provides the name of a log file, which must have been given as a parameter to the init-clf function in magnus.conf. If no name is given, the entry is recorded in the global log file. |
|
bucket |
(Optional) Common to all obj.conf functions. |
Example
# Record the client ip address and user-agent to browserlogAddLog fn=record-useragent name=browserlog |
See Also
set-variable
Applicable in all stage directives. The set-variable SAF enables you to change server settings based upon conditional information in a request, and to manipulate variables in parameter blocks by using specific commands. See set-variable.
- © 2010, Oracle Corporation and/or its affiliates