audit.ini [AuditRotationSettings] #

The block [AuditRotationSettings] of settings/audit.ini, with 7 setting(s).

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

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

LiveDays #

Q8: by day and by size, compressed archives, retention per channel; run by the audit
cronjob part ([CronjobPart-audit] in cronjob.ini), from the console and by exp:audit.
Defaults for the [AuditChannel_*] blocks:

Default: 90.

<?php /* #?ini charset="utf-8"?
# settings/override/audit.ini.append.php
[AuditRotationSettings]
LiveDays=90
*/ ?>

ArchiveDays #

Default: 730.

<?php /* #?ini charset="utf-8"?
# settings/override/audit.ini.append.php
[AuditRotationSettings]
ArchiveDays=730
*/ ?>

MaxFileSize #

Default: 64M.

<?php /* #?ini charset="utf-8"?
# settings/override/audit.ini.append.php
[AuditRotationSettings]
MaxFileSize=64M
*/ ?>

ArchiveFormat #

Default: gzip.

<?php /* #?ini charset="utf-8"?
# settings/override/audit.ini.append.php
[AuditRotationSettings]
ArchiveFormat=gzip
*/ ?>

VerifyBeforeArchive #

Verify a file's chain before it is archived; a broken file is archived all the same
(removing evidence is worse) but its manifest says broken and system.audit.chain.broken
is written. enabled | disabled

Default: enabled.

<?php /* #?ini charset="utf-8"?
# settings/override/audit.ini.append.php
[AuditRotationSettings]
VerifyBeforeArchive=enabled
*/ ?>

VerifyAfterArchive #

Read every archive back and compare its sha256 before the live file is removed.

Default: enabled.

<?php /* #?ini charset="utf-8"?
# settings/override/audit.ini.append.php
[AuditRotationSettings]
VerifyAfterArchive=enabled
*/ ?>

RotateAfter #

The daily tasks (rotation of the previous day, archiving, retention, checkpoint) run on
the first cronjob run after this time of day (HH:MM, the site's time zone).

Default: 00:15.

<?php /* #?ini charset="utf-8"?
# settings/override/audit.ini.append.php
[AuditRotationSettings]
RotateAfter=00:15
*/ ?>

Related #

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

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