v11.3: Validate log levels in AdvancedLoggingJSON #8652
Description
@claude - Let’s update the Mattermost Product Documentation to reflect the System Admin AdvancedLoggingJSON configuration and audit logging settings product experience from Mattermost server vv11.3 onward captured via mattermost/mattermost#34414
Scope & constraints (include non-editable docs list):
Scope: document AdvancedLoggingJSON validation rules for standard vs audit logging and the admin console label change for Audit Logging; focus on config and admin UI behavior only.
Constraints: DO NOT modify changelogs, important upgrade notes, version archive, removed/deprecated features, or unsupported legacy releases.
Required doc touchpoints:
Identify likely pages for server logging configuration, AdvancedLoggingJSON examples, and audit logging settings (admin console and config.json).
Update any admin console settings labels or screenshots/text referring to “Audit logging (Beta)” where applicable.
Persona-separated tasks (System Admin only):
Explain that AdvancedLoggingJSON validation now enforces valid log level IDs and rejects audit levels in standard logging, and standard levels in audit logging; include “what changed/why/how to fix” guidance and common error symptoms (validation errors for invalid level IDs).
Clarify that audit logging uses audit-specific levels only (audit-api, audit-content, audit-permissions, audit-cli) and that standard logging rejects these levels, based on new validation behavior.
Note the admin console label change from “Audit logging (Beta)” to “Audit Logging” while beta status remains (isBeta flag), and update any UI references accordingly.
Output requirements:
Provide a list of pages/sections to update.
Provide proposed doc text snippets (before/after or insert-ready).
If PR review not possible: milestone not found in PR evidence (summary.json); a human must validate milestone/version if needed.
Activity
claude commentedon Jan 19, 2026
Claude finished @cwarnermm's task —— View job •
claude/issue-8652-20260119-1755• Create PR ➔Mattermost v11.3 AdvancedLoggingJSON Documentation Updates Complete
I've successfully updated the Mattermost Product Documentation to reflect the System Admin AdvancedLoggingJSON configuration and audit logging settings changes from v11.3.
Todo List:
Changes Made
1. Enhanced Validation Documentation (
source/administration-guide/manage/logging.rst):2. Admin Console Label Updates:
3. Error Handling Guidance:
Key Documentation Updates
Validation Rules:
audit-api,audit-content,audit-permissions,audit-cli)debug,info,warn,error, etc.)Common Error Messages:
Invalid log level 'audit-api' for standard logging targetInvalid log level 'info' for audit logging targetUnknown log level IDFiles Updated:
source/administration-guide/manage/logging.rst(primary logging documentation)source/administration-guide/configure/experimental-configuration-settings.rst(experimental audit settings)esethna commentedon Sep 14, 2026
Bulk closing issues as our docs have migrated to the /mattermost repository. Please considering opening your issue or PR there if it is still valid.