-
Notifications
You must be signed in to change notification settings - Fork 609
Open
Description
@claude - Let's update the Mattermost Product Documentation to note new debug log messages for cluster job execution from Mattermost server v11.4.0 onward captured via Engineering PR #34701 (evidence: milestone.title from PR metadata).
Scope & constraints:
- In scope: Add debug log message references to existing cluster/logging documentation
- Out of scope (non-editable): Changelogs, important upgrade notes, version archive
- Bounded to: Three job types (scheduled posts, DND status reset, post reminders) and their debug messages
Required doc touchpoints:
Identify existing documentation for:
- Server logging reference (if log messages are documented)
- High availability / cluster troubleshooting guides
- Scheduled jobs / task execution documentation
Task (System Admin):
Document the new debug log messages that explain cluster leader job execution:
New debug messages added in v11.4.0:
- "Skipping scheduled posts job startup since this is not the leader node"
- "Skipping unset DND status job startup since this is not the leader node"
- "Skipping post reminder job startup since this is not the leader node"
- "This is no longer leader node. Cancelling the [job name] task"
Context to include:
- These are DEBUG-level messages (only visible when debug logging enabled)
- Appear in cluster deployments when non-leader nodes skip job execution
- Normal/expected behavior - indicates leader election working correctly
- Helpful for troubleshooting: if admin wonders why jobs aren't running on a specific node, these messages confirm it's not the leader
Output requirements:
- List of documentation pages updated
- Before/after showing where debug messages are referenced
- Confirmation that cluster troubleshooting context is included (these messages indicate correct behavior, not errors)
Evidence used:
- PR metadata: milestone.title = "v11.4.0"
- Code diff: 5 debug statements added across three job initialization functions
- Release note: "Added debug log to indicate the scheduled post job, DND status reset job, or the post reminder job is not running as the current node not being a leader node"
- Jobs affected: scheduled posts, DND status expiry, post reminders
Metadata
Metadata
Assignees
Labels
No labels