Start/notes.ini Parameters/NOTES_DEBUG_QUEUES

NOTES_DEBUG_QUEUES

🛠️
Parameter: NOTES_DEBUG_QUEUES
Short description: Enables debug output for internal Domino queues and thread pools – ideal for performance / hang analyses.

Profile

Parameter
NOTES_DEBUG_QUEUES
Category
Logging / Debug
Component
Server
Available since
9.0.1
Supported versions
9.0.1, 10.0, 11.0, 12.0, 14.0, 14.5, 14.5.1
GUI equivalent
notes.ini only (no GUI)
Possible values
0 = off (default), 1 = queue debug active

Description

Many Domino tasks work with internal queues and thread pools (e.g. HTTP workers, router, replicator, index tasks). When tasks hang, slow down, or threads are unevenly distributed, NOTES_DEBUG_QUEUES=1 helps: Domino writes detailed information about queue lengths, thread utilization, and wait states to the console / log file or into the NSD snapshot. A classic diagnostic tool for “server feels slow” tickets.

Example configuration

NOTES_DEBUG_QUEUES=1

Notes & pitfalls

  • Console / log volume increases noticeably – enable only temporarily.
  • Takes effect after a server restart or when the relevant task starts.
  • Pairs with the NSD dump, show server, show tasks, and Server.Health statistics.
  • Evaluation requires experience with Domino internals – often used as part of an HCL support case.