Start/notes.ini Parameters/Debug_Threadpool

Debug_Threadpool

🛠️
Parameter: Debug_Threadpool
Short description: Enables debug output for the shared thread pool (event pool, scheduler, agent manager, etc.).

Profile

Parameter
Debug_Threadpool
Category
Logging / Debug
Component
Server
Available since
10.0
Supported versions
10.0, 11.0, 12.0, 14.0, 14.5, 14.5.1
GUI equivalent
notes.ini only (no GUI)
Possible values
0 = off, 1 = basic info, 2 = verbose (stacks per thread)

Description

Many subsystems – scheduler, event handling, agent manager, JIT tasks – share a common thread pool. For performance problems (hanging tasks, timeout spikes), Debug_Threadpool=2 helps to see which threads are occupied, how many are waiting, and which tasks are currently running.

Example configuration

Debug_Threadpool=2

Notes & pitfalls

  • Level 2 produces a lot of output – enable only temporarily and rotate via Debug_Outfile.
  • Complements DEBUG_AMGR, DEBUG_EVENTS, and Show stat threadpool.
  • Helps with sizing Server_Pool_Tasks and Server_Max_Concurrent_Trans.
  • For live diagnosis, show server -t is useful in parallel.
  • The change takes effect immediately after a set config reload.