Entering content frameProcedure documentation icm/HTTP/logging_<xx> Locate the document in its SAP Library structure

This parameter has the following syntax:

icm/HTTP/logging_<xx> = PREFIX=<URL prefix>, LOGFILE=<log file name> [, LOGFORMAT=<entry format>, MAXSIZE=<max. size of the log file>, SWITCHTF=<options for the new trace file>, FILEWRAP=on]

This is explained below.

PREFIX

URL prefix that is called for this HTTP subhandler (for example, "/"). (See also HTTP Plugin.)

LOGFILE

Name of the output file in the file system. So that you can assign the files meaningful names, use the following options when entering the log file:

%d

Day of the month (1-31)

%m

Month (1-12)

%y

Year, in the format YYYY

%h

Hour (0-23)

%t

Minute (0-59)

%s

Second (0-59)

%%

"%" character

You can also add a timestamp to the file names making them easier to manage.

Example

When setting parameter icm/HTTP/logging_<xx>, if you want to assign the date and time to the file names, you can set the names as follows:

LOGFILE=access_log-%d-%m-%y_%h:%t:%s

This results in a log file with the name: access_log-15-12-2000_16:51:53

LOGFORMAT

The standard log file format is the common log file format (CLF) and has the form:

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

If you want to use another format, this can be configured using the format string.

There are the following placeholders:

%b

Length of the response in bytes

%h

Name of the remote host (the client, such as the browser)

%H

Name of local host

%S

Local port name or service

%a

IP address of the remote host

%l

Specifies the Remote Logname. 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]

%T

Duration of a request in seconds

%L

The duration of a request in milliseconds

%r

1. Row of an HTTP request: such as GET /bc/ping HTTP/1.0

%f

Name of requested object without form fields

%U

Whole URI of a request (with form fields)

%s

OK code of the response

%v

Name of the virtual host (IP address or name of the server with which the client is linked)

%V

Fully-qualified host name (FQHN) of the server (value of parameter icm/host_name_full or FQHN of the operating system).

%{name}i

Name of a request header field, e.g. %{user-agent}i

%{name}o

Name of a response header field, e.g. %{server}o

%{cookie}c

Output of a request cookie

%{cookie}c

Output of a response cookie

Example

The following string creates the CLF format: %h %l %u %t "r" %s %b.

MAXSIZE

MAXSIZE 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.

The new file name is unique (this is achieved by specifying time and date fields, see above), or else is made unique by adding "_xx" to the end (where xx is a number increasing from 0).

Note

If FILEWRAP=on was selected, no new file is opened (see below).

SWITCHF

A new log file can not only be created if the file has reached a certain size, but also when the time data changes:

hour

A new log file is opened every hour

day

A new log file is opened every day

month

A new log file is opened every month

FILEWRAP

If FILEWRAP=on is active, every time a new file is opened, the existing log file is reset and overwritten. Therefore, there is always only one log file with the current log data.

Example

PREFIX=/, LOGFILE=dev_http_access_log, SWITCHTF=day, FILEWRAP=on

 

 

 Leaving content frame