MONITORING


Setting up Domino Web server logging to text files
To set up logging the IBM® Lotus® Domino® Web server to text files, you must enable logging (by default, logging is disabled). By default, Domino stores log files in the data directory. While the Web server is running, it creates new log files depending on the log file duration settings. If the Web server is not running, it creates log files as needed when the Web server is started.

Some information may increase the size of the log file without providing meaningful information -- requests for graphics or icons, for example, so you may want to exclude that type of information from the log.

To enable logging to text files

1. From the Domino Administrator, click the Configuration tab.

2. Open the Server document for the Web server.

3. Click the Internet Protocols - HTTP tab.

4. Under "Enable Logging To," choose Enabled the Log Files field.

5. Under "Log File Settings," complete these fields:
FieldEnter
Access log formatChoose one:
  • Common -- To log information in three separate log files
  • Extended Common -- To log information in one file
Note Although you have the option of logging to three separate files, most third-party log-analysis tools require a single text file.
Time formatChoose one to record the time of requests:
  • LocalTime (default) -- To use the time zone currently set on the server
  • GMT-- To use Greenwich Mean Time
Log file durationChoose one to determine how often a new log file is created:

Note The prefixes used in the file names are chosen in the Log File Names section of the Server document.

  • Daily (default) -- To create a new log file each day, starting at midnight. Daily log files use the file naming convention:
file name prefixDDMMYYYY.log

Example: The access log file for May 29, 2001 is access-log29051998.log

  • Weekly -- To create a new log file each week, starting on Sunday at midnight. Weekly log files use the file naming convention:
file name prefix__WWYYYY.log

Example: The access log for the week of May 24, 2001 is access-log__212001.log.

  • Monthly -- To create a new log file each month, starting at midnight on the first day of the month. Monthly log files use the file naming convention:
file name prefix--MMYYYY.log

Example: The access log file for May 2001 is access-log--052001.log.

  • Never -- To create log files of unlimited duration. The file naming convention is:
file name prefix.log

Example: The CGI error log file is cgi-error-log.log.

Maximum log entry lengthThe maximum length allowed for an individual entry in the access log file. If the entry exceeds this length it is not written to the file. The default is 10 kilobytes.
Maximum size of access logThe maximum size allowed for the access log file. If this limit is reached no more entries are written to the file. A value of zero (the default) indicates that the size is unlimited.
6. Under "Log File Names," complete these fields:
FieldEnter
Directory for log filesThe directory to store the log files; if this field is blank, Domino stores the log files in the data directory
Access logThe prefix to use when creating the Access log file. The default is access. Do not enter a file extension.
Agent logThe prefix to use when creating the Agent log file. The default is agent.

Note If you chose the Extended Common format, you will not have an agent log; this information will be included in the access log.

Referer logThe prefix to use when creating the Referer log file. The default is referer.

Note If you chose the Extended Common format, you will not have a referer log; this information will be included in the access log.

CGI error logThe prefix to use for the cgi error log. The default is cgi-error.

Note The cgi-error log is created only if the CGI script logs information to stderr. The format of cgi-error log information is CGI script dependent. The Access log format does not affect the cgi-error log in any way.

7. (Optional) Under "Exclude From Logging," complete these fields to exclude certain types of information from the log file:
FieldAction
URLsEnter URL paths to exclude -- for example, *.gif or /anydir/*
MethodsEnter HTTP methods -- for example, POST or DELETE
MIME typesEnter MIME types to exclude -- for example, image (for all images) or image/gif (for .gif images)
User agentsEnter strings that are part of user agent (browser) strings to exclude requests from a particular user agent.
  • To exclude Microsoft Internet Explorer, enter MSIE*
Return codesEnter HTTP response status codes to exclude -- for example, 300 or 400
Hosts and domainsEnter browser client DNS names or IP addresses to exclude -- for example, 130.333.* or *.edu

Note To enter DNS names, you must first enable the DNS Lookup setting in the HTTP Server section of the Server document. Otherwise, you can enter only IP addresses. Enabling this setting impacts performance.

8. Save the document.

Related topics