Skip to content

Detect a blocked main thread from the watchdog - #220

Merged
pavog merged 2 commits into
masterfrom
bukkit-server-watchdog
Nov 17, 2026
Merged

pavog merged 2 commits into
masterfrom
bukkit-server-watchdog

Conversation

@pavog

@pavog pavog commented Nov 17, 2026

Copy link
Copy Markdown
Member
[17:27:17 ERROR]: The server has not responded for 10 seconds! Creating thread dump
[16:23:43 ERROR]: The server has stopped responding! This is (probably) not a Paper bug.
[16:23:43 ERROR]: Server thread dump (Look for plugins here before reporting to Paper!):
[16:23:43 ERROR]: 	watchdog.jar//com.repro.WatchdogPlugin.lambda$onEnable$0(WatchdogPlugin.java:14)

When the main thread of the server hangs, the watchdog logs a thread dump.
Paper logs an early warning every few seconds while the server is still waiting, and after timeout-time in spigot.yml the watchdog stops the server.
This was not detected before.

This PR adds WatchdogProblem to the BukkitAnalyser, because the watchdog is part of Spigot.
The early warning and the stop have the same cause, so they are one problem without variants: a log with both shows one message with a counter instead of two messages with the same solution.

The new WatchdogThreadDumpSolution tells the user to look for the plugin in the thread dump of the Server thread.
The thread dump names the class of the plugin, but it is intentionally not used for the class-based plugin solutions: every line of the dump is its own log entry with a prefix, so a pattern cannot reach it from the message.

Changes

  • add WatchdogProblem
  • add WatchdogThreadDumpSolution
  • add translations for the problem and the solution
  • add paper-watchdog-not-responding-26-3.log and paper-watchdog-stopped-26-3.log

@pavog
pavog merged commit 9b7a374 into master Nov 17, 2026
3 checks passed
@pavog
pavog deleted the bukkit-server-watchdog branch November 17, 2026 13:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant