Start/notes.ini Parameters/HTTPLog_QueueDepth

HTTPLog_QueueDepth

🛠️
Parameter: HTTPLog_QueueDepth
Short description: Size of the internal queue in which HTTP logging entries are buffered before being written to disk.

Profile

Parameter
HTTPLog_QueueDepth
Category
HTTP / Web
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
Integer (typical 512 – 4096; default internally ≈ 1024)

Description

To avoid blocking the HTTP request path with disk I/O, Domino first writes HTTP access/debug log entries to an internal queue; a separate writer thread persists them to domlog.nsf or the file system. HTTPLog_QueueDepth defines how many pending entries may be buffered at most before new requests have to wait on logging itself or entries are dropped. On heavily loaded servers, a queue that is too small is a common cause of seemingly “sluggish” HTTP.

Example configuration

HTTPLog_QueueDepth=2048

Notes & pitfalls

  • Values that are too small lead to blocked worker threads or dropped log entries during load spikes.
  • Values that are too large increase memory consumption and can magnify data loss in a crash (entries are not yet on disk).
  • Takes effect after an HTTP restart (tell http restart).
  • Complements HTTPLogAccessOption and the chosen log target configuration (domlog.nsf vs. text log).