logviewer.ini [DigestSettings] #

The block [DigestSettings] of settings/logviewer.ini, with 6 setting(s).

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

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

Hours #

The error digest (Setup > Log files > Error digest, setup/logsdigest): the distinct messages of the last Hours
hours of each kernel log (or of one log), normalized (numbers, ids, hexadecimal values, quoted values and paths set
aside) and counted, most frequent first. Always masked. Known messages are hidden per user (the preference
admin_logviewer_known). The hours of the window when the page names none (1 to 168).

Default: 24.

<?php /* #?ini charset="utf-8"?
# settings/override/logviewer.ini.append.php
[DigestSettings]
Hours=24
*/ ?>

MaxMessages #

The most messages listed per log.

Default: 50.

<?php /* #?ini charset="utf-8"?
# settings/override/logviewer.ini.append.php
[DigestSettings]
MaxMessages=50
*/ ?>

MaxBytesPerFile #

The most bytes read per log from the start of the window (the start is found by a binary search on the times).

Default: 8388608.

<?php /* #?ini charset="utf-8"?
# settings/override/logviewer.ini.append.php
[DigestSettings]
MaxBytesPerFile=8388608
*/ ?>

Levels #

The levels listed.

Default: a list of 2: error, warning.

<?php /* #?ini charset="utf-8"?
# settings/override/logviewer.ini.append.php
[DigestSettings]
# an empty "Levels[]" first replaces the shipped list; without it the items are added
Levels[]
Levels[]=error
Levels[]=warning
*/ ?>

LogLevels #

The levels listed for one log, by its key, instead of Levels[]: a comma list. The not found requests (404.log) are
notices, so the digest lists them only through this.

Default: a hash of 1: 404=error,warning,notice.

<?php /* #?ini charset="utf-8"?
# settings/override/logviewer.ini.append.php
[DigestSettings]
# an empty "LogLevels[]" first replaces the shipped list; without it the items are added
LogLevels[]
LogLevels[404]=error,warning,notice
*/ ?>

GroupBy #

How the entries of a log are grouped, by its key:
message the normalized message (the default)
category-rule the first word of the line, <category>/<rule> (security.log: probe/wp-login, injection/sql ...)
reason the reason= field, with ids and paths set aside (404.log: module:foo, view:content/view, node:# ...)
reason-kind only the kind of the reason= field (module, view, disabled, node, object, rule, kernel)
uri the method and the path, without the query, numbers set aside (GET /blog/#)
directive-blocked the directive and the origin of what it blocked (csp.log: csp/script-src blocked=inline,
csp/img-src blocked=https://maps.example.com); the path of a blocked URI set aside
An entry that has no such field is grouped by its message.

Default: a hash of 3: 404=reason, security=category-rule, csp=directive-blocked.

<?php /* #?ini charset="utf-8"?
# settings/override/logviewer.ini.append.php
[DigestSettings]
# an empty "GroupBy[]" first replaces the shipped list; without it the items are added
GroupBy[]
GroupBy[404]=reason
GroupBy[security]=category-rule
GroupBy[csp]=directive-blocked
*/ ?>

Related #

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

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