Skip to content

Remove unused audit log file rotation settings from docs#8771

Open
Combs7th wants to merge 1 commit intomasterfrom
claude/issue-8769-20260304-2307
Open

Remove unused audit log file rotation settings from docs#8771
Combs7th wants to merge 1 commit intomasterfrom
claude/issue-8769-20260304-2307

Conversation

@Combs7th
Copy link
Contributor

@Combs7th Combs7th commented Mar 5, 2026

Remove four unused audit log file rotation settings from documentation to reflect Mattermost server v11.4+ behavior.

Engineering PR mattermost/mattermost#35170 removes these settings from ExperimentalAuditSettings:

  • FileMaxSizeMB
  • FileMaxAgeDays
  • FileMaxBackups
  • FileCompress

File rotation for audit logs is now configured via AdvancedLoggingJSON.

Closes #8769

Generated with Claude Code

From Mattermost server v11.4, the following ExperimentalAuditSettings
file rotation settings were removed as unused (mattermost/mattermost#35170):
- FileMaxSizeMB
- FileMaxAgeDays
- FileMaxBackups
- FileCompress

File rotation for audit logs is now configured via AdvancedLoggingJSON.

Updated files:
- environment-configuration-settings.rst: Remove 4 rotation setting sections
- experimental-configuration-settings.rst: Remove 4 rotation setting sections;
  update description to direct admins to AdvancedLoggingJSON for file rotation
- logging.rst: Remove rotation settings from Cloud defaults list
- telemetry.rst: Remove rotation settings from telemetry data list

Co-authored-by: Combs7th <Combs7th@users.noreply.github.com>
@Combs7th Combs7th requested a review from hanzei March 5, 2026 00:37
@Combs7th Combs7th changed the base branch from master to v11.5-documentation March 5, 2026 00:37
@Combs7th Combs7th added 1: Dev Review Requires review by a core commiter 2: Editor Review Requires review by an editor Guidance labels Mar 5, 2026
@Combs7th Combs7th added this to the v11.5.0 milestone Mar 5, 2026
@Combs7th
Copy link
Contributor Author

Combs7th commented Mar 5, 2026

@hanzei - Tagging you for dev review. Do the changes above look accurate? If so, I'll tag Eric for editor review.

@github-actions
Copy link
Contributor

github-actions bot commented Mar 5, 2026

Newest code from mattermost has been published to preview environment for Git SHA f141ce0

@amyblais
Copy link
Member

amyblais commented Mar 5, 2026

@Combs7th This is also scheduled for v11.6 (April release).

@Combs7th Combs7th modified the milestones: v11.5.0, v11.6.0 Mar 5, 2026
@Combs7th Combs7th changed the base branch from v11.5-documentation to master March 5, 2026 07:19
@amyblais amyblais added the Do Not Merge Should not be merged until this label is removed label Mar 5, 2026
Copy link
Contributor

@hanzei hanzei left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks!

:start-after: :nosearch:

When audit logging is enabled in a self-hosted instance, you can specify size, backup interval, compression, maximium age to manage file rotation, and timestamps for audit logging, as defined below. You can specify these settings independently for audit events and AD/LDAP events.
When audit logging is enabled in a self-hosted instance, you can specify a file name and queue size for audit logging, as defined below. To configure file rotation for audit logs, use the :ref:`AdvancedLoggingJSON <administration-guide/configure/environment-configuration-settings:output audit logs to multiple targets>` setting. You can specify these settings independently for audit events and AD/LDAP events.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Are you sure that you can set the queue side without advanced logging?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We don't do telemetry any longer. Can we just drop the file?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

1: Dev Review Requires review by a core commiter 2: Editor Review Requires review by an editor Do Not Merge Should not be merged until this label is removed Guidance

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Remove unused audit log file rotation settings

3 participants