icm/HTTP/logging_<xx>

This parameter controls HTTP logging in the ICM or SAP Web Dispatcher if this is functioning as a server. If the ICM or SAP Web Dispatcher is functioning as a client, profile parameter icm/HTTP/logging_client_<xx> is used to log HTTP requests.

Structure:

Work area	Internet Communication Manager, SAP Web Dispatcher
Unit	Character string
Default value	-
Dynamically changeable	No

Syntax:

icm/HTTP/logging_<xx> =  PREFIX=<URL prefix>, LOGFILE=<log file name> [, LOGFORMAT=<format>][, FILTER=<filter>][, MAXSIZEKB=<size in KBytes>] [,
      SWITCHTF=<options>][, FILEWRAP=on][, FLUSH=TRUE|FALSE][, ACTIVE=TRUE|FALSE]

Tip The indexes of ICM and SAP Web Dispatcher vector parameters do not have to be assigned sequentially, they can normally contain gaps. Exceptions are the two profile parameters icm/HTTP/server_cache and is/HTTP/virt_host. See the metadata of the respective profile parameter.

Description of the Subparameters:

PREFIX

URL prefix that is called for this HTTP subhandler.

Example /.

LOGFILE

Name of the output file in the file system. You can attach another timestamp to the file name.

LOGFORMAT

There are the following predefined formats for log files:

CLF - common Log file format:

10.18.104.36 - - [15/Oct/2007:16:18:35 +0100] "GET /dummy?para=100&user=sap HTTP/1.0" 200 86
CLFMOD - modified common log file format:

10.18.104.36 - - [15/Oct/2007:16:18:35 +0100] "GET /dummy HTTP/1.0" 200 86

The form fields and URI parameters are not written to the trace file (for security reasons these values are not saved to the log file.)
SAP - SAP log file format:

[15/Oct/2007:15:41:35 +0100] 10.18.104.36 - - "GET /dummy HTTP/1.0" 200 86 10

The processing time in milliseconds in the application server is also logged:
SAPSMD:

[15/Oct/2007:15:41:35 +0100] - "GET /dummy HTTP/1.0" 200 86 [10] h[A7594F39ED9F7C41BABA7397F8070718-1-5] |

Log format for tracking HTTP requests using the HTTP header field X Correlation ID:
SAPSMD2:

Log format for tracking HTTP requests using the HTTP header field X Correlation ID:

This log format contains the output of the full request and response header.
User-Defined Formats:

If you want to use another format, you can configure this using the format string. Numerous placeholders are available for this.

FILTER

The filter property specifies that an HTTP request is logged only when a certain header field (for example, an HTTP header field) is in the request or response. If more than one field is specified in a filter, the fields are linked with an "or".

MAXSIZEKB

MAXSIZEKB is the maximum size of the log file in kilobytes.

If this size is exceeded, the current file is closed and a new one (with a new name) is opened.

If FILEWRAP=on was specified, no new file is opened.

SWITCHTF

With SWITCHTF you can configure that a new log file is created at the times specified.

FILEWRAP

With FILEWRAP you can configure whether the old log file is overwritten or archived when the new one is created. If FILEWRAP=on is selected, every time a new file is opened, the existing log file is reset and overwritten.

FLUSH

With FLUSH you can configure whether HTTP log entries are written directly to the file system. This option can cause a reduction in performance on slow file systems. Possible values are TRUE/FALSE. The default value is FALSE, except for LOGFORMAT=SAPSMD and LOGFORMAT=SAPSMD2, where the default value is TRUE.

ACTIVE

This handler (in this case the log handler) is active or inactive.

Possible Values: TRUE / FALSE. The default value is TRUE.

Example

Example of Predefined Log Format:

icm/HTTP/logging_0 = PREFIX=/, LOGFILE=access_log-%y-%m, MAXSIZEKB=10000, SWITCHTF=day, LOGFORMAT=SAPSMD
Example of Predefined Log Format:

icm/HTTP/logging_0 = PREFIX=/, LOGFILE=access_log-%y-%m, MAXSIZEKB=10000, SWITCHTF=day, LOGFORMAT=%t %h %u - "%r2" %s %b %L

This user-defined format correponds to the SAP format SAPSMD.