Not clear whether there's a notifications target for advanced logging based on docs

[cwarnermm]

context: https://hub.mattermost.com/private-core/pl/drb6tnnyrjfg5cgi1dpa7qwh9o

Customer observed a DEBUG level message along the lines of "there is no advanced logging configuration for notifications" and wanted to know more. Logging configuration and logging setup documentation for admins is missing the following notifications target details:

"NotificationLogSettings": {
"EnableConsole": true,
"ConsoleLevel": "DEBUG",
"ConsoleJson": true,
"EnableColor": false,
"EnableFile": true,
"FileLevel": "INFO",
"FileJson": true,
"FileLocation": "",
"AdvancedLoggingJSON": {}
},

There is a note in the logging configuration settings docs confirming that admins "can manage additional logging configuration within the config.json file specifically for Mattermost notifications under NotificationLogSettings. These settings are equivalent to the configuration settings available under LogSettings." which isn't sufficient for admins looking to understand the debug errors they're seeing while preparing for a production upgrade compared to their their dev staging environment.

@claude - Let's add logging configuration documentation for the notifications target based on the config.json settings available listed above.

[claude]

Claude finished @cwarnermm's task —— View job • claude/issue-8075-20250618_172013 • Create PR ➔

---

Added NotificationLogSettings Documentation ✅

I've successfully added comprehensive logging configuration documentation for the notifications target based on the NotificationLogSettings configuration structure you provided.

Todo List:

• Read repository guidelines (CLAUDE.md) - No CLAUDE.md found
• Locate existing logging configuration documentation
• Analyze current documentation structure and format
• Add detailed NotificationLogSettings documentation
• Commit changes to branch
• Provide PR creation link

Changes Made:

1. Environment Configuration Settings (source/configure/environment-configuration-settings.rst)

• Added complete "Notification logging" section with comprehensive documentation
• Documented all 9 NotificationLogSettings configuration options:
  • EnableConsole - Enable/disable notification console logging
  • ConsoleLevel - Set console log level (DEBUG/INFO/ERROR)
  • ConsoleJson - Output console logs as JSON or plain text
  • EnableColor - Colorize plain text console logs
  • EnableFile - Enable/disable notification file logging
  • FileLevel - Set file log level (DEBUG/INFO/ERROR)
  • FileJson - Output file logs as JSON or plain text
  • FileLocation - Set location for notification log files
  • AdvancedLoggingJSON - Configure advanced logging targets
• Included environment variables for all settings (MM_NOTIFICATIONLOGSETTINGS_ prefix)
• Added proper RST formatting with config:setting directives, tables, and notes

2. Main Logging Documentation (source/manage/logging.rst)

• Added tip section with cross-reference to NotificationLogSettings documentation
• Explains that NotificationLogSettings operate independently from LogSettings

Key Benefits:

• Resolves customer confusion about "no advanced logging configuration for notifications" debug messages
• Provides clear guidance for admins preparing production upgrades
• Follows same documentation structure as existing LogSettings for consistency
• Includes all configuration details needed for troubleshooting notification logging issues

---