Parameter
icm/HTTP/logging
Short text
Specify HTTP logging in ICM
Parameter Description
This is a vector parameter in the format [parameter name]_[index]. You do not need to enter ascending values for the index; that is, you could, for example, configure only icm/HTTP/logging_2.
You can use this parameter to control HTTP logging.
The parameter has the following syntax: icm/HTTP/logging = PREFIX=[URL prefix], LOGFILE=[name of log file], [, LOGFORMAT=[format of entries], FILTER=SAPSMD MAXSIZEKB=[max. size of log file], SWITCHTF=[options for new trace file], FILEWRAP=on]
This is explained below.
PREFIX
URL prefix that is called for this HTTP subhandler (for example, /).
LOGFILE
Name of the output file in the file system. So that the files have meaningful names, you can use the following options to specify the log file:
• %d Day of the month (1-31)
• %m Month (1-12)
• %y Year, in four digit format YYYY
• %h Hour (0-23)
• %t Minute (0-59)
• %s Seconds (0-59)
• %% ‘%’ character
LOGFILE=access_log-%d-%m-%y_%h:%t:%s returns a logfile with the name: access_log-15-12-2000_16:51:53
LOGFORMAT
There are the following predefined formats for log files: CLF (Common Logfile Format) with format: 10.18.104.36 – – [15/Dec/2000:16:18:35 +0100] “GET /dummy HTTP/1.0” 200 86
The following string creates the CLF format: %h %l %u %t “%r” %s %b
CLFMOD (Modified Common Logfile Format)
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.)
Example from above:
10.18.104.36 – – [15/Oct/2005:16:18:35 +0100] “GET /dummy HTTP/1.0” 200 86 SAP (SAP Logfile Format), with which the processing duration in the application server in milliseconds is also displayed:
Example from above:
[15/Oct/2005:15:41:35 +0100] 10.18.104.36 – – “GET /dummy HTTP/1.0” 200 86 10 SAPSMD (Log format for tracking HTTP requests using the HTTP Header field X-CorrelationID)
Example from above:
[15/Oct/2005:15:41:35 +0100] – “GET /dummy HTTP/1.0” 200 86 [10] h[A7594F39ED9F7C41BABA7397F8070718-1-5] |
The following string creates the SAPSMD format: %t – “%r0” %s %b [%L] h[%{X-CorrelationID}i] |
SAPSMD2 (Log format for tracking HTTP requests using the HTTP header field X-CorrelationID)
This log format contains the output of the full request and response header.
If you want to use another format, you can configure this using the format string.
You can use the following placeholders:
• %b Length of the response in bytes
• %r0 / %r 1. Row of an HTTP request with original path and form fields: for example, GET /sap(bD1kZSZjPTAwMA==)/bc/ping?lang=de HTTP/1.0
• %r1 1. Line of an HTTP request with the original path without form fields: for example, GET /sap(bD1kZSZjPTAwMA==)/bc/ping HTTP/1.0
• %r2 1. Line of an HTTP request with URL-decoded path without form fields: for example, GET /sap/bc/ping HTTP/1.0
• %f Name of the requested object without form fields
• %U Whole URI of a request (with form fields)
• %s OK code of the response
• %p0 Whole original URI of a request (with form fields), equivalent to %U
• %p1 Whole original URI of a request (without form fields)
• %p2 URL-decoded path without form fields, equivalent to %f
• %p3 URL-decoded path with form fields
• %{name}i Name of a request header field, for example %{user-agent}i
• %{name}o Name of a response header field, for example %{server}o
• %{cookie}c Output of a request cookie
• %{cookie}C Output of a response cookie
• %{formfield}F Name of a request form field, for example, %{sap-client{F
• %T Duration of a request in seconds
• %L The duration of a request in milliseconds
• %j log: HTTP or HTTPS
• %h Name of the remote host (the client, such as the browser)
• %h0 Same as %h
• %h1 If the header field x-forwarded-for is set, this is the value of the header field, otherwise it is the name of the host directly in front of the ICM (or the Web dispatcher), that is, the client, for example, the browser.
• %H Name of the local host
• %V Fully-qualified host name (FQHN) of the server (value of parameter icm/host_name_full or FQHN of the operating system).
• %v Name of the virtual host (IP address or name of the server with which the client is linked)
• %a IP address of the remote host
• %S Local port name or service
• %l Specifies the remote log name. This name is the result of an IDENT query to the client. This only works if the identity check is activated there.
• %u User name of 401 authentication
• %t Time specification in CLF format: [15/Dec/2000:16:18:35 +0100]
FILTER
Filters mean that an HTTP request is logged only when a certain header field is in the request.
If you set FILTER=SAPSMD, an HTTP request is only logged if it contains the HTTP header field X-CorrelationId.
MAXSIZEKB
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.
SWITCHTF
A new log file can be created not only if the file reaches a certain size, but also when the time data changes. Following values are possible: hour, day, month. After this period of time, a new log file is created.
FILEWRAP
If FILEWRAP=on is active, every time a new file is opened (due to time or size limits being exceeded), the existing log file is reset and overwritten. Therefore, there is always only one log file with the current log data.
Application Area
Internet Communication Manager
Parameter Unit
Character string
Who is permitted to make changes?
Customer
Operating System Restrictions
None
Database System Restrictions
None
Are other parameters affected or dependent?
This parameter applies if the ICM is in the server role. If you want to record requests from the ICM as a client, use parameter icm/HTTP/logging_client.
Values allowed
See description
