site.ini [RequestLogSettings] #

The block [RequestLogSettings] of settings/site.ini, with 4 setting(s).

Never edit settings/site.ini itself: an update replaces it. Put the settings you change in an override, which wins over the shipped file:

• settings/override/site.ini.append.php for every siteaccess,
• settings/siteaccess/<siteaccess>/site.ini.append.php for one siteaccess,
• extension/<extension>/settings/site.ini.append.php in an extension (read when the extension is active).

NotFoundLog #

A request for a page that does not exist (404, 410) is written as one line
in its own log beside error.log, with the reason the kernel found: an
undefined module or view, a module or view this siteaccess switches off, a
node or object that is not there. A request the request classifier names a
probe or attack is written to security.log instead (requestclassifier.ini),
never to both. Answers 401 and 403 stay notices in notice.log.
enabled (the default): 404s go to NotFoundLogFile and no longer to error.log,
which keeps the real faults. disabled: error.log as before.

Default: enabled.

<?php /* #?ini charset="utf-8"?
# settings/override/site.ini.append.php
[RequestLogSettings]
NotFoundLog=enabled
*/ ?>

NotFoundLogFile #

The file in the log directory (var/log, or the site's log directory with
[FileSettings] UseGlobalLogDir=disabled). Rotated as the other logs are.

Default: 404.log.

<?php /* #?ini charset="utf-8"?
# settings/override/site.ini.append.php
[RequestLogSettings]
NotFoundLogFile=404.log
*/ ?>

MaskIP #

enabled (the default): the address of the client is written with its host
part hidden (203.0.x.x, 2001:db8:x:x), never in full.

Default: enabled.

<?php /* #?ini charset="utf-8"?
# settings/override/site.ini.append.php
[RequestLogSettings]
MaskIP=enabled
*/ ?>

MaxURILength #

The longest address written; a longer one is cut and ends in "...". The
values of the query are always written as ***.

Default: 300.

<?php /* #?ini charset="utf-8"?
# settings/override/site.ini.append.php
[RequestLogSettings]
MaxURILength=300
*/ ?>

Related #

• All blocks of site.ini
• All INI files
• The settings page

Generated by ./console exp:help:examples from settings/site.ini. Do not edit this page: change the source and generate again (how). Free documentation: GFDL 1.3 or later.