logviewer.ini [RotationSettings] #

The block [RotationSettings] of settings/logviewer.ini, with 4 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).

MaxSize #

The limits of each log for rotation, pruning and compression on demand (./console exp:logs --rotate, --prune,
--compress; the log viewer's actions) and by the cronjob part "logs" (php runcronjobs.php logs; in no default part).
Guide: doc/eng-us/features/6.0/log-rotation.md. A log without an entry here takes site.ini [FileSettings]:
MaxSize[<key>] bytes; the cronjob part rotates a log bigger than this (LogFileMaxSize, 2097152)
Keep[<key>] archives kept, .1 .. .N (LogFileRotateCount, 3)
Compress[<key>] enabled | disabled: archives from .2 on compressed to .gz (LogFileCompress, disabled)
MaxAgeDays[<key>] a prune removes archives older than this; 0: no age limit (LogFileMaxAge, 0)
The key is the log's key in the viewer's permalinks: error, debug, storage, site-storage ... e.g.
Keep[debug]=1
MaxSize[debug]=10485760
The request logs (doc/eng-us/features/6.0/request-logs.md) keep more and older archives than the kernel default. The writer
of 404.log and security.log still rotates at site.ini [FileSettings] LogFileMaxSize while it writes.
The size-triggered rotation of eZDebug and eZLog while a log is written uses the site.ini values only.

Default: a hash of 3: 404=10485760, security=10485760, csp=10485760.

<?php /* #?ini charset="utf-8"?
# settings/override/logviewer.ini.append.php
[RotationSettings]
# an empty "MaxSize[]" first replaces the shipped list; without it the items are added
MaxSize[]
MaxSize[404]=10485760
MaxSize[security]=10485760
MaxSize[csp]=10485760
*/ ?>

Keep #

Default: a hash of 3: 404=5, security=5, csp=5.

<?php /* #?ini charset="utf-8"?
# settings/override/logviewer.ini.append.php
[RotationSettings]
# an empty "Keep[]" first replaces the shipped list; without it the items are added
Keep[]
Keep[404]=5
Keep[security]=5
Keep[csp]=5
*/ ?>

Compress #

Default: a hash of 3: 404=enabled, security=enabled, csp=enabled.

<?php /* #?ini charset="utf-8"?
# settings/override/logviewer.ini.append.php
[RotationSettings]
# an empty "Compress[]" first replaces the shipped list; without it the items are added
Compress[]
Compress[404]=enabled
Compress[security]=enabled
Compress[csp]=enabled
*/ ?>

MaxAgeDays #

Default: a hash of 3: 404=30, security=90, csp=30.

<?php /* #?ini charset="utf-8"?
# settings/override/logviewer.ini.append.php
[RotationSettings]
# an empty "MaxAgeDays[]" first replaces the shipped list; without it the items are added
MaxAgeDays[]
MaxAgeDays[404]=30
MaxAgeDays[security]=90
MaxAgeDays[csp]=30
*/ ?>

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.