Skip to content

v11.4 Docs: Added debug log to indicate the job is not running as the node is not a leader node #8706

@Combs7th

Description

@Combs7th

@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

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions